调用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 qn6qrrqxo2oawuk53otf****:KU5h8YMUC78M30dXqf3JxrTZ****

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