Partilhar via

Cabeçalhos

  • Artigo

Este artigo fornece ligações para páginas de referência para cabeçalhos utilizados com a API REST Azure App Configuration.

Cabeçalhos do Pedido

A tabela seguinte descreve os cabeçalhos de pedido comuns utilizados no Azure App Configuration.

Cabeçalho Descrição Exemplo
Autorização Utilizado para autenticar um pedido para o serviço. Consulte a secção 14.8 Authorization: HMAC-SHA256 Credential=<Credential>&SignedHeaders=Host;x-ms-date;x-ms-content-sha256&Signature=<Signature>
Aceitação Informa o servidor sobre o tipo de suporte de dados que o cliente irá aceitar numa resposta HTTP. Consulte a secção 14.1 Accept: application/vnd.microsoft.appconfig.kv+json;
Accept-Datetime Pede ao servidor que devolva o respetivo conteúdo como representação do estado anterior. O valor deste cabeçalho é o datetime pedido desse estado. Ver RFC 7089 Accept-Datetime: Sat, 12 May 2018 02:10:00 GMT
Tipo de Conteúdo Contém o tipo de suporte de dados do conteúdo no corpo do pedido HTTP. Consulte a secção 14.17 Content-Type: application/vnd.microsoft.appconfig.kv+json; charset=utf-8;
Data O datetime em que o pedido HTTP foi emitido. Este cabeçalho é utilizado na autenticação HMAC. Consulte a secção 14.18 Date: Fri, 11 May 2018 18:48:36 GMT
Anfitrião Especifica o inquilino para o qual o pedido foi emitido. Este cabeçalho é utilizado na autenticação HMAC. Consulte a secção 14.23 Host: contoso.azconfig.io
If-Match Utilizado para tornar um pedido HTTP condicional. Este pedido só deverá ser bem-sucedido se o ETag do recurso de destino corresponder ao valor deste cabeçalho. O valor '*' corresponde a qualquer ETag. Consulte a secção 14.24 If-Match: "4f6dd610dd5e4deebc7fbaef685fb903"
If-None-Match Utilizado para tornar um pedido HTTP condicional. Este pedido só deverá ser bem-sucedido se o ETag do recurso de destino não corresponder ao valor deste cabeçalho. O valor '*' corresponde a qualquer ETag. Consulte a secção 14.26 If-None-Match: "4f6dd610dd5e4deebc7fbaef685fb903"
Sync-Token Utilizado para ativar a consistência em tempo real durante uma sequência de pedidos. Sync-Token: jtqGc1I4=MDoyOA==;sn=28
x-ms-client-request-id Um ID exclusivo fornecido pelo cliente utilizado para controlar o percurso de ida e volta de um pedido. x-ms-client-request-id: 00000000-0000-0000-0000-000000000000
x-ms-content-sha256 Um resumo sha256 do corpo do pedido HTTP. Este cabeçalho é utilizado na autenticação HMAC. x-ms-content-sha256: 47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=
x-ms-date Este cabeçalho pode ser definido e utilizado no lugar do Date cabeçalho se não for possível aceder ao cabeçalho de data. Este cabeçalho é utilizado na autenticação HMAC. x-ms-date: Fri, 11 May 2018 18:48:36 GMT
x-ms-return-client-request-id Utilizado em conjunto com o x-ms-client-request-id cabeçalho. Se o valor deste cabeçalho for "verdadeiro", será instruído ao servidor para devolver o valor do cabeçalho do x-ms-client-request-id pedido. x-ms-return-client-request-id: true

Cabeçalhos de Resposta

O servidor pode incluir os seguintes cabeçalhos HTTP nas respetivas respostas.

Cabeçalho Descrição Exemplo
Tipo de Conteúdo Contém o tipo de suporte de dados do conteúdo no corpo de resposta HTTP. Consulte a secçã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 utilizado em operações condicionais. Consulte a secção 14.19 ETag: "4f6dd610dd5e4deebc7fbaef685fb903"
Última Modificação Descreve quando o recurso pedido foi modificado pela última vez. Formatado como HTTP-Date. Consulte a secção 14.29 Last-Modified: Tue, 05 Dec 2017 02:41:26 GMT
Ligação Fornece ligações para recursos relacionados com a resposta. Este cabeçalho é utilizado para paginação com a ligação seguinte . Ver RFC 5988 Link: </kv?after={token}>; rel="next"
Memento-Datetime Indica que o conteúdo contido numa resposta representa um estado anterior. O valor deste cabeçalho é o datetime desse estado. Ver 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 repetir um pedido falhado. retry-after-ms: 10
x-ms-request-id Um ID exclusivo gerado pelo servidor que é utilizado para controlar o pedido no serviço. x-ms-request-id: 00000000-0000-0000-0000-000000000000
WWW-Authenticate Utilizado para desafiar clientes para autenticação e fornecer uma razão para uma tentativa de autenticação ter falhado. Consulte a secção 14.47 WWW-Authenticate: HMAC-SHA256 error="invalid_token" error_description="Invalid Signature"