バケットへのカスタムドメイン名のマッピング - Object Storage Service

カスタムドメイン名をバケットにマッピングします。

権限

デフォルトでは、Alibaba Cloud アカウントはすべての権限を持っています。 RAM ユーザーまたは Alibaba Cloud アカウント下の RAM ロールは、デフォルトでは権限を持っていません。 Alibaba Cloud アカウントまたはアカウント管理者は、RAM ポリシーまたはバケットポリシーを通じて操作権限を付与する必要があります。

API	アクション	定義
PutCname	oss:PutCname	カスタムドメイン名をバケットにマッピングします。
	yundun-cert:DescribeSSLCertificatePrivateKey	カスタムドメイン名をバケットにマッピングする際に、証明書が添付されている場合は、これら 3 つの権限が必要です。
	yundun-cert:DescribeSSLCertificatePublicKeyDetail
	yundun-cert:CreateSSLCertificate

コマンド構文

ossutil api put-cname --bucket value --cname-configuration value [flags]

パラメーター	タイプ	説明
--bucket	string	バケットの名前。
--cname-configuration	string	CNAME レコードを格納するコンテナ。

説明

put-cname コマンドは PutCname 操作に対応します。 PutCname 操作のパラメーターの詳細については、「PutCname」をご参照ください。

--cname-configuration

--cname-configuration 構成オプションは、XML 形式と JSON 形式の両方をサポートしています。オプションの値に file:// 接頭辞が含まれている場合、ossutil は構成ファイルから構成を読み取ります。

XML 形式:

<BucketCnameConfiguration>
  <Cname>
    <Domain>string</Domain>
  </Cname>
</BucketCnameConfiguration>

JSON 形式:

{
  "Cname": {
    "Domain": "string"
  }
}

説明

サポートされているグローバルコマンドラインオプションの詳細については、「グローバルコマンドラインオプション」をご参照ください。

例

次の例は、example.com を examplebucket という名前のバケットにマッピングする方法を示しています。

cname-configuration.xml という名前の構成ファイルを作成し、次のコードを構成ファイルに追加します。

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

サンプルコマンド:

ossutil api put-cname --bucket examplebucket --cname-configuration file://cname-configuration.xml

cname-configuration.json という名前の構成ファイルを作成し、次のコードを構成ファイルに追加します。
```
{
  "Cname": {
    "Domain": "example.com"
  }
}
```
サンプルコマンド:
```
ossutil api put-cname --bucket examplebucket --cname-configuration file://cname-configuration.json
```

次のコマンドのパラメーターを JSON 形式で構成します。

ossutil api put-cname --bucket examplebucket --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}"

次の例は、examplebucket に証明書をバインドする方法を示しています。

cname-configuration.xml という名前の構成ファイルを作成し、次のコードを追加します。

<?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 RSA PRIVATE KEY-----\nMIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC****\n-----END RSA PRIVATE KEY-----</PrivateKey>
      <PreviousCertId>493****-cn-hangzhou</PreviousCertId>
      <Force>true</Force>
    </CertificateConfiguration>
  </Cname>
</BucketCnameConfiguration>

サンプルコマンド:

ossutil api put-cname --bucket examplebucket --cname-configuration file://cname-configuration.xml

cname-configuration.json という名前の構成ファイルを作成し、次のコードを追加します。

{
    "Cname": {
        "Domain": "example.com",
        "CertificateConfiguration": {
            "CertId": "493****-cn-hangzhou",
            "Certificate": "-----BEGIN CERTIFICATE-----\nMIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC****\n-----END CERTIFICATE-----",
            "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC****\n-----END RSA PRIVATE KEY-----",
            "PreviousCertId": "493****-cn-hangzhou",
            "Force": true
        }
    }
}

サンプルコマンド:

ossutil api put-cname --bucket examplebucket --cname-configuration file://cname-configuration.json