Set Certificate Issuer - Set Certificate Issuer

Serviço:

Key Vault

Versão da API:

2025-07-01

Define o emissor de certificado especificado.
A operação SetCertificateIssuer adiciona ou atualiza o emissor de certificado especificado. Esta operação requer a permissão de certificados/setissuers.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
issuer-name	path	True	string	O nome do emitente. O valor fornecido pode ser copiado globalmente com a finalidade de executar o serviço. O valor fornecido não deve incluir informações pessoais identificáveis ou confidenciais.
vaultBaseUrl	path	True	string (uri)
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Necessário	Tipo	Description
provider	True	string	O fornecedor do emitente.
attributes		IssuerAttributes	Atributos do objeto emissor.
credentials		IssuerCredentials	As credenciais a serem usadas pelo emissor.
org_details		OrganizationDetails	Detalhes da organização fornecidos ao emitente.

Respostas

Name	Tipo	Description
200 OK	IssuerBundle	O pedido foi bem-sucedido.
Other Status Codes	KeyVaultError	Uma resposta de erro inesperada.

Segurança

OAuth2Auth

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

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

Exemplos

SetCertificateIssuer

Pedido de amostra

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

Resposta da amostra

Código de estado:

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

Definições

Name	Description
AdministratorDetails	Detalhes do administrador da organização do emissor do certificado.
CertificateIssuerSetParameters	O emissor do certificado define parâmetros.
Error
IssuerAttributes	Os atributos de um emissor gerenciado pelo serviço Cofre de Chaves.
IssuerBundle	O emissor do certificado Key Vault.
IssuerCredentials	As credenciais a serem usadas para o emissor do certificado.
KeyVaultError	A exceção de erro do cofre de chaves.
OrganizationDetails	Detalhes da organização do emissor do certificado.

AdministratorDetails

Object

Detalhes do administrador da organização do emissor do certificado.

Name	Tipo	Description
email	string	Endereço de e-mail.
first_name	string	Nome próprio.
last_name	string	Apelido.
phone	string	Número de telefone.

CertificateIssuerSetParameters

Object

O emissor do certificado define parâmetros.

Name	Tipo	Description
attributes	IssuerAttributes	Atributos do objeto emissor.
credentials	IssuerCredentials	As credenciais a serem usadas pelo emissor.
org_details	OrganizationDetails	Detalhes da organização fornecidos ao emitente.
provider	string	O fornecedor do emitente.

Error

Object

Name	Tipo	Description
code	string	O código de erro.
innererror	Error	O erro do servidor do cofre de chaves.
message	string	A mensagem de erro.

IssuerAttributes

Object

Os atributos de um emissor gerenciado pelo serviço Cofre de Chaves.

Name	Tipo	Description
created	integer (unixtime)	Hora de criação em UTC.
enabled	boolean	Determina se o emissor está habilitado.
updated	integer (unixtime)	Última atualização em UTC.

IssuerBundle

Object

O emissor do certificado Key Vault.

Name	Tipo	Description
attributes	IssuerAttributes	Atributos do objeto emissor.
credentials	IssuerCredentials	As credenciais a serem usadas pelo emissor.
id	string	Identificador do objeto emissor.
org_details	OrganizationDetails	Detalhes da organização fornecidos ao emitente.
provider	string	O fornecedor do emitente.

IssuerCredentials

Object

As credenciais a serem usadas para o emissor do certificado.

Name	Tipo	Description
account_id	string	O nome de usuário/nome da conta/ID da conta.
pwd	string	A chave de senha/segredo/conta.

KeyVaultError

Object

A exceção de erro do cofre de chaves.

Name	Tipo	Description
error	Error	O erro do servidor do cofre de chaves.

OrganizationDetails

Object

Detalhes da organização do emissor do certificado.

Name	Tipo	Description
admin_details	AdministratorDetails[]	Detalhes do administrador da organização.
id	string	Id da organização.