CreateCnameToken - Object Storage Service

調用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。