Partilhar via


Cabeçalhos de resposta REST comuns do Azure Cosmos DB

Os seguintes cabeçalhos de resposta são comuns a todas as respostas da API SQL:

Cabeçalho Description
Tipo de Conteúdo O Tipo de Conteúdo é aplicação/json. A API SQL devolve sempre o corpo de resposta no formato JSON padrão.
Data A hora da data da operação de resposta. Este formato de data/hora está em conformidade com o formato de data/hora RFC 1123 expresso na Hora Universal Coordenada.
etag O cabeçalho do etag mostra o etag de recursos para o recurso obtido. O etag tem o mesmo valor que a propriedade _etag no corpo da resposta.
x-ms-activity-id Representa um identificador exclusivo para a operação. Isto faz eco do valor do cabeçalho do pedido x-ms-activity-id e é normalmente utilizado para fins de resolução de problemas.
x-ms-alt-content-path O caminho alternativo para o recurso. Os recursos podem ser endereçados em REST através de IDs gerados pelo sistema ou IDs fornecidos pelo utilizador. x-ms-alt-content-path representa o caminho construído com os IDs fornecidos pelo utilizador.
x-ms-continuation Este cabeçalho representa o estado intermédio da execução da consulta (ou do feed de leitura) e é devolvido quando existem resultados adicionais para além do que foi devolvido na resposta. Os clientes podem submeter novamente o pedido com um cabeçalho de pedido que contém
o valor de x-ms-continuation.
x-ms-item-count O número de itens devolvidos para uma consulta ou pedido de feed de leitura.
x-ms-request-charge Este é o número de pedidos normalizados a.k.a. unidades de pedido (RU) para a operação. Para obter mais informações, veja Unidades de pedido no Azure Cosmos DB.
x-ms-resource-quota Mostra a quota atribuída para um recurso numa conta.
x-ms-resource-usage Mostra a contagem de utilização atual de um recurso numa conta. Ao eliminar um recurso, isto mostra o número de recursos após a eliminação.
x-ms-retry-after-ms O número de milissegundos a aguardar para repetir a operação depois de uma operação inicial ter recebido o código de estado HTTP 429 e ter sido limitado.
x-ms-schemaversion Mostra o número da versão do esquema de recursos.
x-ms-serviceversion Mostra o número da versão do serviço.
x-ms-session-token O token de sessão do pedido. Para a consistência da sessão, os clientes têm de fazer eco deste pedido através do cabeçalho do pedido x-ms-session-token para operações subsequentes efetuadas à coleção correspondente.
x-ms-documentdb-partitionkeyrangeid Cabeçalho interno que identifica o intervalo de chaves de partição do pedido. Recomenda-se aos utilizadores que não assumam qualquer dependência deste valor de cabeçalho nas respetivas aplicações.

Ver também