GetCnameToken - Retrieve an existing CNAME token - Object Storage Service

GetCnameToken, mevcut bir CNAME belirtecini alır. Belirteci tam bir CNAME için mi yoksa joker karakterli (wildcard) bir CNAME için mi alacağınızı belirtmek üzere wildcard parametresini kullanın.

Kullanım notları

Agentic Bucket için wildcard parametresi gereklidir: wildcard=true joker karakterli bir CNAME için belirteci alır; wildcard=false ise tam bir CNAME için belirteci alır. Standart bir paket için bu parametreyi atlarsanız değer varsayılan olarak false olur.
Joker karakterli bir CNAME için belirteci almak üzere cname parametresini *. ön eki olmadan temel etki alanı adına ayarlayın (örneğin example.com).

İstek sözdizimi

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

İstek üstbilgileri

Bu işlem yalnızca ortak istek üstbilgilerini kullanır. Daha fazla bilgi için bkz. Ortak HTTP üstbilgileri.

İstek parametreleri

Parametre

Tür

Gerekli

Örnek

Açıklama

cname

Dize

Evet

example.com

Hedef etki alanı adı. Tam bir CNAME için bu parametreyi console.example.com gibi tam etki alanı adına ayarlayın. Joker karakterli bir CNAME için bu parametreyi *. ön eki olmadan temel etki alanı adına (örneğin example.com) ayarlayın.

wildcard

Dize

Standart paket: Hayır

Agentic Bucket: Evet

true

Belirtecin joker karakterli bir CNAME için alınıp alınmayacağını belirtir. Geçerli değerler:

true: Joker karakterli bir CNAME için belirteci alır.
false: Tam bir CNAME için belirteci alır.

Agentic Bucket için bu parametre gereklidir. Değeri açıkça true veya false olarak ayarlayın. Standart bir paket için bu parametreyi atlarsanız değer varsayılan olarak false olur.

Yanıt üstbilgileri

Bu işlem yalnızca ortak yanıt üstbilgilerini döndürür. Daha fazla bilgi için bkz. Ortak HTTP üstbilgileri.

Yanıt öğeleri

Öğe	Tür	Örnek	Açıklama
CnameToken	Konteyner	Yok	CNAME belirtecini depolayan konteyner. Üst düğümler: yok Alt düğümler: Bucket, Cname, Token ve ExpireTime
Bucket	Dize	examplebucket	CNAME'in eşlendiği paketin adı. Üst düğümler: CnameToken Alt düğümler: yok
Cname	Dize	example.com	Eşlenen CNAME'in adı. Üst düğümler: CnameToken Alt düğümler: yok
Token	Dize	be1d49d863dea9ffeff3df7d6455****	OSS tarafından döndürülen CNAME belirteci. Üst düğümler: CnameToken Alt düğümler: yok
ExpireTime	Dize	Wed, 23 Feb 2022 21:16:37 GMT	CNAME belirtecinin sona erdiği zaman. Üst düğümler: CnameToken Alt düğümler: yok

Örnekler

Örnek istekler

Standart bir paketin tam bir CNAME'i için CNAME belirtecini sorgulama

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

Agentic Bucket'ın joker karakterli bir CNAME'i için CNAME belirtecini sorgulama

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

Örnek yanıtlar

CNAME belirteci alındı.

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>

CNAME belirteci oluşturulmamış veya süresi dolmuş.

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>

OSS SDK'ları

Aşağıdaki OSS SDK'ları GetCnameToken işlemini destekler:

ossutil

GetCnameToken işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. get-cname-token.

Hata kodları

Hata kodu	HTTP durum kodu	Açıklama
InvalidArgument	400	Hatanın olası nedenleri şunlardır: Sorgulanacak CNAME'i belirtmediniz veya CNAME biçimi geçersiz. Domain öğesi `*.example.com` gibi geçersiz karakterler içeriyor. Agentic Bucket için `wildcard` parametresi belirtilmemiş veya `wildcard` değeri geçersiz.
NoSuchCnameToken	404	Bu CNAME için herhangi bir belirteç oluşturulmamış veya belirtecin süresi dolmuş.
MethodNotAllowed	405	CNAME özelliği hedef paket türü için etkin değil.