すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:GetCnameToken

最終更新日:Jun 10, 2025

作成された 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 トークンが作成されていないか、有効期限が切れています。