Set Certificate Issuer - Set Certificate Issuer

Layanan:

Key Vault

Versi API:

2025-07-01

Mengatur penerbit sertifikat yang ditentukan.
Operasi SetCertificateIssuer menambahkan atau memperbarui penerbit sertifikat yang ditentukan. Operasi ini memerlukan izin sertifikat/setissuers.

PUT {vaultBaseUrl}/certificates/issuers/{issuer-name}?api-version=2025-07-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
issuer-name	path	True	string	Nama penerbit. Nilai yang Anda berikan dapat disalin secara global untuk tujuan menjalankan layanan. Nilai yang diberikan tidak boleh mencakup informasi yang dapat diidentifikasi secara pribadi atau sensitif.
vaultBaseUrl	path	True	string (uri)
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
provider	True	string	Penyedia penerbit.
attributes		IssuerAttributes	Atribut objek penerbit.
credentials		IssuerCredentials	Kredensial yang akan digunakan untuk penerbit.
org_details		OrganizationDetails	Rincian organisasi sebagaimana diberikan kepada penerbit.

Respons

Nama	Jenis	Deskripsi
200 OK	IssuerBundle	Permintaan telah berhasil.
Other Status Codes	KeyVaultError	Respons kesalahan tak terduga.

Keamanan

OAuth2Auth

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
https://vault.azure.net/.default

Contoh

SetCertificateIssuer

Permintaan sampel

HTTP

PUT https://myvault.vault.azure.net//certificates/issuers/issuer01?api-version=2025-07-01

{
  "provider": "Test",
  "credentials": {
    "account_id": "keyvaultuser",
    "pwd": "password"
  },
  "org_details": {
    "admin_details": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "email": "admin@microsoft.com",
        "phone": "4255555555"
      }
    ]
  }
}

Respon sampel

Kode status:

200

{
  "id": "https://myvault.vault.azure.net/certificates/issuers/issuer01",
  "provider": "Test",
  "credentials": {
    "account_id": "keyvaultuser"
  },
  "org_details": {
    "admin_details": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "email": "admin@microsoft.com",
        "phone": "4255555555"
      }
    ]
  },
  "attributes": {
    "enabled": true,
    "created": 1482188806,
    "updated": 1482189526
  }
}

Definisi

Nama	Deskripsi
AdministratorDetails	Detail administrator organisasi penerbit sertifikat.
CertificateIssuerSetParameters	Parameter set penerbit sertifikat.
Error
IssuerAttributes	Atribut penerbit yang dikelola oleh layanan Key Vault.
IssuerBundle	Penerbit untuk sertifikat Key Vault.
IssuerCredentials	Kredensial yang akan digunakan untuk penerbit sertifikat.
KeyVaultError	Pengecualian kesalahan brankas kunci.
OrganizationDetails	Rincian organisasi penerbit sertifikat.

AdministratorDetails

Objek

Detail administrator organisasi penerbit sertifikat.

Nama	Jenis	Deskripsi
email	string	Alamat email.
first_name	string	Nama depan.
last_name	string	Nama belakang.
phone	string	Nomor telepon.

CertificateIssuerSetParameters

Objek

Parameter set penerbit sertifikat.

Nama	Jenis	Deskripsi
attributes	IssuerAttributes	Atribut objek penerbit.
credentials	IssuerCredentials	Kredensial yang akan digunakan untuk penerbit.
org_details	OrganizationDetails	Rincian organisasi sebagaimana diberikan kepada penerbit.
provider	string	Penyedia penerbit.

Error

Objek

Nama	Jenis	Deskripsi
code	string	Kode kesalahan.
innererror	Error	Kesalahan server brankas kunci.
message	string	Pesan kesalahan.

IssuerAttributes

Objek

Atribut penerbit yang dikelola oleh layanan Key Vault.

Nama	Jenis	Deskripsi
created	integer (unixtime)	Waktu pembuatan di UTC.
enabled	boolean	Menentukan apakah penerbit diaktifkan.
updated	integer (unixtime)	Waktu terakhir diperbarui di UTC.

IssuerBundle

Objek

Penerbit untuk sertifikat Key Vault.

Nama	Jenis	Deskripsi
attributes	IssuerAttributes	Atribut objek penerbit.
credentials	IssuerCredentials	Kredensial yang akan digunakan untuk penerbit.
id	string	Pengidentifikasi untuk objek penerbit.
org_details	OrganizationDetails	Rincian organisasi sebagaimana diberikan kepada penerbit.
provider	string	Penyedia penerbit.

IssuerCredentials

Objek

Kredensial yang akan digunakan untuk penerbit sertifikat.

Nama	Jenis	Deskripsi
account_id	string	Nama pengguna/nama akun/id akun.
pwd	string	Kata sandi/rahasia/kunci akun.

KeyVaultError

Objek

Pengecualian kesalahan brankas kunci.

Nama	Jenis	Deskripsi
error	Error	Kesalahan server brankas kunci.

OrganizationDetails

Objek

Rincian organisasi penerbit sertifikat.

Nama	Jenis	Deskripsi
admin_details	AdministratorDetails[]	Detail administrator organisasi.
id	string	Id organisasi.