O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Criar um novo certificado

05/23/2026

PDFs

POST /accounts/{account_id}/core/v1/certificates

Indica os valores desejados para o recurso da API de Certificate a ser criado.

Parâmetros

Nome	Tipo	Em	Obrigatório	Descrição
id_da_conta	string	caminho	Verdadeiro	ID do recurso de conta que o contém exemplo: {{.Account}}

Nome

Tipo

Obrigatório

Descrição

id_da_conta

string

caminho

Verdadeiro

ID do recurso de conta que o contém

exemplo: {{.Account}}

Corpo da solicitação

Indica os valores desejados para o recurso da API de Certificate a ser criado.

Nome	Tipo	Obrigatório	Descrição
tipo	string	Verdadeiro	Tipo de mídia do recurso. Os valores definidos são: "application/astra-certificate"
versão	string	Verdadeiro	Versão do recurso. Os valores definidos são: "1,0" "1,1"
certUse	string	Falso	String JSON que indica o uso do certificado. Se não for especificado, o padrão é "rootCA". Os valores definidos são: "rootCA" - O certificado é um certificado de autoridade certificadora (CA) usado para confiar em qualquer certificado assinado por essa CA. "intermediateCA" - O certificado é um certificado de CA intermediário emitido por uma CA raiz.
certificado	string	Verdadeiro	String JSON contendo um certificado formatado em PKCS-11 codificado em base64 (PEM). Os valores definidos são: Está em conformidade com o esquema de dados codificados em base64
isSelfSigned	string	Falso	String JSON indicando se o certificado é autoassinado. Se não for fornecida na criação, o valor padrão é "false". Na atualização: Se um valor for fornecido, esse valor será utilizado. Se o valor não for fornecido e o campo "cert" estiver incluído na atualização, o valor será definido como "false". Se o valor não for fornecido e o campo "cert" não estiver incluído na atualização, o valor existente será mantido. Os valores definidos são: "verdadeiro" - O certificado é autoassinado. "falso" - O certificado não é autoassinado.
trustStateDesired	string	Falso	String JSON contendo um valor que indica se o certificado é confiável. Se não for especificado na criação, o valor padrão é "trusted". Os valores definidos são: "Não confiável" - O certificado não é confiável. "trusted" - O certificado está marcado como confiável.
metadados	"type_astra_metadados_update"	Falso	Metadados especificados pelo cliente e pelo serviço associados ao recurso. Os valores definidos são: Conforme o esquema de metadados Astra. Se não for especificado na criação, um objeto de metadados será criado sem rótulos. Se não for especificado na atualização, os rótulos do objeto de metadados, creationTimestamp e createdBy, serão preservados sem modificação.

Nome

Tipo

Obrigatório

Descrição

tipo

string

Verdadeiro

Tipo de mídia do recurso. Os valores definidos são:

"application/astra-certificate"

versão

string

Verdadeiro

Versão do recurso. Os valores definidos são:

"1,0"
"1,1"

certUse

string

Falso

String JSON que indica o uso do certificado. Se não for especificado, o padrão é "rootCA". Os valores definidos são:

"rootCA" - O certificado é um certificado de autoridade certificadora (CA) usado para confiar em qualquer certificado assinado por essa CA.
"intermediateCA" - O certificado é um certificado de CA intermediário emitido por uma CA raiz.

certificado

string

Verdadeiro

String JSON contendo um certificado formatado em PKCS-11 codificado em base64 (PEM). Os valores definidos são:

Está em conformidade com o esquema de dados codificados em base64

isSelfSigned

string

Falso

String JSON indicando se o certificado é autoassinado. Se não for fornecida na criação, o valor padrão é "false". Na atualização:

Se um valor for fornecido, esse valor será utilizado.
Se o valor não for fornecido e o campo "cert" estiver incluído na atualização, o valor será definido como "false".
Se o valor não for fornecido e o campo "cert" não estiver incluído na atualização, o valor existente será mantido. Os valores definidos são:
"verdadeiro" - O certificado é autoassinado.
"falso" - O certificado não é autoassinado.

trustStateDesired

string

Falso

String JSON contendo um valor que indica se o certificado é confiável. Se não for especificado na criação, o valor padrão é "trusted". Os valores definidos são:

"Não confiável" - O certificado não é confiável.
"trusted" - O certificado está marcado como confiável.

metadados

"type_astra_metadados_update"

Falso

Metadados especificados pelo cliente e pelo serviço associados ao recurso. Os valores definidos são:

Conforme o esquema de metadados Astra. Se não for especificado na criação, um objeto de metadados será criado sem rótulos. Se não for especificado na atualização, os rótulos do objeto de metadados, creationTimestamp e createdBy, serão preservados sem modificação.

Exemplo de solicitação

{
  "type": "application/astra-certificate",
  "version": "1.1",
  "certUse": "rootCA",
  "cert": "LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUZyVENDQTVXZ0F3MVJHbnFGbUJSSWRyV1kwPQotLS0tLUVORCBDRVJUSUZJQ0FURS0tLS0t"
}

Resposta

Status: 201, Returns the newly created certificate resource in the JSON response body.

Nome	Tipo	Obrigatório	Descrição
tipo	string	Verdadeiro	Tipo de mídia do recurso. Os valores definidos são: "application/astra-certificate"
versão	string	Verdadeiro	Versão do recurso. Os valores definidos são: "1,0" "1,1"
id	string	Verdadeiro	Identificador globalmente único do recurso. Os valores definidos são: Em conformidade com o esquema UUIDv4
certUse	string	Verdadeiro	String JSON que indica o uso do certificado. Se não for especificado, o padrão é "rootCA". Os valores definidos são: "rootCA" - O certificado é um certificado de autoridade certificadora (CA) usado para confiar em qualquer certificado assinado por essa CA. "intermediateCA" - O certificado é um certificado de CA intermediário emitido por uma CA raiz.
certificado	string	Verdadeiro	String JSON contendo um certificado formatado em PKCS-11 codificado em base64 (PEM). Os valores definidos são: Está em conformidade com o esquema de dados codificados em base64
cn	string	Verdadeiro	String JSON contendo um nome comum extraído do certificado. Os valores definidos são: Comprimento mínimo: 1 Comprimento máximo: 511
expiryTimestamp	string	Verdadeiro	String JSON contendo um carimbo de data/hora indicando quando o certificado expira. Os valores definidos são: Em conformidade com o esquema de data e hora ISO-8601
isSelfSigned	string	Verdadeiro	String JSON indicando se o certificado é autoassinado. Se não for fornecida na criação, o valor padrão é "false". Na atualização: Se um valor for fornecido, esse valor será utilizado. Se o valor não for fornecido e o campo "cert" estiver incluído na atualização, o valor será definido como "false". Se o valor não for fornecido e o campo "cert" não estiver incluído na atualização, o valor existente será mantido. Os valores definidos são: "verdadeiro" - O certificado é autoassinado. "falso" - O certificado não é autoassinado.
trustState	string	Verdadeiro	String JSON contendo um de um conjunto de valores enumerados que indicam se o certificado é confiável. Os valores definidos são: "Não confiável" - O certificado não é confiável. "trusted" - O certificado está marcado como confiável. "expired" - O certificado expirou, portanto não é confiável nem não confiável.
trustStateTransitions	array["type_astra_stateTransition"]	Verdadeiro	Matriz JSON de objetos JSON, cada um representando o conjunto de transições de estado permitidas a partir de um determinado estado definido. Cada objeto JSON contém os campos "from" e "to", onde o valor de "from" é o nome de um estado e o valor de "to" é uma matriz de estados de destino permitidos.
trustStateDesired	string	Falso	String JSON contendo um valor que indica se o certificado é confiável. Se não for especificado na criação, o valor padrão é "trusted". Os valores definidos são: "Não confiável" - O certificado não é confiável. "trusted" - O certificado está marcado como confiável.
trustStateDetails	array["type_astra_stateDetail"]	Verdadeiro	Matriz JSON de objetos JSON que lista detalhes adicionais sobre o estado de confiança do certificado. Se nenhum detalhe estiver disponível, esta matriz estará vazia. Quantidade mínima de itens: 0
metadados	"type_astra_metadados_update"	Verdadeiro	Metadados especificados pelo cliente e pelo serviço associados ao recurso. Os valores definidos são: Conforme o esquema de metadados Astra. Se não for especificado na criação, um objeto de metadados será criado sem rótulos. Se não for especificado na atualização, os rótulos do objeto de metadados, creationTimestamp e createdBy, serão preservados sem modificação.

Nome

Tipo

Obrigatório

Descrição

tipo

string

Verdadeiro

Tipo de mídia do recurso. Os valores definidos são:

"application/astra-certificate"

versão

string

Verdadeiro

Versão do recurso. Os valores definidos são:

"1,0"
"1,1"

string

Verdadeiro

Identificador globalmente único do recurso. Os valores definidos são:

Em conformidade com o esquema UUIDv4

certUse

string

Verdadeiro

String JSON que indica o uso do certificado. Se não for especificado, o padrão é "rootCA". Os valores definidos são:

"rootCA" - O certificado é um certificado de autoridade certificadora (CA) usado para confiar em qualquer certificado assinado por essa CA.
"intermediateCA" - O certificado é um certificado de CA intermediário emitido por uma CA raiz.

certificado

string

Verdadeiro

String JSON contendo um certificado formatado em PKCS-11 codificado em base64 (PEM). Os valores definidos são:

Está em conformidade com o esquema de dados codificados em base64

string

Verdadeiro

String JSON contendo um nome comum extraído do certificado. Os valores definidos são:

Comprimento mínimo: 1
Comprimento máximo: 511

expiryTimestamp

string

Verdadeiro

String JSON contendo um carimbo de data/hora indicando quando o certificado expira. Os valores definidos são:

Em conformidade com o esquema de data e hora ISO-8601

isSelfSigned

string

Verdadeiro

String JSON indicando se o certificado é autoassinado. Se não for fornecida na criação, o valor padrão é "false". Na atualização:

Se um valor for fornecido, esse valor será utilizado.
Se o valor não for fornecido e o campo "cert" estiver incluído na atualização, o valor será definido como "false".
Se o valor não for fornecido e o campo "cert" não estiver incluído na atualização, o valor existente será mantido. Os valores definidos são:
"verdadeiro" - O certificado é autoassinado.
"falso" - O certificado não é autoassinado.

trustState

string

Verdadeiro

String JSON contendo um de um conjunto de valores enumerados que indicam se o certificado é confiável. Os valores definidos são:

"Não confiável" - O certificado não é confiável.
"trusted" - O certificado está marcado como confiável.
"expired" - O certificado expirou, portanto não é confiável nem não confiável.

trustStateTransitions

array["type_astra_stateTransition"]

Verdadeiro

Matriz JSON de objetos JSON, cada um representando o conjunto de transições de estado permitidas a partir de um determinado estado definido. Cada objeto JSON contém os campos "from" e "to", onde o valor de "from" é o nome de um estado e o valor de "to" é uma matriz de estados de destino permitidos.

trustStateDesired

string

Falso

String JSON contendo um valor que indica se o certificado é confiável. Se não for especificado na criação, o valor padrão é "trusted". Os valores definidos são:

"Não confiável" - O certificado não é confiável.
"trusted" - O certificado está marcado como confiável.

trustStateDetails

array["type_astra_stateDetail"]

Verdadeiro

Matriz JSON de objetos JSON que lista detalhes adicionais sobre o estado de confiança do certificado. Se nenhum detalhe estiver disponível, esta matriz estará vazia.

Quantidade mínima de itens: 0

metadados

"type_astra_metadados_update"

Verdadeiro

Metadados especificados pelo cliente e pelo serviço associados ao recurso. Os valores definidos são:

Conforme o esquema de metadados Astra. Se não for especificado na criação, um objeto de metadados será criado sem rótulos. Se não for especificado na atualização, os rótulos do objeto de metadados, creationTimestamp e createdBy, serão preservados sem modificação.

Exemplo de resposta

{
  "type": "application/astra-certificate",
  "version": "1.1",
  "id": "a26cbed4-2183-58ce-aa19-e37ca8b0531a",
  "certUse": "rootCA",
  "cert": "LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUZyVENDQTVXZ0F3MVJHbnFGbUJSSWRyV1kwPQotLS0tLUVORCBDRVJUSUZJQ0FURS0tLS0t",
  "cn": "vcenter.example.com",
  "isSelfSigned": "false",
  "expiryTimestamp": "2022-03-23T16:48:38.5233461Z",
  "trustState": "trusted",
  "trustStateTransitions": [
    {
      "from": "untrusted",
      "to": [
        "trusted"
      ]
    },
    {
      "from": "trusted",
      "to": [
        "untrusted"
      ]
    }
  ],
  "trustStateDesired": "trusted",
  "trustStateDetails": [],
  "metadata": {
    "labels": [],
    "creationTimestamp": "2022-10-06T20:58:16.305662Z",
    "modificationTimestamp": "2022-10-06T20:58:16.305662Z",
    "createdBy": "8f84cf09-8036-51e4-b579-bd30cb07b269"
  }
}

Resposta

Status: 400, Bad request

Nome	Tipo	Obrigatório	Descrição
tipo	string	Verdadeiro
título	string	Verdadeiro
detalhe	string	Verdadeiro
status	string	Verdadeiro
ID de correlação	string	Falso
invalidFields	array["invalidFields"]	Falso	Lista de campos inválidos no corpo da requisição

Nome

Tipo

Obrigatório

Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso

invalidFields

array["invalidFields"]

Falso

Lista de campos inválidos no corpo da requisição

Exemplo de resposta

{
  "type": "https://astra.netapp.io/problems/7",
  "title": "Invalid JSON payload",
  "detail": "The request body is not valid JSON.",
  "status": "400"
}

Resposta

Status: 403, Forbidden

Nome	Tipo	Obrigatório
tipo	string	Verdadeiro
título	string	Verdadeiro
detalhe	string	Verdadeiro
status	string	Verdadeiro
ID de correlação	string	Falso

Nome

Tipo

Obrigatório

Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso

Exemplo de resposta

{
  "type": "https://astra.netapp.io/problems/11",
  "title": "Operation not permitted",
  "detail": "The requested operation isn't permitted.",
  "status": "403"
}

Resposta

Status: 500, Internal server error

Nome	Tipo	Obrigatório
tipo	string	Verdadeiro
título	string	Verdadeiro
detalhe	string	Verdadeiro
status	string	Verdadeiro
ID de correlação	string	Falso

Nome

Tipo

Obrigatório

Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso

Exemplo de resposta

{
  "type": "https://astra.netapp.io/problems/34",
  "title": "Internal server error",
  "detail": "The server was unable to process this request.",
  "status": "500"
}

Resposta

Status: 503, Service unavailable

Nome	Tipo	Obrigatório
tipo	string	Verdadeiro
título	string	Verdadeiro
detalhe	string	Verdadeiro
status	string	Verdadeiro
ID de correlação	string	Falso

Nome

Tipo

Obrigatório

Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso

Exemplo de resposta

{
  "type": "https://astra.netapp.io/problems/41",
  "title": "Service not ready",
  "detail": "Currently, the service can't respond to this request.",
  "status": "503"
}

Erro

Status: 401, Unauthorized

Nome	Tipo	Obrigatório
tipo	string	Verdadeiro
título	string	Verdadeiro
detalhe	string	Verdadeiro
status	string	Verdadeiro
ID de correlação	string	Falso

Nome

Tipo

Obrigatório

Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso

Exemplo de resposta de erro

{
  "type": "https://astra.netapp.io/problems/3",
  "title": "Missing bearer token",
  "detail": "The request is missing the required bearer token.",
  "status": "401"
}

Definições

Ver definições

tipo_astra_label

Nome	Tipo	Obrigatório	Descrição
nome	string	Verdadeiro
valor	string	Verdadeiro

Nome

Tipo

Obrigatório

Descrição

nome

string

Verdadeiro

valor

string

Verdadeiro

type_astra_metadados_update

Metadados especificados pelo cliente e pelo serviço associados ao recurso. Os valores definidos são:

Conforme o esquema de metadados Astra. Se não for especificado na criação, um objeto de metadados será criado sem rótulos. Se não for especificado na atualização, os rótulos do objeto de metadados, creationTimestamp e createdBy, serão preservados sem modificação.

Nome	Tipo	Obrigatório
etiquetas	array["tipo_astra_label"]	Falso
CriaçãoTimestamp	string	Falso
Alteração do Timestamp	string	Falso
CreatedBy	string	Falso
modifiedBy	string	Falso

Nome

Tipo

Obrigatório

Descrição

etiquetas

array["tipo_astra_label"]

Falso

CriaçãoTimestamp

string

Falso

Alteração do Timestamp

string

Falso

CreatedBy

string

Falso

modifiedBy

string

Falso

type_astra_stateTransition

Nome	Tipo	Obrigatório	Descrição
de	string	Verdadeiro
para	array[string]	Verdadeiro

Nome

Tipo

Obrigatório

Descrição

string

Verdadeiro

para

array[string]

Verdadeiro

additionalDetails

type_astra_stateDetail

Nome	Tipo	Obrigatório
tipo	string	Verdadeiro
título	string	Verdadeiro
detalhe	string	Verdadeiro
additionalDetails	"additionalDetails"	Falso

Nome

Tipo

Obrigatório

Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

additionalDetails

"additionalDetails"

Falso

invalidFields

Nome	Tipo	Obrigatório	Descrição
nome	string	Verdadeiro	Nome do campo inválido no corpo da requisição
razão	string	Verdadeiro	Motivo pelo qual o campo do corpo da solicitação é inválido

Nome

Tipo

Obrigatório

Descrição

nome

string

Verdadeiro

Nome do campo inválido no corpo da requisição

razão

string

Verdadeiro

Motivo pelo qual o campo do corpo da solicitação é inválido

Criar um novo certificado

Creating your file...

Parâmetros

Corpo da solicitação

Resposta

Resposta

Resposta

Resposta

Resposta

Erro

Definições