文档

CreateCnameToken

更新时间:

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