CreateCnameToken - Object Storage Service - Alibaba Cloud ドキュメントセンター

CNAME トークンを作成してドメイン名の所有権を確認します。

説明

デフォルトでは、CNAME トークンは作成後 72 時間以内に有効期限が切れます。既存のトークンの有効期間内に新しい CNAME トークンが作成されると、既存の CNAME トークンが返されます。

リクエスト構文

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

リクエストヘッダー

RestoreObject リクエストのリクエストヘッダーは、共通のリクエストヘッダーのみです。詳細については、「共通リクエストヘッダー」をご参照ください。

リクエスト要素

要素	タイプ	必須	例	説明
BucketCnameConfiguration	コンテナー	はい	該当なし	CNAME レコードを格納するコンテナー。親ノード: なし子ノード: Cname
Cname	コンテナー	はい	該当なし	CNAME 情報が格納されているコンテナー。親ノード: BucketCnameConfiguration 子ノード: Domain
Domain	文字列	はい	example.com	カスタムドメイン名。親ノード: Cname 子ノード: なし

レスポンス要素

要素	タイプ	例	説明
CnameToken	コンテナー	該当なし	CNAME トークンが格納されているコンテナー。親ノード: なし子ノード: Bucket、Cname、Token、および ExpireTime
Bucket	文字列	examplebucket	CNAME レコードがマッピングされているバケットの名前。親ノード: CnameToken 子ノード: なし
Cname	文字列	example.com	バケットにマッピングされている CNAME レコードの名前。親ノード: CnameToken 子ノード: なし
Token	文字列	be1d49d863dea9ffeff3df7d6455****	Object Storage Service (OSS) によって返される CNAME トークン。親ノード: CnameToken 子ノード: なし
ExpireTime	文字列	Wed, 23 Feb 2022 21:16:37 GMT	CNAME トークンの有効期限が切れる時刻。親ノード: CnameToken 子ノード: なし

例

リクエストの例

POST /?cname&comp=token HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
Content-Length: 186
Date: Thu, 24 Sep 2015 15:39:12 GMT
Authorization: OSS qn6q**************:77Dv****************

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

レスポンスの例

CNAME トークンが作成されます。

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>examplebucket</Bucket>
  <Cname>example.com</Cname>;
  <Token>be1d49d863dea9ffeff3df7d6455****</Token>
  <ExpireTime>Wed, 23 Feb 2022 21:16:37 GMT</ExpireTime>
</CnameToken>

CNAME トークンの数が制限を超えています。

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

以下のプログラミング言語の OSS SDK を使用して、CreateCnameToken を呼び出すことができます。

ossutil

CreateCnameToken 操作に対応する ossutil コマンドについては、「create-cname-token」をご参照ください。

エラーコード

エラーコード	HTTP ステータスコード	説明
TooManyCnameToken	400	バケットに作成されたトークン数が上限の 1000 を超えたために返されるエラーメッセージ。
NoNeedCreateCnameToken	403	CNAME トークンが有効であるために返されるエラーメッセージ。バケットに新しい CNAME トークンを作成する必要はありません。