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"