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

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

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

リクエスト構文

POST /?cname&comp=トークンHTTP/1.1
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
コンテンツ-長さ: 186
日付: GMT日付
権限付与: SignatureValue

リクエストヘッダー

このAPI操作に含まれるリクエストヘッダーには、共通のリクエストヘッダーのみが含まれます。詳細については、「共通リクエストヘッダー」をご参照ください。

リクエスト要素

要素	データ型	必須	例	説明
BucketCnameConfiguration	Container	必須	N/A	CNAMEレコードを格納するコンテナー。親ノード: なし子ノード: Cname
Cname	Container	必須	N/A	CNAME情報が格納されるコンテナ。親ノード: BucketCnameConfiguration 子ノード: ドメイン
ドメイン	String	必須	example.com	カスタムドメイン名。親ノード: Cname 子ノード: なし

レスポンス要素

要素	データ型	例	説明
CnameToken	Container	N/A	CNAMEトークンが格納されるコンテナ。親ノード: なし子ノード: Bucket、Cname、Token、ExpireTime
バケット	String	examplebucket	CNAMEレコードがマップされるバケットの名前。親ノード: CnameToken 子ノード: なし
Cname	String	example.com	バケットにマップされているCNAMEレコードの名前。親ノード: CnameToken 子ノード: なし
トークン	String	be1d49d863dea9ffeff3df7d6455 ****	Object Storage Service (OSS) によって返されるCNAMEトークン。親ノード: CnameToken 子ノード: なし
ExpireTime	String	2月23日水曜日2022 21:16:37 GMT	CNAMEトークンの有効期限が切れる時刻。親ノード: CnameToken 子ノード: なし

例

POST /?cname&comp=トークンHTTP/1.1のサンプルリクエスト


ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
コンテンツ-長さ: 186
日付: 9月2015日木曜日15:39:12 GMT
権限付与: OSS qn6qrrqxo2oawuk53otf ****:KU5h8YMUC78M30dXqf3JxrTZ ****

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

レスポンスの例

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

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D
日付: 7月26日月曜日2021 13:08:38 GMT
コンテンツ-長さ: 118
Content-Type: application/xml
接続: キープアライブ
サーバー: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<CnameToken>
  <Bucket>examplebucket</Bucket>
  <Cnam e>example.com</Cname>;
  <トークン> be1d49d863dea9ffeff3df7d6455 ****</Token>
  <ExpireTime> 2月23日水曜日2022 21:16:37 GMT</ExpireTime>
</CnameToken>

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

HTTP/1.1 400不正なリクエスト
x-oss-request-id: 5C1B138A109F4E405B2D
日付: 7月26日月曜日2021 13:08:38 GMT
コンテンツ-長さ: 118
Content-Type: application/xml
接続: キープアライブ
サーバー: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<エラー>
  <コード> TooManyCnameToken</Code>
  <メッセージ> 許可されているよりも多くのcnameトークンを作成しようとしました。</Message>
  <RequestId>6215FD21DA0E27393F004E9E</RequestId>
  <HostId>127.0.0.1</HostId>
  <Bucket>examplebucket</Bucket>
</エラー>

エラーコード

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