bucket-cname コマンドを実行して CNAME トークンと CNAME の構成を管理する方法 - Object Storage Service

bucket-cname コマンドを実行して、バケットにマッピングされたドメイン名の所有権を確認し、CNAME の構成を管理するために使用される CNAME トークンを作成できます。

使用上の注意

CNAME トークンを作成するには、oss:CreateCnameToken 権限が必要です。 CNAME トークンを照会するには、oss:GetCnameToken 権限が必要です。 CNAME の構成を追加するには、oss:PutCname 権限が必要です。 CNAME の構成を照会するには、oss:ListCname 権限が必要です。 CNAME の構成を削除するには、oss:DeleteCname 権限が必要です。詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。
ossutil 1.6.16 以降では、コマンドラインでバイナリ名として ossutil を直接使用できます。オペレーティングシステムに基づいてバイナリ名を更新する必要はありません。 ossutil 1.6.16 より前のバージョンでは、オペレーティングシステムに基づいてバイナリ名を更新する必要があります。詳細については、「ossutil コマンドリファレンス」をご参照ください。

CNAME トークンの作成

説明

CNAME トークンの作成には、ossutil 1.7.13 以降のみを使用できます。

コマンド構文
```
ossutil bucket-cname --method put --item token oss://bucketname domainname
```
次の表は、上記のパラメーターについて説明しています。
パラメーター
説明
bucketname
CNAME レコードを追加するドメイン名がマッピングされるバケットの名前。
domainname
カスタムドメイン名。
例
次のサンプルコードは、examplebucket という名前のバケットにマッピングされるカスタムドメイン名 example.com の CNAME トークンを作成する方法の例を示しています。
```
ossutil bucket-cname --method put --item token oss://examplebucket example.com
```
次の出力が表示されます。
```
<CnameToken>
 <Bucket>examplebucket</Bucket>
 <Cname>example.com</Cname>
 <Token>4db41c3ad0c4c4b690d4c17fb34e****</Token>
 <ExpireTime>Thu, 26 May 2022 19:14:12 GMT</ExpireTime>
</CnameToken>

0.270654(s) elapsed
```
CNAME トークンを作成した後、TXT レコードを追加する必要があります。詳細については、「カスタムドメイン名をバケットのデフォルトドメイン名にマッピングする」をご参照ください。

CNAME トークンの照会

コマンド構文

ossutil bucket-cname --method get --item token oss://bucketname  domainname local_xml_file

例

次のサンプルコードは、CNAME トークンを照会して表示する方法の例を示しています。

ossutil bucket-cname --method get --item token oss://examplebucket example.com

次の出力が表示されます。

<CnameToken>
 <Bucket>examplebucket</Bucket>
 <Cname>example.com</Cname>
 <Token>fbf997e8a2d48cb2177ed25180ee****</Token>
 <ExpireTime>Thu, 26 May 2022 19:53:19 GMT</ExpireTime>
</CnameToken>

0.144356(s) elapsed

次のサンプルコードは、CNAME トークンを照会してローカルファイルに保存する方法の例を示しています。

ossutil bucket-cname --method get --item token oss://examplebucket example.com local.xml

ローカルファイルには、次のコンテンツが含まれています。

<CnameToken>
 <Bucket>examplebucket</Bucket>
 <Cname>example.com</Cname>
 <Token>fbf997e8a2d48cb2177ed25180ee****</Token>
 <ExpireTime>Thu, 26 May 2022 19:53:19 GMT</ExpireTime>
</CnameToken>

CNAME 構成の追加

重要

CNAME 構成を追加する前に、CNAME トークンを作成する必要があります。詳細については、「CNAME トークンの作成」をご参照ください。

コマンド構文

ossutil bucket-cname --method put oss://bucketname domainname

例
次のサンプルコードは、examplebucket という名前のバケットに CNAME 構成を追加する方法の例を示しています。
```
ossutil bucket-cname --method put oss://examplebucket example.com
```
次の出力が表示された場合、CNAME 構成が追加されています。
```
0.227834(s) elapsed
```

CNAME 構成の照会

コマンド構文

ossutil bucket-cname --method get oss://bucketname local_xml_file

例

次のサンプルコードは、examplebucket という名前のバケットの CNAME 構成を照会して表示する方法の例を示しています。

ossutil bucket-cname --method get oss://examplebucket

次の出力が表示された場合、バケットの CNAME 構成が照会されています。次の出カは、ドメイン名 example.com と example.org が examplebucket という名前のバケットにマッピングされており、これらのドメイン名が有効になっていることを示しています。

<?xml version="1.0" encoding="UTF-8"?>
<ListCnameResult>
  <Bucket>examplebucket</Bucket>
  <Owner>148562088256****</Owner>
  <Cname>
    <Domain>example.com</Domain>
    <LastModified>2021-08-26T07:25:12.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
  <Cname>
    <Domain>example.org</Domain>
    <LastModified>2021-08-26T07:25:26.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
</ListCnameResult>

0.164039(s) elapsed

次のサンプルコードは、examplebucket という名前のバケットの CNAME 構成を照会し、CNAME 構成をローカルファイルに保存する方法の例を示しています。

ossutil bucket-cname --method get oss://examplebucket local.xml

SSL 証明書が関連付けられている場合、次の出力が表示されます。

<?xml version="1.0" encoding="UTF-8"?>
<ListCnameResult>
  <Bucket>examplebucket</Bucket>
  <Owner>1506925210***</Owner>
  <Cname>
    <Domain>example.com</Domain>
    <LastModified>2023-02-27T10:38:13.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>false</IsPurgeCdnCache>
    <Certificate>
      <Type>CAS</Type>
      <CertId>927****-cn-hangzhou</CertId>
      <Status>Enabled</Status>
      <CreationDate>Mon, 27 Feb 2023 06:51:34 GMT</CreationDate>
      <Fingerprint>60:AA:C3:2C:D4:70:54:3D:02:DB:B5:AA:E7:0E:E2:B9:0B:5A:C8:CC</Fingerprint>
      <ValidStartDate>Feb 10 00:00:00 2023 GMT</ValidStartDate>
      <ValidEndDate>Feb 10 23:59:59 2024 GMT</ValidEndDate>
    </Certificate>
  </Cname>
</ListCnameResult>

SSL 証明書が関連付けられていない場合、次の出力が表示されます。

<?xml version="1.0" encoding="UTF-8"?>
<ListCnameResult>
  <Bucket>examplebucket</Bucket>
  <Owner>148562088256****</Owner>
  <Cname>
    <Domain>example.com</Domain>
    <LastModified>2021-08-26T07:25:12.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
  <Cname>
    <Domain>example.org</Domain>
    <LastModified>2021-08-26T07:25:26.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
</ListCnameResult>

CNAME レコードを追加し、SSL 証明書を関連付ける

コマンド構文

ossutil bucket-cname --method put --item certificate oss://bucketname local_xml_file

例

ローカル構成ファイルを指定します。

<?xml version="1.0" encoding="UTF-8"?>
<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
    <CertificateConfiguration>
      <CertId>493****-cn-hangzhou</CertId>
      <Certificate>-----BEGIN CERTIFICATE----- MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC **** -----END CERTIFICATE-----</Certificate>
      <PrivateKey>-----BEGIN CERTIFICATE----- MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC **** -----END CERTIFICATE-----</PrivateKey>
      <PreviousCertId>493****-cn-hangzhou</PreviousCertId>
      <Force>true</Force>
    </CertificateConfiguration>
  </Cname>
</BucketCnameConfiguration>

ドメイン名の DNS レコードに CNAME レコードを追加し、SSL 証明書をドメイン名に関連付けます。
```
ossutil bucket-cname --method put --item certificate oss://examplebucket local.xml
```

SSL 証明書の関連付けを解除する

コマンド構文

ossutil bucket-cname --method put --item certificate oss://bucketname local_xml_file

例

ローカル構成ファイルを指定します。

<?xml version="1.0" encoding="UTF-8"?>
<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
    <CertificateConfiguration>
      <DeleteCertificate>True</DeleteCertificate>
    </CertificateConfiguration>
  </Cname>
</BucketCnameConfiguration>

SSL 証明書の関連付けを解除します。

ossutil bucket-cname --method put --item certificate oss://examplebucket local.xml

CNAME 構成の削除

コマンド構文

ossutil bucket-cname --method delete oss://bucketname domainname

例
次のサンプルコードは、examplebucket という名前のバケットの CNAME 構成を削除する方法の例を示しています。
```
ossutil bucket-cname --method delete oss://examplebucket example.com
```
次の出力が表示された場合、CNAME 構成が削除されています。
```
0.227389(s) elapsed
```

共通オプション

ossutil を使用して別のリージョンにあるバケットに切り替える場合は、-e オプションを追加して、バケットがあるリージョンのエンドポイントを指定します。 ossutil を使用して別の Alibaba Cloud アカウントに属するバケットに切り替える場合は、-i オプションを追加して、指定したアカウントの AccessKey ID を指定し、-k オプションを追加して、指定したアカウントの AccessKey シークレットを指定します。

たとえば、次のコマンドを実行して、中国 (杭州) リージョンにあり、別の Alibaba Cloud アカウントに属する testbucket という名前のバケットの CNAME 構成を追加できます。

ossutil bucket-cname --method put oss://testbucket example.org -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

共通オプションの詳細については、「共通オプション」をご参照ください。

パラメーター	説明
bucketname	CNAME レコードを追加するドメイン名がマッピングされるバケットの名前。
domainname	カスタムドメイン名。