Set Certificate Issuer - Set Certificate Issuer

Usługa:

Key Vault

Wersja interfejsu API:

2025-07-01

Ustawia określonego wystawcę certyfikatu.
Operacja SetCertificateIssuer dodaje lub aktualizuje określonego wystawcę certyfikatu. Ta operacja wymaga uprawnienia wystawców certyfikatów/zestawów.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
issuer-name	path	True	string	Nazwa emitenta. Podana przez Ciebie wartość może zostać skopiowana globalnie w celu uruchomienia usługi. Podana wartość nie powinna zawierać danych osobowych ani danych wrażliwych.
vaultBaseUrl	path	True	string (uri)
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Wymagane	Typ	Opis
provider	True	string	Dostawca wydawca.
attributes		IssuerAttributes	Atrybuty obiektu wystawcy.
credentials		IssuerCredentials	Poświadczenia, które mają być używane przez wystawcę.
org_details		OrganizationDetails	Dane organizacji przekazane emitentowi.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	IssuerBundle	Żądanie zakończyło się pomyślnie.
Other Status Codes	KeyVaultError	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

OAuth2Auth

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
https://vault.azure.net/.default

Przykłady

SetCertificateIssuer

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Definicje

Nazwa	Opis
AdministratorDetails	Dane administratora organizacji wystawcy certyfikatu.
CertificateIssuerSetParameters	Wystawca certyfikatu ustawia parametry.
Error
IssuerAttributes	Atrybuty wystawcy zarządzanego przez usługę Key Vault.
IssuerBundle	Wystawca certyfikatu Key Vault.
IssuerCredentials	Poświadczenia, które mają być używane przez wystawcę certyfikatu.
KeyVaultError	Wyjątek błędu magazynu kluczy.
OrganizationDetails	Szczegółowe informacje na temat organizacji wystawcy certyfikatu.

AdministratorDetails

Objekt

Dane administratora organizacji wystawcy certyfikatu.

Nazwa	Typ	Opis
email	string	Adres e-mail.
first_name	string	Imię.
last_name	string	Nazwisko.
phone	string	Numer.

CertificateIssuerSetParameters

Objekt

Wystawca certyfikatu ustawia parametry.

Nazwa	Typ	Opis
attributes	IssuerAttributes	Atrybuty obiektu wystawcy.
credentials	IssuerCredentials	Poświadczenia, które mają być używane przez wystawcę.
org_details	OrganizationDetails	Dane organizacji przekazane emitentowi.
provider	string	Dostawca wydawca.

Error

Objekt

Nazwa	Typ	Opis
code	string	Kod błędu.
innererror	Error	Błąd serwera magazynu kluczy.
message	string	Komunikat o błędzie.

IssuerAttributes

Objekt

Atrybuty wystawcy zarządzanego przez usługę Key Vault.

Nazwa	Typ	Opis
created	integer (unixtime)	Czas utworzenia w formacie UTC.
enabled	boolean	Określa, czy wystawca jest włączony.
updated	integer (unixtime)	Ostatnia aktualizacja czasu w UTC.

IssuerBundle

Objekt

Wystawca certyfikatu Key Vault.

Nazwa	Typ	Opis
attributes	IssuerAttributes	Atrybuty obiektu wystawcy.
credentials	IssuerCredentials	Poświadczenia, które mają być używane przez wystawcę.
id	string	Identyfikator obiektu wystawcy.
org_details	OrganizationDetails	Dane organizacji przekazane emitentowi.
provider	string	Dostawca wydawca.

IssuerCredentials

Objekt

Poświadczenia, które mają być używane przez wystawcę certyfikatu.

Nazwa	Typ	Opis
account_id	string	Nazwa użytkownika/nazwa konta/identyfikator konta.
pwd	string	Hasło/klucz tajny/klucz konta.

KeyVaultError

Objekt

Wyjątek błędu magazynu kluczy.

Nazwa	Typ	Opis
error	Error	Błąd serwera magazynu kluczy.

OrganizationDetails

Objekt

Szczegółowe informacje na temat organizacji wystawcy certyfikatu.

Nazwa	Typ	Opis
admin_details	AdministratorDetails[]	Dane administratora organizacji.
id	string	Identyfikator organizacji.