调用CreateCnameToken接口创建域名所有权验证所需的CnameToken

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