CreateCnameToken - Create a CNAME token to verify domain name ownership - Object Storage Service

Kullanım notları

Varsayılan olarak, bir CNAME belirteci oluşturulduktan 72 saat sonra sona erer. Bir belirteç hala geçerliyken bu işlemi tekrar çağırırsanız OSS mevcut belirteci döndürür.
Agentic Bucket için wildcard parametresi gereklidir: wildcard=true joker karakterli bir CNAME için belirteç oluşturur ve wildcard=false tam bir CNAME için belirteç oluşturur.
Standart paket için tam bir CNAME adına yönelik belirteç oluşturma işlemi, mevcut OSS CNAME işlemleriyle aynı şekilde çalışır. Yeni parametreler gerekmez.

İstek sözdizimi

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

<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
  </Cname>
</BucketCnameConfiguration>

İ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

wildcard

String

Standart paket: Hayır

Agentic Bucket: Evet

true

Joker karakterli bir CNAME için belirteç oluşturulup oluşturulmayacağını belirtir. Geçerli değerler:

true: joker karakterli bir CNAME için belirteç oluşturur.
false: tam bir CNAME için belirteç oluşturur.

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

wildcard parametresi her paket türü için farklı değerler alır:

Paket türü	Parametre atlandı	wildcard=false	wildcard=true
Standart paket	İzin verilir. Tam bir CNAME için belirteç oluşturur.	İzin verilir. Tam bir CNAME için belirteç oluşturur.	İzin verilmez
Agentic Bucket	İzin verilmez	İzin verilir. Tam bir CNAME için belirteç oluşturur.	İzin verilir. Joker karakterli bir CNAME için belirteç oluşturur.

Not

Bir (paket, CNAME) çifti için tek bir belirteç hem tam hem de joker karakterli kapsamı kapsar.

İstek öğeleri

Öğe	Tür	Gerekli	Örnek	Açıklama
BucketCnameConfiguration	Container	Evet	Yok	CNAME yapılandırmasını depolayan konteyner. Üst düğümler: yok Alt düğümler: Cname
Cname	Container	Evet	Yok	CNAME bilgilerini depolayan konteyner. Üst düğümler: BucketCnameConfiguration Alt düğümler: Domain
Domain	String	Evet	example.com	Özel etki alanı adı. Tam bir CNAME için belirteç oluşturmak üzere bu öğeyi console.example.com gibi tam etki alanı adına ayarlayın. Joker karakterli bir CNAME için belirteç oluşturmak üzere bu öğeyi `*.` öneki olmadan example.com gibi temel etki alanı adına ayarlayın. Üst düğümler: Cname Alt düğümler: yok

Tekrarlanabilirlik

CreateCnameToken işleminin tekrarlanabilirliği paket türüne ve CNAME'in geçerli pakete eşlenip eşlenmediğine bağlıdır:

Standart paket: CNAME silinmiş durumu dışındaki herhangi bir durumda zaten geçerli pakete eşlenmişse OSS NoNeedCreateCnameToken döndürür ve belirteç oluşturmanız gerekmez.
Agentic Bucket: OSS yalnızca mevcut Agentic Bucket temel etki alanı adını aynı türde bir CNAME'e eşlemişse NoNeedCreateCnameToken döndürür.

Yanıt öğeleri

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

Örnekler

Örnek istekler

Standart paket için CNAME belirteci oluşturun

POST /?cname&comp=token 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

<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
  </Cname>
</BucketCnameConfiguration>

Agentic Bucket'un joker karakterli CNAME'i için CNAME belirteci oluşturun

POST /?cname&comp=token&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

<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
  </Cname>
</BucketCnameConfiguration>

Agentic Bucket'un tam CNAME'i için CNAME belirteci oluşturun

POST /?cname&comp=token&wildcard=false 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

<BucketCnameConfiguration>
  <Cname>
    <Domain>console.example.com</Domain>
  </Cname>
</BucketCnameConfiguration>

Örnek yanıtlar

CNAME belirteci oluşturuldu.

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 sayısı üst sınırı aştı.

HTTP/1.1 400 Bad Request
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>TooManyCnameToken</Code>
  <Message>You have attempted to create more cname token than allowed.</Message>
  <RequestId>6215FD21DA0E27393F004E9E</RequestId>
  <HostId>127.0.0.1</HostId>
  <Bucket>examplebucket</Bucket>
</Error>

OSS SDK'leri

Aşağıdaki OSS SDK'leri CreateCnameToken işlemini destekler:

ossutil

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

Hata kodları

Hata kodu	HTTP durum kodu	Açıklama
InvalidArgument	400	Hatanın olası nedenleri şunlardır: Domain öğesi `*.example.com` gibi geçersiz karakterler içeriyor.
TooManyCnameToken	400	Aynı paket için oluşturulan belirteç sayısı üst sınırı aşıyor.
NoNeedCreateCnameToken	200	CNAME zaten geçerli pakete eşlenmiştir ve belirteç oluşturmanız gerekmez. Standart paket için OSS, CNAME silinmiş durumu dışındaki herhangi bir durumda zaten geçerli pakete eşlendiğinde bu yanıtı döndürür. Agentic Bucket için OSS yalnızca temel etki alanı adı aynı türde bir CNAME tarafından mevcut Agentic Bucket'a zaten eşlendiğinde bu yanıtı döndürür.
MethodNotAllowed	405	Hedef paket türü için CNAME özelliği etkin değil.