Set Certificate Issuer - Set Certificate Issuer

Dienst:

Key Vault

API-Version:

2025-07-01

Legt den angegebenen Zertifikataussteller fest.
Der SetCertificateIssuer-Vorgang fügt den angegebenen Zertifikataussteller hinzu oder aktualisiert ihn. Für diesen Vorgang ist die Berechtigung certificates/setissuers erforderlich.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
issuer-name	path	True	string	Der Name des Ausstellers. Der von Ihnen angegebene Wert kann zum Zwecke der Ausführung des Diensts global kopiert werden. Der angegebene Wert sollte keine personenbezogenen oder vertraulichen Informationen enthalten.
vaultBaseUrl	path	True	string (uri)
api-version	query	True	string minLength: 1	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
provider	True	string	Der Ausstelleranbieter.
attributes		IssuerAttributes	Attribute des Ausstellerobjekts.
credentials		IssuerCredentials	Die Anmeldeinformationen, die für den Aussteller verwendet werden sollen.
org_details		OrganizationDetails	Details zur Organisation, die dem Aussteller zur Verfügung gestellt wurden.

Antworten

Name	Typ	Beschreibung
200 OK	IssuerBundle	Die Anforderung ist erfolgreich.
Other Status Codes	KeyVaultError	Unerwartete Fehlerantwort.

Sicherheit

OAuth2Auth

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

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

Beispiele

SetCertificateIssuer

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

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

Definitionen

Name	Beschreibung
AdministratorDetails	Angaben zum Organisationsadministrator des Zertifikatausstellers.
CertificateIssuerSetParameters	Der Aussteller des Zertifikats hat die Parameter festgelegt.
Error
IssuerAttributes	Die Attribute eines Ausstellers, der vom Key Vault-Dienst verwaltet wird.
IssuerBundle	Der Aussteller für das Key Vault-Zertifikat.
IssuerCredentials	Die Anmeldeinformationen, die für den Zertifikataussteller verwendet werden sollen.
KeyVaultError	Die Key Vault-Fehlerausnahme.
OrganizationDetails	Angaben zur Organisation des Zertifikatsausstellers.

AdministratorDetails

Objekt

Angaben zum Organisationsadministrator des Zertifikatausstellers.

Name	Typ	Beschreibung
email	string	E-Mail-Adresse.
first_name	string	Vorname.
last_name	string	Nachname.
phone	string	Telefonnummer.

CertificateIssuerSetParameters

Objekt

Der Aussteller des Zertifikats hat die Parameter festgelegt.

Name	Typ	Beschreibung
attributes	IssuerAttributes	Attribute des Ausstellerobjekts.
credentials	IssuerCredentials	Die Anmeldeinformationen, die für den Aussteller verwendet werden sollen.
org_details	OrganizationDetails	Details zur Organisation, die dem Aussteller zur Verfügung gestellt wurden.
provider	string	Der Ausstelleranbieter.

Error

Objekt

Name	Typ	Beschreibung
code	string	Der Fehlercode.
innererror	Error	Der Key Vault-Serverfehler.
message	string	Die Fehlermeldung.

IssuerAttributes

Objekt

Die Attribute eines Ausstellers, der vom Key Vault-Dienst verwaltet wird.

Name	Typ	Beschreibung
created	integer (unixtime)	Erstellungszeit in UTC.
enabled	boolean	Bestimmt, ob der Aussteller aktiviert ist.
updated	integer (unixtime)	Uhrzeit der letzten Aktualisierung in UTC.

IssuerBundle

Objekt

Der Aussteller für das Key Vault-Zertifikat.

Name	Typ	Beschreibung
attributes	IssuerAttributes	Attribute des Ausstellerobjekts.
credentials	IssuerCredentials	Die Anmeldeinformationen, die für den Aussteller verwendet werden sollen.
id	string	Bezeichner für das Ausstellerobjekt.
org_details	OrganizationDetails	Details zur Organisation, die dem Aussteller zur Verfügung gestellt wurden.
provider	string	Der Ausstelleranbieter.

IssuerCredentials

Objekt

Die Anmeldeinformationen, die für den Zertifikataussteller verwendet werden sollen.

Name	Typ	Beschreibung
account_id	string	Der Benutzername/Kontoname/Konto-ID.
pwd	string	Das Passwort/der geheime Schlüssel/der Kontoschlüssel.

KeyVaultError

Objekt

Die Key Vault-Fehlerausnahme.

Name	Typ	Beschreibung
error	Error	Der Key Vault-Serverfehler.

OrganizationDetails

Objekt

Angaben zur Organisation des Zertifikatsausstellers.

Name	Typ	Beschreibung
admin_details	AdministratorDetails[]	Angaben zum Organisationsadministrator.
id	string	ID der Organisation.