Todos os produtos
Search
Central de documentação

Object Storage Service:Obter o token CNAME criado

Última atualização: Jul 03, 2026

Obtém o token CNAME criado.

Sintaxe da solicitação

GET /?comp=token&cname=example.com HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
Content-Length: 186
Date: GMT Date
Authorization: SignatureValue

Cabeçalhos da solicitação

Todos os cabeçalhos de uma solicitação GetCnameToken são cabeçalhos comuns. Para mais informações, consulte Cabeçalhos comuns de solicitação.

Parâmetros de resposta

Todos os cabeçalhos na resposta de uma solicitação GetCnameToken são cabeçalhos comuns de resposta. Para mais informações, consulte Cabeçalhos HTTP comuns.

Elementos de resposta

Elemento

Tipo

Exemplo

Descrição

CnameToken

Container

N/A

O contêiner que armazena o token CNAME.

Nós pai: nenhum

Nós filho: Bucket, Cname, Token e ExpireTime

Bucket

String

examplebucket

O nome do bucket ao qual o registro CNAME está mapeado.

Nós pai: CnameToken

Nós filho: nenhum

Cname

String

example.com

O nome do registro CNAME mapeado ao bucket.

Nós pai: CnameToken

Nós filho: nenhum

Token

String

be1d49d863dea9ffeff3df7d6455****

O token CNAME retornado pelo OSS.

Nós pai: CnameToken

Nós filho: nenhum

ExpireTime

String

Wed, 23 Feb 2022 21:16:37 GMT

O horário de expiração do token CNAME.

Nós pai: CnameToken

Nós filho: nenhum

Exemplos

  • Solicitação de exemplo

    GET /?comp=token&cname=example.com HTTP/1.1
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com
    Content-Type: application/xml
    Content-Length: 186
    Date: Thu, 17 Apr 2025 15:39:12 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  • Respostas de exemplo

    • O token CNAME não foi criado ou expirou.

      HTTP/1.1 404 Not Found
      x-oss-request-id: 5C1B138A109F4E405B2D
      Date: Mon, 26 Jul 2021 13:08:38 GMT
      Content-Length: 118
      Content-Type: application/xml
      Connection: keep-alive
      Server: AliyunOSS
      <?xml version="1.0" encoding="UTF-8"?>
      <Error>
        <Code>CnameTokenNotFound</Code>
        <Message>Cname token not found.</Message>
        <RequestId>6215FE05DA0E27393F005F0E</RequestId>
        <HostId>127.0.0.1</HostId>
        <Bucket>mybucket</Bucket>
        <Cname>example.com</Cname>
        <EC>0018-00000301</EC>
      </Error>
    • O token CNAME foi encontrado.

      HTTP/1.1 200 OK
      x-oss-request-id: 5C1B138A109F4E405B2D
      Date: Mon, 26 Jul 2021 13:08:38 GMT
      Content-Length: 118
      Content-Type: application/xml
      Connection: keep-alive
      Server: AliyunOSS
      <?xml version="1.0" encoding="UTF-8"?>
      <CnameToken>
        <Bucket>mybucket</Bucket>
        <Cname>example.com</Cname>
        <Token>be1d49d863dea9ffeff3df7d6455****</Token>
        <ExpireTime>Wed, 23 Feb 2022 21:39:42 GMT</ExpireTime>
      </CnameToken>

SDKs do OSS

Use os SDKs do OSS nas linguagens a seguir para chamar GetCnameToken:

ossutil

Para informações sobre o comando ossutil correspondente à operação GetCnameToken, consulte get-cname-token.

Códigos de erro

Código de erro

Código de status HTTP

Descrição

InvalidArgument

400

O registro CNAME que você deseja consultar não está incluído na lista de parâmetros ou o formato do registro CNAME é inválido.

CnameTokenNotFound

404

O token CNAME não foi criado ou expirou.