GetCnameToken - Recuperar um token CNAME criado - Object Storage Service: Central de Documentação do Alibaba Cloud

A operação GetCnameToken recupera um token CNAME já criado. Use o parâmetro wildcard para especificar se deseja recuperar o token de um CNAME exato ou de um CNAME curinga.

Observações de uso

Para um Agentic Bucket, o parâmetro wildcard é obrigatório: wildcard=true recupera o token de um CNAME curinga, enquanto wildcard=false recupera o token de um CNAME exato. Não omita esse parâmetro nem o deixe em branco. Em buckets padrão, ele é opcional.
Para recuperar o token de um CNAME curinga, defina cname como o domínio base do nome de domínio curinga, sem o prefixo *., como example.com.

Sintaxe da solicitação

GET /?cname&comp=token&cname=example.com&wildcard=true 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

Esta operação usa apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Common HTTP headers.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

cname

String

Sim

example.com

Nome de domínio de destino. Para um CNAME exato, defina este parâmetro com o nome de domínio completo, como console.example.com. Para um CNAME curinga, use o domínio base do nome de domínio curinga sem o prefixo *., como example.com.

wildcard

String

Bucket padrão: Não

Agentic Bucket: Sim

true

Indica se o token a ser recuperado refere-se a um CNAME curinga. Valores válidos:

true: recupera o token de um CNAME curinga.
false: recupera o token de um CNAME exato.

Em um Agentic Bucket, este parâmetro é obrigatório e deve ser definido explicitamente como true ou false. Não é possível omiti-lo ou deixá-lo em branco. Em buckets padrão, ele é opcional e assume false como valor padrão.

Cabeçalhos da resposta

Esta operação retorna apenas cabeçalhos de resposta comuns. Para mais informações, consulte Common HTTP headers.

Elementos da resposta

Elemento	Tipo	Exemplo	Descrição
CnameToken	Container	N/A	Contêiner onde o token CNAME é armazenado. Nós pai: nenhum Nós filho: Bucket, Cname, Token e ExpireTime
Bucket	String	examplebucket	Nome do bucket ao qual o CNAME está mapeado. Nós pai: CnameToken Nós filho: nenhum
Cname	String	example.com	Nome do CNAME mapeado. Nós pai: CnameToken Nós filho: nenhum
Token	String	be1d49d863dea9ffeff3df7d6455****	Token CNAME retornado pelo OSS. Nós pai: CnameToken Nós filho: nenhum
ExpireTime	String	Wed, 23 Feb 2022 21:16:37 GMT	Horário de expiração do token CNAME. Nós pai: CnameToken Nós filho: nenhum

Exemplos

Exemplos de solicitações

Consultar o token CNAME para um CNAME exato de um bucket padrão

GET /?cname&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

Consultar o token CNAME para um CNAME curinga de um Agentic Bucket

GET /?cname&comp=token&cname=example.com&wildcard=true HTTP/1.1
Host: myab-$uid-$region-ab-apsr.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

Exemplos de respostas

Token CNAME recuperado com sucesso.

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>myab-$uid-$region-ab-apsr</Bucket>
  <Cname>example.com</Cname>
  <Token>be1d49d863dea9ffeff3df7d6455****</Token>
  <ExpireTime>Fri, 01 Aug 2026 03:00:00 GMT</ExpireTime>
</CnameToken>

Token CNAME não criado ou expirado.

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>NoSuchCnameToken</Code>
  <Message>The specified cname token does not exist.</Message>
  <RequestId>6215FE05DA0E27393F005F0E</RequestId>
  <HostId>myab-$uid-$region-ab-apsr.oss-cn-hangzhou.aliyuncs.com</HostId>
  <Bucket>myab-$uid-$region-ab-apsr</Bucket>
  <Cname>example.com</Cname>
</Error>

SDKs do OSS

Os seguintes SDKs do OSS oferecem suporte à operação GetCnameToken:

ossutil

Para obter informações sobre o comando do 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	Este erro pode ocorrer pelos seguintes motivos: O CNAME a ser consultado não foi especificado ou seu formato é inválido. O nome de domínio contém caracteres inválidos, como o literal de domínio curinga `*.example.com`. O parâmetro `wildcard` não foi especificado para um Agentic Bucket, ou o valor do parâmetro `wildcard` é inválido.
NoSuchCnameToken	404	Nenhum token foi criado para este CNAME ou o token expirou.
MethodNotAllowed	405	O recurso CNAME não está ativado para o tipo de bucket de destino.