Set Certificate Issuer - Set Certificate Issuer

Service:

Key Vault

Version d'API:

7.4

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

PUT {vaultBaseUrl}/certificates/issuers/{issuer-name}?api-version=7.4

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
issuer-name	path	True	string	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	Nom du coffre, par exemple https://myvault.vault.azure.net.
api-version	query	True	string	Version de l’API cliente.

Corps de la demande

Nom	Obligatoire	Type	Description
provider	True	string	Fournisseur d’émetteurs.
attributes		IssuerAttributes	Attributs de l’objet émetteur.
credentials		IssuerCredentials	Informations d’identification à utiliser pour l’émetteur.
org_details		OrganizationDetails	Détails de l’organisation tel qu’il est fourni à l’émetteur.

Réponses

Nom	Type	Description
200 OK	IssuerBundle	Émetteur du certificat de coffre de clés.
Other Status Codes	KeyVaultError	Réponse d’erreur Key Vault décrivant pourquoi l’opération a échoué.

Exemples

SetCertificateIssuer

Exemple de requête

HTTP

PUT https://myvault.vault.azure.net//certificates/issuers/issuer01?api-version=7.4

{
  "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 de certificat.
CertificateIssuerSetParameters	L’émetteur de certificat définit des paramètres.
Error	Erreur du serveur key vault.
IssuerAttributes	Attributs d’un émetteur géré par le service Key Vault.
IssuerBundle	Émetteur du certificat Key Vault.
IssuerCredentials	Informations d’identification à utiliser pour l’émetteur de certificat.
KeyVaultError	Exception d’erreur du coffre de clés.
OrganizationDetails	Détails de l’organisation de l’émetteur de certificat.

AdministratorDetails

Object

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

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

CertificateIssuerSetParameters

Object

L’émetteur de certificat définit des paramètres.

Nom	Type	Description
attributes	IssuerAttributes	Attributs de l’objet émetteur.
credentials	IssuerCredentials	Informations d’identification à utiliser pour l’émetteur.
org_details	OrganizationDetails	Détails de l’organisation tel qu’il est fourni à l’émetteur.
provider	string	Fournisseur d’émetteurs.

Error

Object

Erreur du serveur key vault.

Nom	Type	Description
code	string	Code d’erreur.
innererror	Error	Erreur du 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 au format UTC.
enabled	boolean	Détermine si l’émetteur est activé.
updated	integer (unixtime)	Heure de la dernière mise à jour au format UTC.

IssuerBundle

Object

Émetteur du certificat Key Vault.

Nom	Type	Description
attributes	IssuerAttributes	Attributs de l’objet émetteur.
credentials	IssuerCredentials	Informations d’identification à utiliser pour l’émetteur.
id	string	Identificateur de l’objet émetteur.
org_details	OrganizationDetails	Détails de l’organisation tel qu’il est fourni à l’émetteur.
provider	string	Fournisseur d’émetteurs.

IssuerCredentials

Object

Informations d’identification à utiliser pour l’émetteur de certificat.

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

KeyVaultError

Object

Exception d’erreur du coffre de clés.

Nom	Type	Description
error	Error	Erreur du serveur key vault.

OrganizationDetails

Object

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

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