Set Certificate Issuer - Set Certificate Issuer

Servicio:

Key Vault

Versión de la API:

2025-07-01

Establece el emisor del certificado especificado.
La operación SetCertificateIssuer agrega o actualiza el emisor de certificados especificado. Esta operación requiere el permiso de certificados/setissuers.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
issuer-name	path	True	string	El nombre del emisor. El valor que proporcione se puede copiar globalmente con el fin de ejecutar el servicio. El valor proporcionado no debe incluir información confidencial o de identificación personal.
vaultBaseUrl	path	True	string (uri)
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
provider	True	string	El proveedor emisor.
attributes		IssuerAttributes	Atributos del objeto emisor.
credentials		IssuerCredentials	Las credenciales que se utilizarán para el emisor.
org_details		OrganizationDetails	Detalles de la organización tal como se proporcionan al emisor.

Respuestas

Nombre	Tipo	Description
200 OK	IssuerBundle	La solicitud se ha realizado correctamente.
Other Status Codes	KeyVaultError	Una respuesta de error inesperada.

Seguridad

OAuth2Auth

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

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

Ejemplos

SetCertificateIssuer

Solicitud de ejemplo

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

Respuesta de muestra

status code:

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

Definiciones

Nombre	Description
AdministratorDetails	Detalles del administrador de la organización del emisor del certificado.
CertificateIssuerSetParameters	El emisor del certificado establece los parámetros.
Error
IssuerAttributes	Atributos de un emisor administrado por el servicio Key Vault.
IssuerBundle	Emisor del certificado de Key Vault.
IssuerCredentials	Las credenciales que se utilizarán para el emisor del certificado.
KeyVaultError	Excepción de error de Key Vault.
OrganizationDetails	Detalles de la organización del emisor del certificado.

AdministratorDetails

Object

Detalles del administrador de la organización del emisor del certificado.

Nombre	Tipo	Description
email	string	Dirección de correo electrónico.
first_name	string	Nombre.
last_name	string	Apellido.
phone	string	Número de teléfono.

CertificateIssuerSetParameters

Object

El emisor del certificado establece los parámetros.

Nombre	Tipo	Description
attributes	IssuerAttributes	Atributos del objeto emisor.
credentials	IssuerCredentials	Las credenciales que se utilizarán para el emisor.
org_details	OrganizationDetails	Detalles de la organización tal como se proporcionan al emisor.
provider	string	El proveedor emisor.

Error

Object

Nombre	Tipo	Description
code	string	Código de error.
innererror	Error	El error del servidor del almacén de claves.
message	string	El mensaje de error.

IssuerAttributes

Object

Atributos de un emisor administrado por el servicio Key Vault.

Nombre	Tipo	Description
created	integer (unixtime)	Hora de creación en UTC.
enabled	boolean	Determina si el emisor está habilitado.
updated	integer (unixtime)	Hora de la última actualización en UTC.

IssuerBundle

Object

Emisor del certificado de Key Vault.

Nombre	Tipo	Description
attributes	IssuerAttributes	Atributos del objeto emisor.
credentials	IssuerCredentials	Las credenciales que se utilizarán para el emisor.
id	string	Identificador del objeto emisor.
org_details	OrganizationDetails	Detalles de la organización tal como se proporcionan al emisor.
provider	string	El proveedor emisor.

IssuerCredentials

Object

Las credenciales que se utilizarán para el emisor del certificado.

Nombre	Tipo	Description
account_id	string	El nombre de usuario/nombre de cuenta/identificador de cuenta.
pwd	string	La contraseña/secreto/clave de cuenta.

KeyVaultError

Object

Excepción de error de Key Vault.

Nombre	Tipo	Description
error	Error	El error del servidor del almacén de claves.

OrganizationDetails

Object

Detalles de la organización del emisor del certificado.

Nombre	Tipo	Description
admin_details	AdministratorDetails[]	Detalles del administrador de la organización.
id	string	Identificador de la organización.