全部產品
Search
文件中心

Object Storage Service:CreateCnameToken

更新時間:Jun 08, 2024

調用CreateCnameToken介面建立網域名稱所有權驗證所需的CnameToken。

說明

CnameToken預設在建立完成後72小時內到期。如果在CnameToken到期時間內重複建立CnameToken,則返回已存在的CnameToken。

請求文法

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

要求標頭

此介面僅包含公用要求標頭。更多資訊,請參見公用要求標頭(Common Request Headers)

請求元素

名稱

類型

是否必選

樣本值

描述

BucketCnameConfiguration

容器

不涉及

Cname配置的容器。

父節點:無

子節點:Cname

Cname

容器

不涉及

Cname資訊的容器。

父節點:BucketCnameConfiguration

子節點:Domain

Domain

字串

example.com

自訂網域名。

父節點:Cname

子節點:無

響應元素

名稱

類型

樣本值

描述

CnameToken

容器

不涉及

CnameToken的容器。

父節點:無

子節點:Bucket、Cname、Token和ExpireTime

Bucket

字串

examplebucket

綁定Cname的Bucket名稱。

父節點:CnameToken

子節點:無

Cname

字串

example.com

綁定的Cname名稱。

父節點:CnameToken

子節點:無

Token

字串

be1d49d863dea9ffeff3df7d6455****

OSS返回的CnameToken。

父節點:CnameToken

子節點:無

ExpireTime

字串

Wed, 23 Feb 2022 21:16:37 GMT

CnameToken的到期時間。

父節點: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>
  • 返回樣本

    • CnameToken建立成功

      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>
    • CnameToken數量超出限制

      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>

錯誤碼

錯誤碼

HTTP狀態代碼

描述

TooManyCnameToken

400

同一個Bucket建立的Token數量超過最大允許數量1000個的限制。

NoNeedCreateCnameToken

403

Cname已生效,無需為該Bucket繼續建立Token。