作成された CNAME トークンを取得します。
リクエスト構文
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リクエストヘッダー
GetCnameToken リクエストのすべてのリクエストヘッダーは、共通リクエストヘッダーです。 詳細については、「共通リクエストヘッダー」をご参照ください。
レスポンスパラメーター
GetCnameToken リクエストへのレスポンスのすべてのヘッダーは、共通レスポンスヘッダーです。 詳細については、「共通 HTTP ヘッダー」をご参照ください。
レスポンス要素
要素 | タイプ | 例 | 説明 |
CnameToken | コンテナー | 該当なし | CNAME トークンが格納されているコンテナー。 親ノード: なし 子ノード: Bucket、Cname、Token、および ExpireTime |
Bucket | 文字列 | examplebucket | CNAME レコードがマッピングされているバケットの名前。 親ノード: CnameToken 子ノード: なし |
Cname | 文字列 | example.com | バケットにマッピングされている CNAME レコードの名前。 親ノード: CnameToken 子ノード: なし |
Token | 文字列 | be1d49d863dea9ffeff3df7d6455**** | OSS から返される CNAME トークン。 親ノード: CnameToken 子ノード: なし |
ExpireTime | 文字列 | Wed, 23 Feb 2022 21:16:37 GMT | CNAME トークンの有効期限が切れる時刻。 親ノード: CnameToken 子ノード: なし |
例
リクエストの例
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レスポンスの例
CNAME トークンが作成されていないか、有効期限が切れています。
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>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>mybucket</Bucket> <Cname>example.com</Cname> <Token>be1d49d863dea9ffeff3df7d6455****</Token> <ExpireTime>Wed, 23 Feb 2022 21:39:42 GMT</ExpireTime> </CnameToken>
OSS SDK
次のプログラミング言語の OSS SDK を使用して、GetCnameToken を呼び出すことができます。
ossutil
GetCnameToken 操作に対応する ossutil コマンドについては、「get-cname-token」をご参照ください。
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
InvalidArgument | 400 | クエリ対象の CNAME レコードがパラメーターリストに含まれていないか、CNAME レコードの形式が無効です。 |
CnameTokenNotFound | 404 | CNAME トークンが作成されていないか、有効期限が切れています。 |