调用GetCnameToken接口获取已创建的CnameToken。

请求语法

GET /?comp=token&cname=example.com 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)

响应头

此接口仅包含公共响应头。更多信息,请参见公共响应头(Common Response Headers)

响应元素

名称 类型 示例值 描述
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

子节点:无

示例

  • 请求示例
    GET /?comp=token&cname=example.com 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****
  • 返回示例
    • CnameToken未创建或已过期
      HTTP/1.1 404 Not Found
      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>CnameTokenNotFound</Code>
        <Message>Cname token not found.</Message>
        <RequestId>6215FE05DA0E27393F005F0E</RequestId>
        <HostId>127.0.0.1</HostId>
        <Bucket>mybucket</Bucket>
        <Cname>example.com</Cname>;
      </Error>
    • 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>mybucket</Bucket>
        <Cname>example.com</Cname>;
        <Token>be1d49d863dea9ffeff3df7d6455****</Token>
        <ExpireTime>Wed, 23 Feb 2022 21:39:42 GMT</ExpireTime>
      </CnameToken>

错误码

错误码 HTTP状态码 描述
InvalidArgument 400 参数列表中未提供要查询的Cname或Cname格式错误。
CnameTokenNotFound 404 CnameToken未创建或已过期。