Set Certificate Issuer - Set Certificate Issuer

Service:

Key Vault

API Version:

7.4

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

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
issuer-name	path	True	string	O nome do emissor. O valor fornecido pode ser copiado globalmente com o objetivo de executar o serviço. O valor fornecido não deve incluir informações pessoais identificáveis ou confidenciais.
vaultBaseUrl	path	True	string	O nome do cofre, por exemplo https://myvault.vault.azure.net.
api-version	query	True	string	Versão da API de Cliente.

Corpo do Pedido

Name	Necessário	Tipo	Description
provider	True	string	O fornecedor do emissor.
attributes		IssuerAttributes	Atributos do objeto emissor.
credentials		IssuerCredentials	As credenciais a utilizar para o emissor.
org_details		OrganizationDetails	Detalhes da organização, conforme fornecido ao emissor.

Respostas

Name	Tipo	Description
200 OK	IssuerBundle	O emissor do certificado do cofre de chaves.
Other Status Codes	KeyVaultError	Key Vault resposta de erro que descreve a razão pela qual a operação falhou.

Exemplos

SetCertificateIssuer

Sample Request

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

Sample Response

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

Definições

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

AdministratorDetails

Detalhes do administrador da organização do emissor de certificados.

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

O emissor de certificados define os parâmetros.

Name	Tipo	Description
attributes	IssuerAttributes	Atributos do objeto emissor.
credentials	IssuerCredentials	As credenciais a utilizar para o emissor.
org_details	OrganizationDetails	Detalhes da organização, conforme fornecido ao emissor.
provider	string	O fornecedor do emissor.

Error

O erro do servidor do cofre de chaves.

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

Os atributos de um emissor gerido pelo serviço Key Vault.

Name	Tipo	Description
created	integer	Tempo de criação em UTC.
enabled	boolean	Determina se o emissor está ativado.
updated	integer	Hora da última atualização em UTC.

IssuerBundle

O emissor do certificado Key Vault.

Name	Tipo	Description
attributes	IssuerAttributes	Atributos do objeto emissor.
credentials	IssuerCredentials	As credenciais a utilizar para o emissor.
id	string	Identificador do objeto do emissor.
org_details	OrganizationDetails	Detalhes da organização, conforme fornecido ao emissor.
provider	string	O fornecedor do emissor.

IssuerCredentials

As credenciais a utilizar para o emissor de certificados.

Name	Tipo	Description
account_id	string	O nome de utilizador/nome da conta/ID da conta.
pwd	string	A palavra-passe/segredo/chave de conta.

KeyVaultError

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

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

OrganizationDetails

Detalhes da organização do emissor de certificados.

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