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. |