全部产品
Search
文档中心

对象存储 OSS:GetCnameToken

更新时间:Apr 29, 2024

调用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 qn6q**************:77Dv****************
  • 返回示例

    • 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>
        <EC>0018-00000301</EC>
      </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未创建或已过期。