All Products
Search

This Product

    Certificate Management Service:CreateServerCertificate

    Document Center

    Certificate Management Service:CreateServerCertificate

    Last Updated:Aug 17, 2026

    Menerbitkan satu sertifikat server berdasarkan permintaan penandatanganan sertifikat (CSR) yang dibuat oleh sistem.

    Deskripsi operasi

    Sebelum memanggil operasi ini, Anda harus telah memanggil CreateRootCACertificate untuk membuat sertifikat root CA dan memanggil CreateSubCACertificate untuk membuat sertifikat subordinate CA. Hanya sertifikat subordinate CA yang dapat menerbitkan sertifikat server.

    Batas QPS

    Batas QPS per pengguna untuk operasi ini adalah 10 panggilan per detik. Jika batas terlampaui, panggilan API akan dibatasi (throttled), yang dapat memengaruhi bisnis Anda. Panggil operasi ini dengan tepat.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    yundun-cert:CreateServerCertificate

    create

    *All Resource

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Domain

    string

    No

    Nama domain tambahan dan alamat IP tambahan dari sertifikat server. Setelah Anda menambahkan informasi tambahan ke sertifikat, Anda dapat menerapkan sertifikat tersebut ke beberapa nama domain dan alamat IP.

    Pisahkan beberapa nama domain dan alamat IP dengan koma (,).

    example.com
    Organization

    string

    No

    Nama organisasi. Nilai default: Alibaba Inc.

    Alibaba Cloud
    OrganizationUnit

    string

    No

    Nama departemen. Nilai default: Aliyun CDN.

    IT
    Country

    string

    No

    Kode negara, seperti CN atau US.

    CN
    CommonName

    string

    Yes

    Nama pengguna sertifikat. Untuk sertifikat otentikasi server (ServerAuth), penggunanya adalah server. Masukkan nama domain atau alamat IP yang terikat ke server.

    www.example.com
    State

    string

    No

    Nama provinsi atau negara bagian tempat organisasi sertifikat berada. Karakter bahasa Mandarin dan Inggris didukung. Nilai default: nama provinsi atau negara bagian tempat organisasi sertifikat subordinate CA yang menerbitkan sertifikat ini berada.

    Zhejiang
    Locality

    string

    No

    Nama kota tempat organisasi sertifikat berada. Karakter bahasa Mandarin dan Inggris didukung. Nilai default: nama kota tempat organisasi sertifikat subordinate CA yang menerbitkan sertifikat ini berada.

    Hangzhou
    Algorithm

    string

    Yes

    Algoritma kunci dari sertifikat server. Algoritma kunci menggunakan format <algoritma enkripsi>_<panjang kunci>. Nilai valid:

    • RSA_1024: Algoritma tanda tangan adalah Sha256WithRSA.

    • RSA_2048: Algoritma tanda tangan adalah Sha256WithRSA.

    • RSA_4096: Algoritma tanda tangan adalah Sha256WithRSA.

    • ECC_256: Algoritma tanda tangan adalah Sha256WithECDSA.

    • ECC_384: Algoritma tanda tangan adalah Sha256WithECDSA.

    • ECC_512: Algoritma tanda tangan adalah Sha256WithECDSA.

    • SM2_256: Algoritma tanda tangan adalah SM3WithSM2.

    Algoritma enkripsi sertifikat server harus sama dengan algoritma enkripsi sertifikat subordinate CA, tetapi panjang kunci dapat berbeda. Misalnya, jika algoritma kunci sertifikat subordinate CA adalah RSA_2048, maka algoritma kunci sertifikat server haruslah RSA_1024, RSA_2048, atau RSA_4096.

    Catatan

    Anda dapat memanggil DescribeCACertificate untuk mengkueri algoritma kunci sertifikat subordinate CA.

    RSA_2048
    ParentIdentifier

    string

    Yes

    Pengenal unik dari sertifikat subordinate CA yang menerbitkan sertifikat ini.

    Catatan

    Anda dapat memanggil DescribeCACertificateList untuk mengkueri pengenal unik sertifikat subordinate CA.

    271ae6bb538d538c70c01f81dg3****
    Years

    integer

    No

    Periode validitas sertifikat. Unit: tahun.

    1
    Months

    integer

    No

    Periode validitas sertifikat. Unit: bulan.

    12
    Days

    integer

    No

    Periode validitas sertifikat server. Unit: hari. Parameter Days, BeforeTime, dan AfterTime tidak boleh kosong semuanya. Parameter BeforeTime dan AfterTime harus keduanya kosong atau keduanya diisi. Aturan berikut berlaku:

    • Jika Anda mengatur parameter Days, Anda dapat memilih untuk mengatur atau tidak mengatur parameter BeforeTime dan AfterTime.

    • Jika Anda tidak mengatur parameter Days, Anda harus mengatur parameter BeforeTime dan AfterTime.

    Catatan

    • Jika Anda mengatur parameter Days, BeforeTime, dan AfterTime secara bersamaan, periode validitas sertifikat server ditentukan oleh nilai parameter Days.

    • Periode validitas sertifikat server tidak boleh melebihi periode validitas sertifikat subordinate CA. Anda dapat memanggil DescribeCACertificate untuk mengkueri periode validitas sertifikat subordinate CA.

    365
    BeforeTime

    integer

    No

    Pengatur waktu penerbitan sertifikat server dalam format timestamp. Nilai default: waktu saat Anda memanggil operasi ini. Unit: detik.

    Catatan

    Parameter BeforeTime dan AfterTime harus keduanya kosong atau keduanya diisi.

    1634283958
    AfterTime

    integer

    No

    Pengatur waktu kedaluwarsa sertifikat server dalam format timestamp. Unit: detik.

    Catatan

    Parameter BeforeTime dan AfterTime harus keduanya kosong atau keduanya diisi.

    1665819958
    Immediately

    integer

    No

    Apakah akan segera mengembalikan sertifikat digital. Nilai valid:

    • 0: tidak mengembalikan sertifikat. Ini adalah nilai default.

    • 1: mengembalikan sertifikat.

    • 2: mengembalikan sertifikat dan rantai sertifikatnya.

    1
    EnableCrl

    integer

    No

    Apakah akan menyertakan alamat Certificate Revocation List (CRL). Nilai valid:

    0: tidak.

    1: ya.

    1
    Tags

    array<object>

    No

    Daftar tag.

    object

    No

    Daftar tag.

    Key

    string

    No

    Kunci tag.

    account
    Value

    string

    No

    Nilai tag.

    test
    ResourceGroupId

    string

    No

    ID kelompok sumber daya. Anda dapat memperoleh ID ini dengan memanggil operasi ListResources.

    test
    CustomIdentifier

    string

    No

    Pengenal kustom, yang merupakan kunci unik.

    ****6bb538d538c70c01f81dg3****
    AsynchronousFlag

    boolean

    No

    Flag pemrosesan asinkron. Jika nilainya "true", layanan backend menerbitkan sertifikat secara asinkron. Setelah permintaan dikirim, Anda dapat memanggil operasi ListClientCertificate untuk mendapatkan sertifikat terbaru.

    false

    Saat memanggil operasi ini, Anda harus menyertakan parameter permintaan API umum Alibaba Cloud selain parameter permintaan khusus operasi yang dijelaskan dalam topik ini.

    Untuk format permintaan, lihat contoh permintaan di bagian Contoh pada topik ini.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    CreateCertificateResponse

    X509Certificate

    string

    Konten sertifikat server.

    -----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----
    CertificateChain

    string

    Rantai sertifikat CA.

    -----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n
    Identifier

    string

    Pengenal unik dari sertifikat server.

    160ae6bb538d538c70c01f81dcf2****
    SerialNumber

    string

    Nomor seri sertifikat.

    084bde9cd233f0ddae33adc438cfbbbd****
    RequestId

    string

    ID permintaan. Alibaba Cloud menghasilkan pengenal unik untuk setiap permintaan. Anda dapat menggunakan ID permintaan untuk memecahkan masalah.

    15C66C7B-671A-4297-9187-2C4477247A74

    Contoh

    Respons sukses

    JSONformat

    {
  "X509Certificate": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----",
  "CertificateChain": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n",
  "Identifier": "160ae6bb538d538c70c01f81dcf2****",
  "SerialNumber": "084bde9cd233f0ddae33adc438cfbbbd****",
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.