GetCnameToken

请求语法

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

响应元素

示例

• 请求示例

  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>

SDK

本接口对应的各语言SDK如下：

• Java

• Python

• Go V2

• Node.js

• PHP

命令行工具ossutil

GetCnameToken接口所对应的ossutil命令，请参见get-cname-token。

错误码