すべてのプロダクト
Search

このプロダクト

    Object Storage Service:bucket-cname

    ドキュメントセンター

    Object Storage Service:bucket-cname

    最終更新日:Dec 20, 2023

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

    重要

    このトピックのサンプルコマンドラインは、64ビットLinuxシステムに基づいています。 他のシステムの場合は、を交換します。対応するバイナリ名を持つコマンドの /ossutil64。 詳細については、「ossutilの使用を開始する」をご参照ください。

    CNAMEトークンの作成

    説明 CNAMEトークンの作成に使用できるのは、ossutil 1.7.13以降だけです。
    • コマンド構文 
      /ossutil64 bucket-cname -- メソッドput -- itemトークンoss:// bucketname domainname

      次の表に、コマンド構文のパラメーターを示します。

      パラメーター説明
      bucketnameCNAMEレコードがマップされるバケットの名前。
      ドメイン名カスタムドメイン名。
    • 例：

      次のコードでは、examplebucketという名前のバケットにマップするカスタムドメインnam e example.comのCNAMEトークンを作成する方法の例を示します。 

      . /ossutil64 bucket-cname -- method put -- item token 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 token 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トークンを表示し、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

        次の出力が表示される場合、バケットのCNAME設定が取得されます。 次の出力は、d example.org s example.comドメイン名が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

        ドメイン名を証明書にバインドすると、次の出力が表示されます。

        <?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>

        ドメイン名を証明書にバインドしない場合、次の出力が表示されます。

        <?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レコードをドメイン名に追加し、証明書をドメイン名にバインドします。

    • コマンド構文 
      /ossutil64 bucket-cname -- method put -- item certificate oss:// bucketname local_xml_file
    • 例
      1. ローカル設定ファイルを指定します。 
        <?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>
      2. CNAMEレコードをドメイン名に追加し、証明書をドメイン名にバインドします。 
        . /ossutil64 bucket-cname -- method put -- item certificate oss:// examplebucket local.xml

    証明書からドメイン名のバインド解除

    • コマンド構文 
      /ossutil64 bucket-cname -- method put -- item certificate oss:// bucketname local_xml_file
    • 例
      1. ローカル設定ファイルを指定します。 
        <?xml version="1.0" encoding="UTF-8"?>
<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
    <CertificateConfiguration>
      <DeleteCertificate>True</DeleteCertificate>
    </CertificateConfiguration>
  </Cname>
</BucketCnameConfiguration>
      2. 証明書からドメイン名のバインドを解除します。 
        . /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シークレットを指定します。

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

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

    同期コマンドに使用できるその他の一般的なオプションの詳細については、「オプションの表示」をご参照ください。