Gunakan perintah bucket-cname untuk manage konfigurasi CNAME - Object Storage Service

Anda dapat menggunakan perintah bucket-cname untuk membuat token CNAME guna memverifikasi kepemilikan nama domain yang dipetakan ke bucket serta mengelola konfigurasi CNAME.

Catatan penggunaan

Untuk membuat token CNAME, Anda memerlukan izin oss:CreateCnameToken. Untuk menanyakan token CNAME, Anda memerlukan izin oss:GetCnameToken. Untuk menambahkan konfigurasi CNAME, Anda memerlukan izin oss:PutCname. Untuk menanyakan konfigurasi CNAME, Anda memerlukan izin oss:ListCname. Untuk menghapus konfigurasi CNAME, Anda memerlukan izin oss:DeleteCname. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.
Untuk ossutil versi 1.6.16 dan yang lebih baru, Anda dapat langsung menggunakan ossutil sebagai nama biner di baris perintah tanpa perlu memperbarui nama biner berdasarkan sistem operasi. Untuk versi ossutil sebelum 1.6.16, Anda harus memperbarui nama biner sesuai dengan sistem operasi. Untuk informasi lebih lanjut, lihat Referensi perintah ossutil.

Buat token CNAME

Catatan

Hanya ossutil versi 1.7.13 dan lebih baru yang mendukung pembuatan token CNAME.

Sintaks Perintah
```
ossutil bucket-cname --method put --item token oss://namabucket namadomain
```
Tabel berikut menjelaskan parameter-parameter di atas.
Parameter
Deskripsi
namabucket
Nama bucket tempat nama domain yang ingin Anda tambahkan catatan CNAME dipetakan.
namadomain
Nama domain kustom.
Contoh
Kode sampel berikut menunjukkan cara membuat token CNAME untuk nama domain kustom example.com yang akan dipetakan ke bucket bernama examplebucket:
```
ossutil bucket-cname --method put --item token oss://examplebucket example.com
```
Keluaran berikut akan ditampilkan:
```
<CnameToken>
 <Bucket>examplebucket</Bucket>
 <Cname>example.com</Cname>
 <Token>4db41c3ad0c4c4b690d4c17fb34e****</Token>
 <ExpireTime>Thu, 26 May 2022 19:14:12 GMT</ExpireTime>
</CnameToken>

0.270654(s) elapsed
```
Setelah token CNAME dibuat, Anda harus menambahkan catatan TXT. Untuk informasi lebih lanjut, lihat Petakan Nama Domain Kustom ke Nama Domain Default Bucket.

Tanyakan token CNAME

Sintaks Perintah

ossutil bucket-cname --method get --item token oss://namabucket  namadomain file_xml_lokal

Contoh

Kode sampel berikut menunjukkan cara menanyakan dan menampilkan token CNAME:

ossutil bucket-cname --method get --item token oss://examplebucket example.com

Keluaran berikut akan ditampilkan:

<CnameToken>
 <Bucket>examplebucket</Bucket>
 <Cname>example.com</Cname>
 <Token>fbf997e8a2d48cb2177ed25180ee****</Token>
 <ExpireTime>Thu, 26 May 2022 19:53:19 GMT</ExpireTime>
</CnameToken>

0.144356(s) elapsed

Kode sampel berikut menunjukkan cara menanyakan token CNAME dan menyimpannya dalam file lokal:

ossutil bucket-cname --method get --item token oss://examplebucket example.com local.xml

File lokal berisi konten berikut:

<CnameToken>
 <Bucket>examplebucket</Bucket>
 <Cname>example.com</Cname>
 <Token>fbf997e8a2d48cb2177ed25180ee****</Token>
 <ExpireTime>Thu, 26 May 2022 19:53:19 GMT</ExpireTime>
</CnameToken>

Tambahkan konfigurasi CNAME

Penting

Sebelum menambahkan konfigurasi CNAME, Anda harus membuat token CNAME. Untuk informasi lebih lanjut, lihat Buat Token CNAME.

Sintaks Perintah

ossutil bucket-cname --method put oss://namabucket namadomain

Contoh
Kode sampel berikut menunjukkan cara menambahkan konfigurasi CNAME ke bucket bernama examplebucket:
```
ossutil bucket-cname --method put oss://examplebucket example.com
```
Jika keluaran berikut ditampilkan, konfigurasi CNAME telah berhasil ditambahkan:
```
0.227834(s) elapsed
```

Tanyakan konfigurasi CNAME

Sintaks Perintah

ossutil bucket-cname --method get oss://namabucket file_xml_lokal

Contoh

Kode sampel berikut menunjukkan cara menanyakan dan menampilkan konfigurasi CNAME dari bucket bernama examplebucket:

ossutil bucket-cname --method get oss://examplebucket

Jika keluaran berikut ditampilkan, konfigurasi CNAME dari bucket telah berhasil ditanyakan. Keluaran ini menunjukkan bahwa nama domain example.com dan example.org dipetakan ke bucket bernama examplebucket dan nama domain tersebut diaktifkan:

<?xml version="1.0" encoding="UTF-8"?>
<ListCnameResult>
  <Bucket>examplebucket</Bucket>
  <Owner>148562088256****</Owner>
  <Cname>
    <Domain>example.com</Domain>
    <LastModified>2021-08-26T07:25:12.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
  <Cname>
    <Domain>example.org</Domain>
    <LastModified>2021-08-26T07:25:26.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
</ListCnameResult>

0.164039(s) elapsed

Kode sampel berikut menunjukkan cara menanyakan konfigurasi CNAME dari bucket bernama examplebucket dan menyimpan konfigurasi CNAME dalam file lokal:

ossutil bucket-cname --method get oss://examplebucket local.xml

Jika sertifikat SSL terkait, keluaran berikut akan ditampilkan:

<?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>
    <Certificate>
      <Type>CAS</Type>
      <CertId>927****-cn-hangzhou</CertId>
      <Status>Enabled</Status>
      <CreationDate>Mon, 27 Feb 2023 06:51:34 GMT</CreationDate>
      <Fingerprint>60:AA:C3:2C:D4:70:54:3D:02:DB:B5:AA:E7:0E:E2:B9:0B:5A:C8:CC</Fingerprint>
      <ValidStartDate>Feb 10 00:00:00 2023 GMT</ValidStartDate>
      <ValidEndDate>Feb 10 23:59:59 2024 GMT</ValidEndDate>
    </Certificate>
  </Cname>
</ListCnameResult>

Jika tidak ada sertifikat SSL yang terkait, keluaran berikut akan ditampilkan:

<?xml version="1.0" encoding="UTF-8"?>
<ListCnameResult>
  <Bucket>examplebucket</Bucket>
  <Owner>148562088256****</Owner>
  <Cname>
    <Domain>example.com</Domain>
    <LastModified>2021-08-26T07:25:12.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
  <Cname>
    <Domain>example.org</Domain>
    <LastModified>2021-08-26T07:25:26.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
</ListCnameResult>

Tambahkan catatan CNAME dan asosiasikan sertifikat SSL

Sintaks Perintah

ossutil bucket-cname --method put --item certificate oss://namabucket file_xml_lokal

Contoh

Tentukan file konfigurasi lokal.

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

Tambahkan catatan CNAME ke catatan DNS dari nama domain dan asosiasikan sertifikat SSL dengan nama domain tersebut.
```
ossutil bucket-cname --method put --item certificate oss://examplebucket local.xml
```

Hapus asosiasi sertifikat SSL

Sintaks Perintah

ossutil bucket-cname --method put --item certificate oss://namabucket file_xml_lokal

Contoh

Tentukan file konfigurasi lokal.

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

Hapus asosiasi sertifikat SSL.

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

Hapus konfigurasi CNAME

Sintaks Perintah

ossutil bucket-cname --method delete oss://namabucket namadomain

Contoh
Kode sampel berikut menunjukkan cara menghapus konfigurasi CNAME untuk bucket bernama examplebucket:
```
ossutil bucket-cname --method delete oss://examplebucket example.com
```
Jika keluaran berikut ditampilkan, konfigurasi CNAME telah berhasil dihapus:
```
0.227389(s) elapsed
```

Opsi umum

Jika Anda menggunakan ossutil untuk beralih ke bucket yang berada di wilayah lain, tambahkan opsi -e untuk menentukan titik akhir wilayah tempat bucket berada. Jika Anda menggunakan ossutil untuk beralih ke bucket milik akun Alibaba Cloud lain, tambahkan opsi -i untuk menentukan ID AccessKey dari akun tersebut, dan tambahkan opsi -k untuk menentukan rahasia AccessKey dari akun tersebut.

Sebagai contoh, Anda dapat menjalankan perintah berikut untuk menambahkan konfigurasi CNAME untuk bucket bernama testbucket yang berada di wilayah China (Hangzhou) dan dimiliki oleh akun Alibaba Cloud lain:

ossutil bucket-cname --method put oss://testbucket example.org -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Untuk informasi lebih lanjut tentang opsi umum, lihat Opsi Umum.

Parameter	Deskripsi
namabucket	Nama bucket tempat nama domain yang ingin Anda tambahkan catatan CNAME dipetakan.
namadomain	Nama domain kustom.