Cabeçalhos
Este artigo fornece links para páginas de referência de cabeçalhos usados com a API REST de Configuração de Aplicativos do Azure.
Cabeçalhos de solicitação
A tabela a seguir descreve os cabeçalhos de solicitação comuns usados na Configuração de Aplicativos do Azure.
| parâmetro | Descrição | Exemplo |
|---|---|---|
| Autorização | Usado para autenticar uma solicitação para o serviço. Confira a seção 14.8 | Authorization: HMAC-SHA256 Credential=<Credential>&SignedHeaders=Host;x-ms-date;x-ms-content-sha256&Signature=<Signature> |
| Aceitar | Informa ao servidor qual tipo de mídia o cliente aceitará em uma resposta HTTP. Confira a seção 14.1 | Accept: application/vnd.microsoft.appconfig.kv+json; |
| Accept-Datetime | Solicita que o servidor retorne seu conteúdo como uma representação de seu estado anterior. O valor desse cabeçalho é o datetime solicitado desse estado. Confira RFC 7089 | Accept-Datetime: Sat, 12 May 2018 02:10:00 GMT |
| Content-Type | Contém o tipo de mídia do conteúdo dentro do corpo da solicitação HTTP. Confira a seção 14.17 | Content-Type: application/vnd.microsoft.appconfig.kv+json; charset=utf-8; |
| Data | O datetime em que a solicitação HTTP foi emitida. Esse cabeçalho é usado na autenticação HMAC. Confira a seção 14.18 | Date: Fri, 11 May 2018 18:48:36 GMT |
| Host | Especifica o locatário para o qual a solicitação foi emitida. Esse cabeçalho é usado na autenticação HMAC. Confira a seção 14.23 | Host: contoso.azconfig.io |
| If-Match | Usado para fazer uma solicitação HTTP condicional. Essa solicitação só deverá ser realizada se a Etag do recurso de destino corresponder ao valor desse cabeçalho. O valor "*" corresponde a qualquer Etag. Confira a seção 14.24 | If-Match: "4f6dd610dd5e4deebc7fbaef685fb903" |
| If-None-Match | Usado para fazer uma solicitação HTTP condicional. Essa solicitação só deverá ser realizada se a Etag do recurso de destino não corresponder ao valor desse cabeçalho. O valor "*" corresponde a qualquer Etag. Confira a seção 14.26 | If-None-Match: "4f6dd610dd5e4deebc7fbaef685fb903" |
| Sync-Token | Usado para habilitar a consistência em tempo real durante uma sequência de solicitações. | Sync-Token: jtqGc1I4=MDoyOA==;sn=28 |
| x-ms-client-request-id | Uma ID exclusiva fornecida pelo cliente, usada para rastrear o percurso de ida e volta de uma solicitação. | x-ms-client-request-id: 00000000-0000-0000-0000-000000000000 |
| x-ms-content-sha256 | Um código hash sha256 do corpo da solicitação HTTP. Esse cabeçalho é usado na autenticação HMAC. | x-ms-content-sha256: 47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU= |
| x-ms-date | Esse cabeçalho pode ser definido e usado no lugar do cabeçalho Date se não for possível acessar o cabeçalho de data. Esse cabeçalho é usado na autenticação HMAC. |
x-ms-date: Fri, 11 May 2018 18:48:36 GMT |
| x-ms-return-client-request-id | Usado em conjunto com o cabeçalho x-ms-client-request-id. Se o valor desse cabeçalho for "true", o servidor será instruído a retornar o valor do cabeçalho da solicitação x-ms-client-request-id. |
x-ms-return-client-request-id: true |
Cabeçalhos de resposta
O servidor pode incluir os seguintes cabeçalhos HTTP em suas respostas.
| parâmetro | Descrição | Exemplo |
|---|---|---|
| Content-Type | Contém o tipo de mídia do conteúdo dentro do corpo da resposta HTTP. Confira a seção 14.17 | Content-Type: application/vnd.microsoft.appconfig.kv+json; charset=utf-8; |
| Etag | Um token opaco que representa o estado de um determinado recurso. Pode ser usado em operações condicionais. Confira a seção 14.19 | ETag: "4f6dd610dd5e4deebc7fbaef685fb903" |
| Last-Modified | Descreve quando o recurso solicitado foi modificado pela última vez. Formatado como HTTP-Date. Confira a seção 14.29 | Last-Modified: Tue, 05 Dec 2017 02:41:26 GMT |
| Link | Fornece links para recursos relacionados à resposta. Esse cabeçalho é usado para paginação usando o link avançar. Confira RFC 5988 | Link: </kv?after={token}>; rel="next" |
| Memento-Datetime | Indica que o conteúdo contido em uma resposta representa um estado anterior. O valor desse cabeçalho é o datetime desse estado. Confira RFC 7089 | Memento-Datetime: Sat, 12 May 2018 02:10:00 GMT |
| retry-after-ms | Fornece um período sugerido (em milissegundos) para que o cliente aguarde antes de tentar novamente uma solicitação que falhou. | retry-after-ms: 10 |
| x-ms-request-id | Uma ID exclusiva gerada pelo servidor que é usada para rastrear a solicitação no serviço. | x-ms-request-id: 00000000-0000-0000-0000-000000000000 |
| WWW-Authenticate | Usado para desafiar clientes para autenticação e fornecer um motivo para o motivo da falha de uma tentativa de autenticação. Confira a seção 14.47 | WWW-Authenticate: HMAC-SHA256 error="invalid_token" error_description="Invalid Signature" |