Object Storage Service:GetCnameToken

Request syntax

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

Request headers

The request headers involved in this API operation include only common request headers. For more information, see Common request headers.

Response parameters

All headers in the response to a GetCnameToken request are common response headers. For more information, see Common HTTP headers.

Response elements

Examples

• Sample request

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

• Sample responses

  • The CNAME token is not created or has expired.

    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>

  • The CNAME token is found.

    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>

Error codes