Set Certificate Issuer - Set Certificate Issuer

Service:

Key Vault

Version d'API:

2025-07-01

Définit l’émetteur du certificat spécifié.
L’opération SetCertificateIssuer ajoute ou met à jour l’émetteur de certificat spécifié. Cette opération nécessite l’autorisation certificates/setissuers.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
issuer-name	path	True	string	Le nom de l’émetteur. La valeur que vous fournissez peut être copiée globalement dans le but d’exécuter le service. La valeur fournie ne doit pas inclure d’informations personnellement identifiables ou sensibles.
vaultBaseUrl	path	True	string (uri)
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Obligatoire	Type	Description
provider	True	string	Le fournisseur de l’émetteur.
attributes		IssuerAttributes	Attributs de l’objet émetteur.
credentials		IssuerCredentials	Les informations d’identification à utiliser pour l’émetteur.
org_details		OrganizationDetails	Les détails de l’organisation tels qu’ils sont fournis à l’émetteur.

Réponses

Nom	Type	Description
200 OK	IssuerBundle	La demande a réussi.
Other Status Codes	KeyVaultError	Réponse d’erreur inattendue.

Sécurité

OAuth2Auth

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

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

Exemples

SetCertificateIssuer

Exemple de requête

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

Exemple de réponse

Code d’état:

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

Définitions

Nom	Description
AdministratorDetails	Détails de l’administrateur de l’organisation de l’émetteur du certificat.
CertificateIssuerSetParameters	L’émetteur du certificat définit les paramètres.
Error
IssuerAttributes	Attributs d’un émetteur géré par le service Key Vault.
IssuerBundle	Émetteur du certificat Key Vault.
IssuerCredentials	Les informations d’identification à utiliser pour l’émetteur du certificat.
KeyVaultError	Exception d’erreur du coffre de clés.
OrganizationDetails	Détails de l’organisation de l’émetteur du certificat.

AdministratorDetails

Object

Détails de l’administrateur de l’organisation de l’émetteur du certificat.

Nom	Type	Description
email	string	Adresse e-mail.
first_name	string	Prénom.
last_name	string	Nom.
phone	string	Numéro de téléphone.

CertificateIssuerSetParameters

Object

L’émetteur du certificat définit les paramètres.

Nom	Type	Description
attributes	IssuerAttributes	Attributs de l’objet émetteur.
credentials	IssuerCredentials	Les informations d’identification à utiliser pour l’émetteur.
org_details	OrganizationDetails	Les détails de l’organisation tels qu’ils sont fournis à l’émetteur.
provider	string	Le fournisseur de l’émetteur.

Error

Object

Nom	Type	Description
code	string	Code d’erreur.
innererror	Error	Erreur de serveur Key Vault.
message	string	Message d’erreur.

IssuerAttributes

Object

Attributs d’un émetteur géré par le service Key Vault.

Nom	Type	Description
created	integer (unixtime)	Heure de création en UTC.
enabled	boolean	Détermine si l’émetteur est activé.
updated	integer (unixtime)	Dernière mise à jour de l’heure en UTC.

IssuerBundle

Object

Émetteur du certificat Key Vault.

Nom	Type	Description
attributes	IssuerAttributes	Attributs de l’objet émetteur.
credentials	IssuerCredentials	Les informations d’identification à utiliser pour l’émetteur.
id	string	Identificateur de l’objet émetteur.
org_details	OrganizationDetails	Les détails de l’organisation tels qu’ils sont fournis à l’émetteur.
provider	string	Le fournisseur de l’émetteur.

IssuerCredentials

Object

Les informations d’identification à utiliser pour l’émetteur du certificat.

Nom	Type	Description
account_id	string	Nom d’utilisateur/nom de compte/ID de compte.
pwd	string	Le mot de passe/secret/clé de compte.

KeyVaultError

Object

Exception d’erreur du coffre de clés.

Nom	Type	Description
error	Error	Erreur de serveur Key Vault.

OrganizationDetails

Object

Détails de l’organisation de l’émetteur du certificat.

Nom	Type	Description
admin_details	AdministratorDetails[]	Détails de l’administrateur de l’organisation.
id	string	ID de l’organisation.