Memetakan nama domain kustom ke bucket - Object Storage Service

Memetakan nama domain kustom ke bucket.

Permissions

Secara default, Akun Alibaba Cloud memiliki izin penuh. Pengguna RAM atau Peran RAM di bawah Akun Alibaba Cloud tidak memiliki izin apa pun secara default. Akun Alibaba Cloud atau administrator akun harus memberikan izin operasi melalui kebijakan RAM atau Bucket Policy.

API	Action	Description
PutCname	oss:PutCname	Memetakan nama domain kustom ke bucket.
	yundun-cert:DescribeSSLCertificatePrivateKey	Saat memetakan nama domain kustom ke bucket, jika sertifikat disambungkan, ketiga izin ini diperlukan.
	yundun-cert:DescribeSSLCertificatePublicKeyDetail
	yundun-cert:CreateSSLCertificate

Command syntax

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

Parameter	Type	Description
--bucket	string	Nama bucket.
--cname-configuration	string	Kontainer konfigurasi CNAME.

Opsi --cname-configuration menerima format XML dan JSON. Jika nilainya diawali dengan file://, konfigurasi dibaca dari file.

Sintaksis XML:

<BucketCnameConfiguration>
  <Cname>
    <Domain>string</Domain>
    <IsWildCard>bool</IsWildCard>
  </Cname>
</BucketCnameConfiguration>

Sintaksis JSON:

{
  "Cname": {
    "Domain": "string",
    "IsWildCard": boolean
  }
}

Catatan

Perintah put-cname tidak menggunakan opsi --wildcard. Sebagai gantinya, jenis CNAME dideklarasikan melalui elemen IsWildCard dalam --cname-configuration. Nilai IsWildCard diatur sebagai true atau false: true menunjukkan CNAME domain wildcard (nilai Domain berupa domain dasar tanpa awalan *.), sedangkan false menunjukkan CNAME eksak.
Hanya Bucket Agentic yang mendukung CNAME domain wildcard. Saat menyambungkan CNAME (eksak atau wildcard) ke Bucket Agentic, Anda harus secara eksplisit mengonfigurasi elemen IsWildCard—elemen ini tidak boleh dikosongkan atau dihilangkan. Bucket Standar tidak memerlukan elemen tersebut. Pastikan versi ossutil yang digunakan mendukung elemen IsWildCard.
Perintah put-cname sesuai dengan Operasi API PutCname. Untuk informasi lebih lanjut tentang parameter, lihat PutCname. Untuk informasi lebih lanjut tentang opsi baris perintah global yang didukung, lihat Global command-line options.

Examples

1. Petakan nama domain kustom example.com ke bucket examplebucket.

Gunakan file konfigurasi XML. Konten cname-configuration.xml adalah sebagai berikut:

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

Contoh perintah:

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

Gunakan file konfigurasi JSON. Konten cname-configuration.json adalah sebagai berikut:

{
  "Cname": {
    "Domain": "example.com"
  }
}

Contoh perintah:

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

Gunakan parameter konfigurasi JSON langsung. Contoh perintah:

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

2. Sambungkan sertifikat ke bucket examplebucket.

Gunakan file konfigurasi XML. Konten cname-configuration.xml adalah sebagai berikut:

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

Contoh perintah:

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

Gunakan file konfigurasi JSON. Konten cname-configuration.json adalah sebagai berikut:

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

Contoh perintah:

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

3. Petakan CNAME wildcard untuk domain example.com, lengkap dengan sertifikat, ke Bucket Agentic myab-$uid-$region-ab-apsr.

Gunakan file konfigurasi XML. Konten cname-configuration.xml adalah sebagai berikut:

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

Contoh perintah:

ossutil api put-cname --bucket my-uid-region-ab-apsr --cname-configuration file://cname-configuration.xml

Gunakan parameter konfigurasi JSON langsung. Contoh perintah:

ossutil api put-cname --bucket my-uid-region-ab-apsr --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\",\"IsWildCard\":true}}"