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ユーザーへのカスタムポリシーのアタッチ」をご参照ください。
このトピックでは、64ビットLinuxシステムに基づくサンプルコマンドラインを提供します。他のシステムのために、取り替えて下さい./ossutil64対応するバイナリ名を持つコマンドで詳細は、「ossutilコマンドリファレンス」をご参照ください。

CNAMEトークンの作成

説明

CNAMEトークンの作成に使用できるのは、ossutil 1.7.13以降だけです。

コマンド構文
```
./ossutil64 bucket-cname -- メソッドput -- itemトークンoss:// bucketname domainname
```
次の表に、上記のコマンドのパラメーターを示します。
パラメーター
説明
bucketname
CNAMEレコードを追加するドメイン名がマップするバケットの名前。
ドメイン名
カスタムドメイン名。
例
次のサンプルコードは、examplebucketという名前のバケットにマップするカスタムドメインnam e example.comのCNAMEトークンを作成する方法の例を示しています。
```
./ossutil64 bucket-cname -- メソッドput -- itemトークンoss:// examplebucke t example.com
```
次の出力が返されます。
```
<CnameToken>
 <Bucket>examplebucket</Bucket>
 <Cnam e>example.com</Cname>
 <トークン> 4db41c3ad0c4c4b690d4c17fb34e ****</Token>
 <ExpireTime> 5月2022日木曜日19:14:12 GMT</ExpireTime>
</CnameToken>

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

CNAMEトークンの照会

コマンド構文

./ossutil64 bucket-cname -- method get -- itemトークンoss:// bucketname domainname local_xml_file

例

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

./ossutil64 bucket-cname -- method get -- itemトークンoss:// examplebucke t example.com

次の出力が返されます。

<CnameToken>
 <Bucket>examplebucket</Bucket>
 <Cnam e>example.com</Cname>
 <トークン> fbf997e8a2d48cb2177ed25180ee ****</Token>
 <ExpireTime> 5月26日木曜日2022 19:53:19 GMT</ExpireTime>
</CnameToken>

0.144356経過

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

./ossutil64 bucket-cname -- method get -- item token oss:// local.xml t example.comのexamplebucke

ローカルファイルには次の内容が含まれています。

<CnameToken>
 <Bucket>examplebucket</Bucket>
 <Cnam e>example.com</Cname>
 <トークン> fbf997e8a2d48cb2177ed25180ee ****</Token>
 <ExpireTime> 5月26日木曜日2022 19:53:19 GMT</ExpireTime>
</CnameToken>

CNAME設定の追加

重要

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

コマンド構文

./ossutil64 bucket-cname -- メソッドput oss:// bucketname domainname

例
次のサンプルコードは、examplebucketという名前のバケットにCNAME設定を追加する方法の例を示しています。
```
./ossutil64 bucket-cname -- メソッドput oss:// examplebucke t example.com
```
次の出力が表示される場合、CNAME設定が追加されます。
```
0.227834経過
```

CNAME設定のクエリ

コマンド構文

./ossutil64 bucket-cname -- メソッドget oss:// bucketname local_xml_file

例

次のサンプルコードは、examplebucketという名前のバケットのCNAME設定をクエリして表示する方法の例を示しています。

./ossutil64 bucket-cname -- メソッドget oss:// examplebucket

次の出力は、ドメイン名s example.com d example.orgがexamplebucketという名前のバケットにマップされ、これらのドメイン名が有効になっていることを示しています。

<?xml version="1.0" encoding="UTF-8"?>
<ListCnameResult>
  <Bucket>examplebucket</Bucket>
  <所有者> 148562088256 ****</所有者>
  <Cname>
    <Domain>example.com</Domain>
    <LastModified>2021-08-26T07:25:12.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
  <Cname>
    <Domai n>example.org</ドメイン>
    <LastModified>2021-08-26T07:25:26.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
</ListCnameResult>

0.164039経過

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

./ossutil64 bucket-cname -- メソッド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>
    <証明書>
      <タイプ> CAS</タイプ>
      <CertId>927 ****-cn-hangzhou</CertId>
      <Status>Enabled</Status>
      <CreationDate> 2月27日月曜日2023 06:51:34 GMT</CreationDate>
      <指紋> 60:AA:C3:2C:D4:70:54:3D:02:DB:B5:AA:E7:0E:E2:B9:0B:5A:C8:CC</指紋>
      <ValidStartDate> 2月10日00:00:00 2023 GMT</ValidStartDate>
      <ValidEndDate> 2月10日23:59:59 2024 GMT</ValidEndDate>
    </証明書>
  </Cname>
</ListCnameResult>

SSL証明書がホストされていない場合、次の出力が表示されます。

<?xml version="1.0" encoding="UTF-8"?>
<ListCnameResult>
  <Bucket>examplebucket</Bucket>
  <所有者> 148562088256 ****</所有者>
  <Cname>
    <Domain>example.com</Domain>
    <LastModified>2021-08-26T07:25:12.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
  <Cname>
    <Domai n>example.org</ドメイン>
    <LastModified>2021-08-26T07:25:26.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
</ListCnameResult>

CNAMEレコードをドメイン名のDNSレコードに追加し、SSL証明書をホストする

コマンド構文

./ossutil64 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>
      <証明書> ----- 認証を開始 ----- MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC **** ----- 認証を終了 -----</証明書>
      <PrivateKey>----- CERTIFICATEを開始 ----- MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC **** ----- CERTIFICATEを終了 -----</PrivateKey>
      <PreviousCertId>493 ****-cn-hangzhou</PreviousCertId>
      <Force>true</Force>
    </CertificateConfiguration>
  </Cname>
</BucketCnameConfiguration>

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

SSL証明書の関連付け解除

コマンド構文

./ossutil64 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証明書の関連付けを解除します。

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

CNAME設定の削除

コマンド構文

./ossutil64 bucket-cname -- メソッドdelete oss:// bucketname domainname

例
次のサンプルコードは、examplebucketという名前のバケットのCNAME設定を削除する方法の例を示しています。
```
./ossutil64 bucket-cname -- メソッドdelete oss:// examplebucke t example.com
```
次の出力が表示された場合、CNAME設定は削除されます。
```
0.227389経過
```

一般的なオプション

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

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

./ossutil64 bucket-cname -- メソッドput oss:// testbucke t example.org -e oss-cn-hangzhou.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA **** -k 67DLVBkH7EamOjy2W5RVAHUY9H ****

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

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