為某個儲存空間Bucket綁定自訂網域名 - Object Storage Service

put-cname用於為某個儲存空間（Bucket）綁定自訂網域名。

許可權說明

阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權，需要阿里雲帳號或帳號管理員通過RAM Policy或Bucket Policy授予操作許可權。

API	Action	說明
PutCname	oss:PutCname	為Bucket綁定自訂網域名。
	yundun-cert:DescribeSSLCertificatePrivateKey	為Bucket綁定自訂網域名時，如果綁定認證，則需要這三個操作的許可權。
	yundun-cert:DescribeSSLCertificatePublicKeyDetail
	yundun-cert:CreateSSLCertificate

命令格式

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

參數	類型	說明
--bucket	string	Bucket名稱。
--cname-configuration	string	Cname配置的容器。

說明

put-cname命令對應API介面PutCname。關於API中的具體參數含義，請參見PutCname。

--cname-configuration

--cname-configuration配置選項既支援XML文法也支援JSON文法，當選項值包含file://首碼時，表示從檔案中讀取配置。

XML文法：

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

JSON文法：

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

說明

關於支援的全域命令列選項，請參見支援的全域命令列選項。

使用樣本

為儲存空間examplebucket綁定自訂網域名example.com。

使用XML設定檔，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

使用JSON設定檔，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綁定認證。

使用XML設定檔，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

使用JSON設定檔，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