VENDAS: 1-800-867-1389

Atualizar operação de registro

Atualizado: setembro de 2012

Atualiza um item existente em uma tabela.

A solicitação pode ser especificada da seguinte maneira. Substitua <service_name> pelo nome do seu serviço móvel, <table_name> pelo nome da tabela para acessar e <item_id> pela ID do item a ser atualizado.

 

Verbo HTTP URI de solicitação Versão HTTP

PATCH

https://<service_name>.azure-mobile.net/tables/<table_name>/<item_id>

HTTP/1.1

Parâmetros URI

 

Parâmetro URI Obrigatório Descrição

noscript

Não

Quando um valor de true for fornecido, a execução de scripts registrados será suprimida. Para suprimir a execução do script, você deverá fornecer a chave mestra de serviço no cabeçalho do X-ZUMO-MASTER.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos da solicitação.

 

Cabeçalho de solicitação Obrigatório  

Accept

Não

Defina este cabeçalho como application/json.

Content-Length

Sim

O comprimento do corpo da solicitação.

Content-Type

Não

Defina este cabeçalho como application/json.

X-ZUMO-APPLICATION

Condicional

A chave do aplicativo do serviço móvel. Você deve especificar uma chave de aplicativo válida quando for necessário para acessar a operação de tabela. Esta é a permissão de acesso padrão da operação de tabela.

X-ZUMO-AUTH

Condicional

O token de autenticação gerado pelo serviço para um usuário autenticado. Você deve especificar um token para um usuário autenticado quando for necessário para acessar a operação de tabela.

X-ZUMO-MASTER

Condicional

A chave mestra de serviço. Você somente deve incluir essa chave quando o acesso de administrador for necessário para acessar a operação de tabela.

securitySegurançaObservação
A chave mestra de serviço é uma credencial de segurança crítica que fornece acesso de administrador ao serviço de dados. Não a compartilhe com ninguém ou distribua-a com o seu aplicativo. Essa chave deve sempre ser distribuída com segurança em um canal criptografado.

Corpo da solicitação

Os valores atualizados codificados no formato JSON (JavaScript Object Notation), junto com o valor de id opcional do objeto.

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Código de status

Uma operação bem-sucedida retorna o código de status 200 (OK).

Cabeçalhos de resposta

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão obedecem à especificação de protocolo HTTP/1.1.

 

Cabeçalho de resposta Descrição

Content-Length

O comprimento do corpo da resposta.

Content-Type

Cabeçalho definido como application/json.

x-zumo-version

Indica qual versão do tempo de execução executou a solicitação.

Corpo da resposta

A representação JSON do item atualizado.

A autorização depende dos requisitos de permissão de acesso para a operação de tabela, que são resumidos da seguinte maneira:

 

Permissão de acesso da operação de tabela Cabeçalho de autorização obrigatório

Todos

Nenhuma

Qualquer pessoa com a chave de aplicativo

X-ZUMO-APPLICATION

Somente Usuários Autenticados

X-ZUMO-AUTH

Somente Scripts e Administradores

X-ZUMO-MASTER

As permissões de acesso para operações de tabela individuais são definidas no Portal de Gerenciamento do Windows Azure. Para obter mais informações, consulte Autorizzazioni.

O URI do exemplo a seguir atualiza um item existente na tabela TodoItem.

PATCH https://todolist.azure-mobile.net/tables/TodoItem/18

A solicitação é enviada com os seguintes cabeçalhos.

Accept: application/json
X-ZUMO-APPLICATION: UzMAOXRlJdZyqibeUqCMoZZMrUXIRs92
Content-Type: application/json
Host: todolist.azure-mobile.net
Content-Length: 56

A solicitação é enviada com o seguinte objeto JSON no corpo.

{"complete":true}

Depois que a solicitação tiver sido enviada, a resposta a seguir será retornada.

HTTP/1.1 200 OK
Content-Type: application/json
x-zumo-version: Zumo.Main.0.1.6.527.Runtime
Date: Thu, 20 Sep 2012 15:49:06 GMT
Content-Length: 56

{"text":"Complete the tutorial","complete":true,"id":18}

Isso foi útil para você?
(1500 caracteres restantes)
Agradecemos os seus comentários
Mostrar:
© 2014 Microsoft