Set Certificate Issuer - Set Certificate Issuer

Služba:

Key Vault

Verze rozhraní API:

2025-07-01

Nastaví určeného vydavatele certifikátu.
Operace SetCertificateIssuer přidá nebo aktualizuje zadaného vystavitele certifikátu. Tato operace vyžaduje oprávnění certificates/setissuers.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
issuer-name	path	True	string	Název vydavatele. Vámi poskytnutá hodnota může být globálně zkopírována pro účely provozování služby. Poskytnutá hodnota by neměla obsahovat osobně identifikovatelné nebo citlivé informace.
vaultBaseUrl	path	True	string (uri)
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Vyžadováno	Typ	Description
provider	True	string	Poskytovatel emitenta.
attributes		IssuerAttributes	Atributy objektu vyvydavatele.
credentials		IssuerCredentials	Přihlašovací údaje, které mají být použity pro vydavatele.
org_details		OrganizationDetails	Údaje o organizaci poskytnuté emitentovi.

Odpovědi

Name	Typ	Description
200 OK	IssuerBundle	Požadavek byl úspěšný.
Other Status Codes	KeyVaultError	Neočekávaná chybová odpověď

Zabezpečení

OAuth2Auth

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
https://vault.azure.net/.default

Příklady

SetCertificateIssuer

Ukázkový požadavek

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"
      }
    ]
  }
}

Ukázková odpověď

Stavový kód:

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

Definice

Name	Description
AdministratorDetails	Údaje o správci organizace vydavatele certifikátu.
CertificateIssuerSetParameters	Vydavatel certifikátu nastavil parametry.
Error
IssuerAttributes	Atributy vystavitele spravované službou Key Vault.
IssuerBundle	Vystavitel certifikátu Key Vault.
IssuerCredentials	Přihlašovací údaje, které mají být použity pro vydavatele certifikátu.
KeyVaultError	Výjimka chyby trezoru klíčů.
OrganizationDetails	Detail organizace vydavatele certifikátu.

AdministratorDetails

Objekt

Údaje o správci organizace vydavatele certifikátu.

Name	Typ	Description
email	string	E-mailová adresa.
first_name	string	Křestní jméno.
last_name	string	Příjmení.
phone	string	Telefonní číslo.

CertificateIssuerSetParameters

Objekt

Vydavatel certifikátu nastavil parametry.

Name	Typ	Description
attributes	IssuerAttributes	Atributy objektu vyvydavatele.
credentials	IssuerCredentials	Přihlašovací údaje, které mají být použity pro vydavatele.
org_details	OrganizationDetails	Údaje o organizaci poskytnuté emitentovi.
provider	string	Poskytovatel emitenta.

Error

Objekt

Name	Typ	Description
code	string	Kód chyby.
innererror	Error	Chyba serveru trezoru klíčů.
message	string	Chybová zpráva.

IssuerAttributes

Objekt

Atributy vystavitele spravované službou Key Vault.

Name	Typ	Description
created	integer (unixtime)	Čas vytvoření v UTC.
enabled	boolean	Určuje, zda je vydavatel povolen.
updated	integer (unixtime)	Čas poslední aktualizace v UTC.

IssuerBundle

Objekt

Vystavitel certifikátu Key Vault.

Name	Typ	Description
attributes	IssuerAttributes	Atributy objektu vyvydavatele.
credentials	IssuerCredentials	Přihlašovací údaje, které mají být použity pro vydavatele.
id	string	Identifikátor objektu vystavitele.
org_details	OrganizationDetails	Údaje o organizaci poskytnuté emitentovi.
provider	string	Poskytovatel emitenta.

IssuerCredentials

Objekt

Přihlašovací údaje, které mají být použity pro vydavatele certifikátu.

Name	Typ	Description
account_id	string	Uživatelské jméno / název účtu / ID účtu.
pwd	string	Heslo/tajný klíč/klíč účtu.

KeyVaultError

Objekt

Výjimka chyby trezoru klíčů.

Name	Typ	Description
error	Error	Chyba serveru trezoru klíčů.

OrganizationDetails

Objekt

Detail organizace vydavatele certifikátu.

Name	Typ	Description
admin_details	AdministratorDetails[]	Údaje o správci organizace.
id	string	ID organizace.