Set Certificate Issuer - Set Certificate Issuer

Servizio:

Key Vault

Versione API:

2025-07-01

Imposta l'autorità di certificazione specificata.
L'operazione SetCertificateIssuer aggiunge o aggiorna l'autorità di certificazione specificata. Questa operazione richiede l'autorizzazione certificates/setissuers.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
issuer-name	path	True	string	Nome dell'emittente. Il valore fornito può essere copiato globalmente allo scopo di eseguire il servizio. Il valore fornito non deve includere informazioni personali o sensibili.
vaultBaseUrl	path	True	string (uri)
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
provider	True	string	Provider dell'emittente.
attributes		IssuerAttributes	Attributi dell'oggetto emittente.
credentials		IssuerCredentials	Le credenziali da utilizzare per l'emittente.
org_details		OrganizationDetails	Dettagli dell'organizzazione forniti all'emittente.

Risposte

Nome	Tipo	Descrizione
200 OK	IssuerBundle	La richiesta ha avuto esito positivo.
Other Status Codes	KeyVaultError	Risposta di errore imprevista.

Sicurezza

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
https://vault.azure.net/.default

Esempio

SetCertificateIssuer

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
AdministratorDetails	Dettagli dell'amministratore dell'organizzazione dell'autorità emittente del certificato.
CertificateIssuerSetParameters	L'emittente del certificato ha impostato i parametri.
Error
IssuerAttributes	Attributi di un'autorità emittente gestiti dal servizio Key Vault.
IssuerBundle	Autorità emittente per il certificato Key Vault.
IssuerCredentials	Credenziali da utilizzare per l'autorità di certificazione.
KeyVaultError	Eccezione di errore dell'insieme di credenziali delle chiavi.
OrganizationDetails	Dettagli sull'organizzazione dell'emittente del certificato.

AdministratorDetails

Object

Dettagli dell'amministratore dell'organizzazione dell'autorità emittente del certificato.

Nome	Tipo	Descrizione
email	string	Indirizzo di posta elettronica.
first_name	string	Nome di battesimo.
last_name	string	Cognome.
phone	string	Numero di telefono.

CertificateIssuerSetParameters

Object

L'emittente del certificato ha impostato i parametri.

Nome	Tipo	Descrizione
attributes	IssuerAttributes	Attributi dell'oggetto emittente.
credentials	IssuerCredentials	Le credenziali da utilizzare per l'emittente.
org_details	OrganizationDetails	Dettagli dell'organizzazione forniti all'emittente.
provider	string	Provider dell'emittente.

Error

Object

Nome	Tipo	Descrizione
code	string	Codice di errore.
innererror	Error	Errore del server dell'insieme di credenziali delle chiavi.
message	string	Messaggio di errore.

IssuerAttributes

Object

Attributi di un'autorità emittente gestiti dal servizio Key Vault.

Nome	Tipo	Descrizione
created	integer (unixtime)	Ora di creazione in UTC.
enabled	boolean	Determina se l'autorità emittente è abilitata.
updated	integer (unixtime)	Ultimo aggiornamento dell'ora in UTC.

IssuerBundle

Object

Autorità emittente per il certificato Key Vault.

Nome	Tipo	Descrizione
attributes	IssuerAttributes	Attributi dell'oggetto emittente.
credentials	IssuerCredentials	Le credenziali da utilizzare per l'emittente.
id	string	Identificatore per l'oggetto emittente.
org_details	OrganizationDetails	Dettagli dell'organizzazione forniti all'emittente.
provider	string	Provider dell'emittente.

IssuerCredentials

Object

Credenziali da utilizzare per l'autorità di certificazione.

Nome	Tipo	Descrizione
account_id	string	Il nome utente/nome account/ID account.
pwd	string	La password/segreto/chiave dell'account.

KeyVaultError

Object

Eccezione di errore dell'insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
error	Error	Errore del server dell'insieme di credenziali delle chiavi.

OrganizationDetails

Object

Dettagli sull'organizzazione dell'emittente del certificato.

Nome	Tipo	Descrizione
admin_details	AdministratorDetails[]	Dettagli dell'amministratore dell'organizzazione.
id	string	ID dell'organizzazione.