全部產品
Search
文件中心

Object Storage Service:GetCnameToken

更新時間:Jun 08, 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未建立或已到期。