Object Storage Service:Include a V4 signature in the Authorization header (recommended)

Parâmetro

Descrição

HTTP Verb

O método de requisição HTTP, incluindo PUT, GET, POST, HEAD, DELETE e OPTIONS.

Canonical URI

Caminho do recurso com codificação URI. O caminho do recurso não inclui a query string, e a codificação de barras (/) não é necessária.

• Se o alvo da requisição for o OSS, o caminho do recurso é / e o caminho com codificação URI é UriEncode("/").

• Se o alvo for um bucket, o caminho do recurso é /examplebucket/ e o caminho com codificação URI é UriEncode("/examplebucket/").

• Se o alvo for um objeto em um bucket, o caminho do recurso é /examplebucket/exampleobject e o caminho com codificação URI é UriEncode("/examplebucket/exampleobject").

Canonical Query String

Parâmetros de query com codificação URI ordenados lexicograficamente.

• Quando os parâmetros de query incluem tanto nomes quanto valores, codifique separadamente o nome e o valor de cada parâmetro via URI e ordene-os lexicograficamente pelos nomes codificados. A ordenação é feita após a codificação. Use = para conectar o nome e o valor codificados, e & para concatenar parâmetros diferentes.

  • Parâmetros de query: prefix=somePrefix&marker=someMarker&max-keys=20

  • Parâmetros de query canonicalizados:

    UriEncode("marker")+"="+UriEncode("someMarker")+"&"+UriEncode("max-keys")+"="+UriEncode("20")+"&"+UriEncode("prefix")+"="+UriEncode("somePrefix")

• Se o parâmetro de query contiver apenas o nome do parâmetro, aplique a codificação URI somente ao nome.

  • Parâmetro de query: ?acl

  • Parâmetro de query canonicalizado: UriEncode("acl")

• Na ausência de parâmetros de query — ou seja, quando o URI da requisição não contém ? — defina a canonicalized query string como uma string vazia ("").

Canonical Headers

A lista de headers da requisição.

Os headers de requisição se dividem em três categorias:

• Headers que devem existir na requisição e ser incluídos no cálculo da assinatura:

  • x-oss-content-sha256: somente UNSIGNED-PAYLOAD é suportado.

• Headers que devem ser incluídos no cálculo da assinatura quando presentes na requisição:

  • Content-Type

  • Content-MD5

  • x-oss-*: Outros headers de requisição com prefixo x-oss-. Por exemplo, ao acessar via STS AK, o SecurityToken é informado por meio de x-oss-security-token:security-token. O horário da requisição é descrito por x-oss-date, e a sintaxe deve seguir o formato de tempo padrão ISO8601, como 20231203T121212Z.

• Headers de requisição opcionais especificados em AdditionalHeaders.

A sintaxe é a seguinte:

Lowercase(<HeaderName1>) + ":" + Trim(<value>) + "\n"
Lowercase(<HeaderName2>) + ":" + Trim(<value>) + "\n"
...
Lowercase(<HeaderNameN>) + ":" + Trim(<value>) + "\n"

Exemplo de código:

content-disposition:attachment
content-length:3
content-md5:ICy5YqxZB1uWSwcVLSNLcA==
content-type:text/plain
x-oss-content-sha256:UNSIGNED-PAYLOAD
x-oss-date:20250328T101048Z

Additional Headers

Especifica os headers de requisição opcionais incluídos no cálculo da assinatura (não é necessário especifique os headers obrigatórios). Este campo contém apenas nomes de headers em letras minúsculas, ordenados lexicograficamente e separados por ponto e vírgula (;), de forma consistente com AdditionalHeaders.

Inclua apenas nomes de headers em letras minúsculas, ordenados lexicograficamente, excluindo os headers obrigatórios. Separe-os por ponto e vírgula (;), de forma consistente com AdditionalHeaders.

Exemplo de código:

content-disposition;content-length

Hashed PayLoad

A representação hexadecimal do hash SHA256 do payload da requisição. Somente o valor UNSIGNED-PAYLOAD é suportado.

Parâmetro

Descrição

OSS4-HMAC-SHA256

O algoritmo de hash da assinatura; o valor deve ser OSS4-HMAC-SHA256.

TimeStamp

O horário UTC atual, cuja sintaxe deve seguir o padrão ISO8601, como 20250320T083322Z.

Scope

O conjunto de parâmetros para obter a derived key. Esse conjunto especifica a data, a região e o service; portanto, a assinatura calculada com a derived key é válida apenas para a data, a região e o service especificados.

A sintaxe é a seguinte:

<SignDate>/<SignRegion>/oss/aliyun_v4_request

Descrição dos campos:

• SignDate: A data no formato YYYYMMDD incluída na assinatura.

• SignRegion: O region ID usado para a assinatura, como cn-hangzhou.

• oss: O nome do service incluído na assinatura, fixo como oss.

• aliyun_v4_request: A versão incluída na assinatura, fixo como aliyun_v4_request.

CanonicalRequest

A canonicalized request construída.

Parâmetro

Valor

AccessKeyId

LTAI

AccessKeySecret

yourAccessKeySecret

Timestamp

20250411T064124Z

Bucket

examplebucket

Object

exampleobject

Region

cn-hangzhou