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