As APIs RESTful do OSS utilizam um conjunto de cabeçalhos de requisição e de resposta comuns.
Cabeçalhos de requisição comuns
A tabela a seguir descreve os cabeçalhos de requisição comuns utilizados nas requisições da API RESTful do OSS.
|
Nome |
Tipo |
Valor de exemplo |
Descrição |
|
Authorization |
String |
OSS4-HMAC-SHA256 Credential=**** |
Autentica requisições não anônimas. Para calcular este cabeçalho, consulte Versão de assinatura 4 (Recomendado). Valor padrão: nenhum |
|
Content-Length |
String |
556 |
O comprimento do conteúdo da requisição HTTPS conforme definido na RFC 2616. Valor padrão: nenhum |
|
Content-Type |
String |
application/xml |
O tipo de conteúdo da requisição HTTPS conforme definido na RFC 2616. Valor padrão: nenhum |
|
Date |
String |
Sun, 05 Sep 2021 23:00:00 GMT |
A hora GMT especificada no HTTPS 1.1. Valor padrão: nenhum |
|
Host |
String |
oss-example.oss-cn-hangzhou.aliyuncs.com |
O endpoint segue o formato Valor padrão: nenhum |
|
x-oss-security-token |
String |
CAISowJ1q6Ft5B2yfSjIr5feHsPhtYh3+pONd2uCglI3dvxVt7DB1Tz2IHxMdHJsCeAcs/Q0lGFR5/sflqJIRoReREvCUcZr8sy2SqEGos2T1fau5Jko1be0ewHKeQKZsebWZ+LmNpy/Ht6md1HDkAJq3LL+bk/Mdle5MJqP+/kFC9MMRVuAcCZhDtVbLRcYgq18D3bKMuu3ORPHm3fZCFES2jBxkmRi86+ysIP+phPVlw/90fRH5dazcJW0Zsx0OJo6Wcq+3+FqM6DQlTNM6hwNtoUO1fYUommb54nDXwQIvUjfbtC5qIM/cFVLAYEhALNBofTGkvl1h/fejYyfyWwWYbkFCHiPFNr9kJCUSbr4a4sjF6zyPnPWycyCLYXleLzhxPWd/2kagAF6qLNY5paXF18NyRP0PISqxlWBuSQldMS3avlblTFB7apY8CUiAQcSY3uDYUhuxU+KFBxpGaq8c1SU5ARo+1JBA5nXhFlY2nbDnWONxa0mvNvE3XJ0FZJnDS7WBHyOMjC8nmw2GfaQ4bxQ0D2+20yrDNevWSSqnwh0qXMI3zY5**** |
Necessário apenas ao acessar o OSS com credenciais temporárias do Security Token Service (STS). AssumeRole - Obter credenciais de identidade temporárias para uma função. |
Cabeçalhos de resposta comuns
A tabela a seguir descreve os cabeçalhos de resposta comuns retornados pelas APIs RESTful do OSS.
|
Nome |
Tipo |
Valor de exemplo |
Descrição |
|
Content-Length |
String |
556 |
O comprimento do conteúdo da resposta HTTPS conforme definido na RFC 2616. Valor padrão: nenhum |
|
Connection |
Enumeração |
keep-alive |
O status da conexão entre o cliente e o OSS. Valores válidos: keep-alive e close Valor padrão: nenhum |
|
Date |
String |
Sun, 05 Sep 2021 23:00:00 GMT |
A hora GMT especificada no HTTPS 1.1. Valor padrão: nenhum |
|
ETag |
String |
5B3C1A2E053D763E1B002CC607C5A0FE1**** |
Uma tag de entidade que identifica o conteúdo do objeto. Para objetos criados via PutObject, o ETag corresponde ao hash MD5 do conteúdo. Já para objetos criados por outros métodos, o ETag é um valor único baseado em uma regra específica, e não o hash MD5. Utilize ETags para detectar alterações no conteúdo. Valor padrão: nenhum |
|
Server |
String |
AliyunOSS |
O servidor que gerou a resposta. Valor padrão: AliyunOSS |
|
x-oss-request-id |
String |
534B371674E88A4D8906**** |
Um UUID que identifica exclusivamente a requisição. Forneça este ID ao suporte técnico para solução de problemas. Obter um Request ID. Valor padrão: nenhum |