Todas as requisições da API do Simple Log Service aceitam um conjunto de cabeçalhos HTTP comuns para autenticação, compactação e negociação de conteúdo.
Parâmetros
A tabela a seguir lista os cabeçalhos de requisição comuns das APIs RESTful do SLS.
|
Nome do cabeçalho |
Tipo |
Obrigatório |
Descrição |
|
Accept |
String |
Não |
Formato de resposta esperado. Valores válidos: application/json, application/x-protobuf. Aplica-se apenas a requisições GET. O valor aceito varia conforme a API. |
|
Accept-Encoding |
String |
Não |
Compactação de resposta esperada. Valores válidos: lz4, deflate ou vazio (sem compactação). Aplica-se apenas a requisições GET. O valor aceito varia conforme a API. |
|
Authorization |
String |
Sim |
String de assinatura da requisição calculada conforme descrito em Assinaturas de requisição. |
|
Content-Length |
Number |
Não |
Comprimento do corpo da requisição HTTP (RFC 2616). Dispensável se a requisição não tiver corpo. |
|
Content-MD5 |
String |
Não |
Hash MD5 em letras maiúsculas do corpo da requisição. Dispensável se a requisição não tiver corpo. |
|
Content-Type |
String |
Não |
Tipo do corpo da requisição HTTP (RFC 2616). Atualmente, há suporte apenas para application/x-protobuf. Dispensável se a requisição não tiver corpo. O valor aceito varia conforme a API. |
|
Date |
String |
Sim |
Timestamp da requisição em GMT, no formato RFC 1123. Exemplo: Mon, 3 Jan 2010 08:33:47 GMT. |
|
Host |
String |
Sim |
Nome completo do host do endpoint, sem o prefixo de protocolo (como |
|
x-log-apiversion |
String |
Sim |
Versão da API. A versão atual é 0.6.0. |
|
x-log-bodyrawsize |
Number |
Não |
Tamanho bruto (não compactado) do corpo da requisição em bytes. Defina como 0 se a requisição não tiver corpo. Para requisições compactadas, especifique o tamanho antes da compactação. Intervalo válido: 0–3.145.728. Obrigatório apenas quando o corpo estiver compactado. |
|
x-log-compresstype |
String |
Não |
Algoritmo de compactação do corpo da requisição. Valores válidos: lz4, deflate (RFC 1951, formato zlib conforme RFC 1950). Omita este cabeçalho se o corpo não estiver compactado. |
|
x-log-date |
String |
Não |
Timestamp da requisição no mesmo formato de Date. Quando presente, substitui o cabeçalho Date na validação de tempo pelo servidor, mas não participa do cálculo da assinatura. O cabeçalho padrão Date permanece obrigatório mesmo que x-log-date seja especificado. |
|
x-log-signaturemethod |
String |
Sim |
Algoritmo de assinatura. O único valor com suporte é |
|
x-acs-security-token |
String |
Não |
Necessário apenas ao usar credenciais temporárias do STS para enviar dados. |
O valor do cabeçalho Date deve estar dentro de 15 minutos do horário do servidor; caso contrário, o sistema rejeita a requisição. Se o cabeçalho x-log-date estiver presente, a verificação de discrepância de tempo usa o valor de x-log-date em vez de Date.
Se x-log-compresstype estiver definido, o corpo da requisição deverá conter dados compactados. Calcule Content-Length e Content-MD5 com base no corpo compactado.
Caso sua plataforma ou biblioteca HTTP defina automaticamente o cabeçalho Date, use x-log-date para fornecer o timestamp correto para o cálculo da assinatura. O servidor valida a assinatura em relação a x-log-date quando este estiver presente ou, caso contrário, em relação ao cabeçalho padrão Date.
Exemplo
POST / HTTP/1.1
Authorization: LOG <yourAccessKeyId>:<yourSignature>
x-log-bodyrawsize: 0
User-Agent: sls-java-sdk-v-0.6.1
x-log-apiversion: 0.6.0
Host: my-project-test.cn-shanghai.log.aliyuncs.com
x-log-signaturemethod: hmac-sha1
Date: Sun, 27 May 2018 07:43:26 GMT
Content-Type: application/json
Content-MD5: A7967D81EFF5E3CD447FB6D8DF294E20
Content-Length: 80
Connection: Keep-Alive