All Products
Search

This Product

    Certificate Management Service:CreateServerCertificateWithCsr

    Document Center

    Certificate Management Service:CreateServerCertificateWithCsr

    Last Updated:Aug 19, 2026

    Menerbitkan satu sertifikat server berdasarkan CSR kustom.

    Deskripsi operasi

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

    Batas QPS

    Batas QPS per pengguna tunggal 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:CreateServerCertificateWithCsr

    create

    *All Resource

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Csr

    string

    Yes

    Konten CSR. Anda dapat menggunakan OpenSSL atau Keytool untuk menghasilkan CSR. Untuk informasi lebih lanjut, lihat Bagaimana cara membuat file CSR?.

    -----BEGIN CERTIFICATE REQUEST----- ...... -----END CERTIFICATE REQUEST-----
    Domain

    string

    No

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

    Anda dapat memasukkan beberapa nama domain dan alamat IP sekaligus. Pisahkan beberapa nilai 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.

    CN
    CommonName

    string

    No

    Common name sertifikat. Karakter Mandarin, karakter Inggris, dan karakter lainnya didukung.

    Catatan

    Jika Anda menetapkan parameter Csr, nilai parameter CommonName ditentukan oleh informasi terkait dalam parameter Csr.

    mtcsq.com
    State

    string

    No

    Nama provinsi atau negara bagian tempat organisasi sertifikat berada. Karakter Mandarin, karakter Inggris, dan karakter lainnya didukung. Nilai default adalah nama provinsi atau negara bagian tempat organisasi sertifikat sub-CA yang menerbitkan sertifikat ini berada.

    Zhejiang
    Locality

    string

    No

    Nama kota tempat organisasi sertifikat berada. Karakter Mandarin, karakter Inggris, dan karakter lainnya didukung. Nilai default adalah nama kota tempat organisasi sertifikat sub-CA yang menerbitkan sertifikat ini berada.

    Hangzhou
    Algorithm

    string

    No

    Algoritma kunci sertifikat server. Algoritma kunci dalam 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 sub-CA, tetapi panjang kunci dapat berbeda. Misalnya, jika algoritma kunci sertifikat sub-CA adalah RSA_2048, algoritma kunci sertifikat server harus berupa RSA_1024, RSA_2048, atau RSA_4096.

    Catatan

    Anda dapat memanggil DescribeCACertificate untuk mengkueri algoritma kunci sertifikat sub-CA.

    RSA_2048
    ParentIdentifier

    string

    Yes

    Pengenal unik sertifikat sub-CA yang menerbitkan sertifikat ini.

    Catatan

    Anda dapat memanggil DescribeCACertificateList untuk mengkueri pengenal unik sertifikat sub-CA.

    270oe6bb538d538c70c01f81hfd3****
    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, dan parameter BeforeTime serta AfterTime harus keduanya kosong atau keduanya ditetapkan. Berikut adalah cara menetapkan parameter ini:

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

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

    Catatan

    • Jika Anda menetapkan 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 sub-CA. Anda dapat memanggil DescribeCACertificate untuk melihat periode validitas sertifikat sub-CA.

    365
    BeforeTime

    integer

    No

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

    Catatan

    Parameter BeforeTime dan AfterTime harus keduanya kosong atau keduanya ditetapkan.

    1634283958
    AfterTime

    integer

    No

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

    Catatan

    Parameter BeforeTime dan AfterTime harus keduanya kosong atau keduanya ditetapkan.

    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 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.

    rg-aek****wia
    CustomIdentifier

    string

    No

    Pengenal kustom, yang merupakan kunci unik.

    ***e6bb538d538c70c01f81hfd3****
    AsynchronousFlag

    boolean

    No

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

    false

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

    Untuk format permintaan, lihat contoh permintaan di bagian Contoh dalam 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 sertifikat server.

    180ae6bb538d538c70c01f81dcf2****
    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.

    55C66C7B-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": "180ae6bb538d538c70c01f81dcf2****",
  "SerialNumber": "084bde9cd233f0ddae33adc438cfbbbd****",
  "RequestId": "55C66C7B-671A-4297-9187-2C4477247A74"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.