调用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未创建或已过期。 |