Gunakan Alibaba Cloud CLI untuk memanggil operasi API dari Certificate Management Service - Certificate Management Service

Topik ini menjelaskan cara menggunakan Alibaba Cloud CLI untuk memanggil operasi API dari Certificate Management Service (Original SSL Certificate). Operasi ListDeploymentJob digunakan sebagai contoh untuk mendapatkan daftar tugas penyebaran.

Sebelum memulai

Alibaba Cloud CLI adalah alat baris perintah serbaguna yang dikembangkan berdasarkan Spesifikasi OpenAPI. Anda dapat menggunakan Alibaba Cloud CLI untuk menerapkan manajemen dan pemeliharaan otomatis sumber daya Certificate Management Service. Untuk informasi lebih lanjut, lihat Apa itu Alibaba Cloud CLI?

Langkah 1: Instal Alibaba Cloud CLI

Sebelum menggunakan Alibaba Cloud CLI, Anda harus menginstalnya. Anda dapat menginstal Alibaba Cloud CLI pada sistem operasi Windows, Linux, dan macOS sesuai dengan sistem operasi perangkat Anda. Untuk informasi lebih lanjut, lihat topik-topik berikut:

Sistem operasi Windows: Instal Alibaba Cloud CLI di Windows
Sistem operasi Linux: Instal Alibaba Cloud CLI di Linux
Sistem operasi macOS: Instal Alibaba Cloud CLI di macOS

Alibaba Cloud CLI terintegrasi dalam Cloud Shell, yang secara berkala memperbarui versi perangkat lunak. Anda juga dapat menggunakan Cloud Shell untuk men-debug perintah yang ingin Anda jalankan di Alibaba Cloud CLI. Untuk informasi lebih lanjut, lihat Apa itu Cloud Shell?

Langkah 2: Konfigurasi Alibaba Cloud CLI

Penting

Akun Alibaba Cloud memiliki izin untuk mengelola dan mengakses API semua layanan Alibaba Cloud. Jika Anda menggunakan akun Alibaba Cloud untuk memanggil operasi API, risiko keamanan mungkin timbul. Kami merekomendasikan agar Anda membuat Pengguna Resource Access Management (RAM), memberikan izin yang diperlukan kepada pengguna RAM berdasarkan prinsip hak istimewa minimal, dan kemudian menggunakan pengguna RAM untuk memanggil operasi API. Untuk informasi lebih lanjut tentang kebijakan yang didukung oleh Certificate Management Service, lihat Kebijakan sistem untuk Certificate Management Service.

Sebelum menggunakan Alibaba Cloud CLI, Anda harus mengonfigurasi informasi seperti kredensial identitas dan ID wilayah di Alibaba Cloud CLI. Alibaba Cloud CLI mendukung berbagai jenis kredensial identitas. Untuk informasi lebih lanjut, lihat Jenis-jenis kredensial. Alibaba Cloud CLI memungkinkan Anda menggunakan AccessKey pair dari pengguna RAM untuk mengonfigurasi kredensial identitas. Jika Anda ingin menggunakan pasangan AccessKey dari pengguna RAM, lakukan langkah-langkah berikut:

Buat pengguna RAM dan buat pasangan AccessKey untuk pengguna RAM untuk mengonfigurasi kredensial identitas. Untuk informasi lebih lanjut, lihat Buat pengguna RAM dan Buat pasangan AccessKey.
Berikan izin yang diperlukan kepada pengguna RAM. Dalam contoh ini, kebijakan AliyunYundunCertReadOnlyAccess dilampirkan ke pengguna RAM. Kebijakan ini memberikan izin baca-saja pada Certificate Management Service. Untuk informasi lebih lanjut, lihat Berikan izin kepada pengguna RAM.
Dapatkan ID wilayah yang ingin Anda gunakan. Alibaba Cloud CLI menggunakan ID wilayah yang Anda tentukan untuk memulai panggilan API. Untuk informasi lebih lanjut tentang wilayah yang didukung oleh Certificate Management Service, lihat Endpoints.
Catatan
Ketika menggunakan Alibaba Cloud CLI, Anda dapat menggunakan opsi --region untuk menentukan wilayah dari mana Anda ingin memulai panggilan. Jika Anda menggunakan opsi tersebut untuk menentukan wilayah, Alibaba Cloud CLI akan mengabaikan informasi wilayah dalam pengaturan kredensial default dan variabel lingkungan. Untuk informasi lebih lanjut, lihat Opsi baris perintah.
Gunakan pasangan AccessKey dari pengguna RAM untuk mengonfigurasi kredensial identitas dalam file konfigurasi AkProfile. Untuk informasi lebih lanjut, lihat Contoh konfigurasi.

Langkah 3: Hasilkan perintah CLI sampel

Di OpenAPI Explorer, panggil operasi ListDeploymentJob.
Pada tab Parameters, konfigurasikan parameter. Lalu, klik tab CLI Example untuk melihat perintah CLI sampel yang dihasilkan.
Salin perintah CLI atau debug perintah CLI di Cloud Shell.
- Klik ikon untuk memulai Cloud Shell dan debug perintah CLI di Cloud Shell.
- Klik ikon untuk menyalin perintah CLI ke clipboard. Anda dapat menempelkan perintah CLI ke shell lokal Anda untuk menjalankan perintah atau menulis skrip baris perintah.
Catatan
- Ketika menempelkan perintah CLI ke shell lokal Anda untuk debugging, perhatikan format parameternya. Untuk informasi lebih lanjut tentang format parameter yang diperlukan oleh Alibaba Cloud CLI, lihat Format parameter.
- Secara default, OpenAPI Explorer menambahkan opsi --region ke perintah CLI yang dihasilkan. Ketika Anda menyalin perintah ke shell lokal Anda untuk dijalankan, Alibaba Cloud CLI mengabaikan informasi wilayah dalam pengaturan kredensial identitas default dan variabel lingkungan, dan menjalankan perintah di wilayah yang ditentukan oleh opsi tersebut. Anda dapat menghapus atau mempertahankan opsi tersebut berdasarkan kebutuhan bisnis Anda.

Langkah 4: Panggil operasi API dari Certificate Management Service

Contoh 1: Kueri operasi API yang didukung oleh Certificate Management Service dengan menggunakan Alibaba Cloud CLI

Contoh ini menunjukkan cara menggunakan opsi --help untuk menanyakan operasi API yang didukung oleh Certificate Management Service. Untuk informasi lebih lanjut, lihat Daftar operasi berdasarkan fungsi.

Catatan

Alibaba Cloud CLI memungkinkan Anda memanggil operasi API terkait Private Certificate Authority (PCA) versi 2020-06-30 dengan menggunakan opsi --force dan --version. Untuk informasi lebih lanjut, lihat Paksa panggil operasi API.
Ketika perintah CLI dihasilkan di OpenAPI Explorer untuk operasi API Certificate Management Service versi 2020-06-30, opsi --force dan --version secara otomatis ditambahkan ke perintah CLI. Anda tidak perlu menambahkan opsi tersebut secara manual.
Untuk informasi lebih lanjut tentang operasi API Certificate Management Service versi 2020-06-30, lihat Ikhtisar API.

Jalankan perintah berikut:
```
aliyun cas --help
```
Output yang diharapkan:

Contoh 2: Dapatkan daftar tugas penyebaran

Contoh ini menunjukkan cara menggunakan Alibaba Cloud CLI untuk memanggil operasi ListDeploymentJob dari Certificate Management Service. Operasi ini digunakan untuk mendapatkan daftar tugas penyebaran.

Jalankan perintah berikut:

aliyun cas ListDeploymentJob --JobType user --Status pending

Output yang diharapkan:

{
  "RequestId": "12345678-1234-1234-1234-123456789ABC",
  "Total": 7,
  "CurrentPage": 1,
  "ShowSize": 50,
  "Data": [
    {
      "Id": 19975,
      "GmtCreate": "1624343180000",
      "GmtModified": "1606482979000",
      "UserId": 0,
      "InstanceId": "cas-job-user-***",
      "Name": "job-test",
      "CertType": "upload",
      "ScheduleTime": "1606482979000",
      "StartTime": "1606482979000",
      "EndTime": "1606482979000",
      "Status": "penjadwalan",
      "Del": 1,
      "Rollback": 1,
      "JobType": "user",
      "CertDomain": "aliyundoc1.com,aliyundoc2.com,aliyundoc3.com",
      "ProductName": "NLB"
    }
  ]
}

Catatan

Jika kesalahan dikembalikan setelah Anda memanggil operasi API dari Certificate Management Service, periksa apakah parameter input dan nilainya valid berdasarkan kode kesalahan.
Anda juga dapat menggunakan Alibaba Cloud OpenAPI Diagnostics untuk melakukan diagnosis mandiri berdasarkan ID permintaan yang dikembalikan atau informasi kesalahan SDK.