ListCname - Object Storage Service - Alibaba Cloud ドキュメントセンター

バケットにマップされているすべてのCNAMEレコードを照会します。

リクエスト構文

GET /?cname HTTP/1.1
ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
コンテンツ-長さ: 186
日付: 火曜日、5月11日2022 11:39:12 GMT
権限付与: OSS qn6qrrqxo2oawuk53otf ****:KU5h8YMUC78M30dXqf3JxrTZ ****

リクエストヘッダー

このAPI操作に含まれるリクエストヘッダーには、共通のリクエストヘッダーのみが含まれます。詳細については、「共通リクエストヘッダー」をご参照ください。

レスポンスヘッダー

このリクエストには、共通のレスポンスヘッダーのみが含まれます。詳細については、「共通HTTPヘッダー」をご参照ください。

レスポンス要素

要素	データ型	例	説明
ListCnameResult	Container	N/A	すべてのCNAMEレコードに関する情報のクエリに使用されるコンテナー。親ノード: なし子ノード: Bucket、Owner、Cname
バケット	String	examplebucket	クエリするCNAMEレコードがマップされているバケットの名前。親ノード: ListCnameResult 子ノード: なし
Owner	String	testowner	バケット所有者の名前。親ノード: ListCnameResult 子ノード: なし
Cname	Container	N/A	すべてのCNAMEレコードに関する情報を格納するために使用されるコンテナー。親ノード: ListCnameResult 子ノード: ドメイン、LastModified、ステータス、および証明書
ドメイン	String	example.com	カスタムドメイン名。親ノード: Cname 子ノード: なし
Lastmodified	String	2021-09-15T02:35:07.000Z	カスタムドメイン名がマップされた時刻。親ノード: Cname 子ノード: なし
Status	String	Enabled	ドメイン名のステータス。有効な値： Enabled:: ドメイン名が有効です。無効: ドメイン名は無効です。親ノード: Cname 子ノード: なし
証明書	Container	N/A	証明書情報が格納されているコンテナ。親ノード: Cname 子ノード: Type、CertId、Status、CreationDate、Fingerprint、ValidStartDate、およびValidEndDate
データ型	String	CAS	証明書のソース。有効な値： CAS: SSL証明書サービスを使用して取得される証明書。 Upload: ユーザーが以前のバージョンの証明書ホスティングサービスにアップロードした証明書。親ノード: 証明書子ノード: なし
CertId	String	493 ****-cn-hangzhou	証明書の ID 。親ノード: 証明書子ノード: なし
Status	String	Enabled	証明書のステータス。有効な値：有効: 証明書が使用されています。無効: 証明書は使用されません。親ノード: 証明書子ノード: なし
CreationDate	String	9月15日水曜日2021 02:35:06 GMT	証明書がバインドされた時刻。親ノード: 証明書子ノード: なし
Fingerprint	String	DE:01:CF:EC:7C:A7:98:CB:D8:6E:FB:1D:97:EB:A9:64:1D:4E:**	証明書の署名。親ノード: 証明書子ノード: なし
ValidStartDate	String	4月12日水曜日2023 10:14:51 GMT	証明書が有効になる時刻。親ノード: 証明書子ノード: なし
ValidEndDate	String	5月4日月曜日2048 10:14:51 GMT	証明書の有効期限が切れる時刻。親ノード: 証明書子ノード: なし

例

GET /?cname HTTP/1.1のサンプルリクエスト


ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
コンテンツ-長さ: 186
日付: 火曜日、5月11日2022 11:39:12 GMT
権限付与: OSS qn6qrrqxo2oawuk53otf ****:KU5h8YMUC78M30dXqf3JxrTZ ****

サンプル応答

の内容-長さ: 1855
x-oss-console-auth: 成功
server: AliyunOSS
x-oss-server-time: 7
接続: キープアライブ
x-oss-request-id: 614169F1AE63BD37355CA12B
日付: 火曜日、5月11日2022 11:39:12 GMT
content-type: application/xml
<?xml version="1.0" encoding="UTF-8"?>
<ListCnameResult>
  <Bucket>targetbucket</Bucket>
  <Owner>testowner</Owner>
  <Cname>
    <Domain>example.com</Domain>
    <LastModified>2021-09-15T02:35:07.000Z</LastModified>
    <Status>Enabled</Status>
    <証明書>
      <タイプ> CAS</タイプ>
      <CertId>493 ****-cn-hangzhou</CertId>
      <Status>Enabled</Status>
      <CreationDate> 9月15日水曜日2021 02:35:06 GMT</CreationDate>
      <指紋> DE:01:CF:EC:7C:A7:98:CB:D8:6E:FB:1D:97:EB:A9:64:1D:4E:**</指紋>
      <ValidStartDate> 4月12日水曜日10:14:51 GMT 2023 </ValidStartDate>
      <ValidEndDate> 5月4日月曜日2048 10:14:51 GMT</ValidEndDate>
    </証明書>
  </Cname>
  <Cname>
    <Domai n>example.org</ドメイン>
    <LastModified>2021-09-15T02:34:58.000Z</LastModified>
    <Status>Enabled</Status>
  </Cname>
  <Cname>
    <Domai n>example.edu</ドメイン>
    <LastModified>2021-09-15T02:50:34.000Z</LastModified>
    <Status>Enabled</Status>
  </Cname>
</ListCnameResult>

エラーコード

エラーコード	HTTPステータスコード	説明
AccessDenied	403	ListCname操作を呼び出す権限がない場合に返されるエラーメッセージ。 `oss:ListCname`権限が付与されているバケット所有者とRAMユーザーのみが、バケットにマップされているすべてのCNAMEレコードを照会できます。
NoSuchCname	404	CNAMEレコードがバケットにマップされていない場合に返されるエラーメッセージ。