Skip to main content
Astra Automation
Uma versão mais recente deste produto está disponível.
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.

Modificar um certificado

PDFs

PUT /accounts/{account_id}/core/v1/certificates/{certificate_id}

Substitui todo o recurso armazenado pelo corpo da solicitação JSON fornecida.

Efeitos Colaterais

  • Um certificado de autoridade certificadora (CA) atualizado será atualizado no repositório de certificados confiáveis.

  • Se um certificado de CA confiável existente deixar de ser confiável, ele será removido do trust store.

  • Se o corpo do certificado for atualizado (campo "cert"), o indicador "isSelfSigned" deve ser incluído para indicar o estado do novo certificado. Se o indicador "isSelfSigned" não for incluído neste caso, o valor será definido como "false".

  • Se uma atualização não modificar o corpo do certificado (campo "cert"), o indicador "isSelfSigned" é opcional e o valor existente será mantido se não for fornecido.

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

certificate_id

string

caminho

Verdadeiro

ID da coleção de certificados a ser listada

Corpo da solicitação

Substitui todo o recurso armazenado pelo corpo da solicitação JSON fornecida.

Efeitos Colaterais

  • Um certificado de autoridade certificadora (CA) atualizado será atualizado no repositório de certificados confiáveis.

  • Se um certificado de CA confiável existente deixar de ser confiável, ele será removido do trust store.

  • Se o corpo do certificado for atualizado (campo "cert"), o indicador "isSelfSigned" deve ser incluído para indicar o estado do novo certificado. Se o indicador "isSelfSigned" não for incluído neste caso, o valor será definido como "false".

  • Se uma atualização não modificar o corpo do certificado (campo "cert"), o indicador "isSelfSigned" é opcional e o valor existente será mantido se não for fornecido.

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

Falso

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

  • Em conformidade com o esquema UUIDv4

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

Falso

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

Falso

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

Falso

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

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.

trustState

string

Falso

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

Falso

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

Falso

Matriz JSON de objetos JSON que lista detalhes adicionais sobre o estado de confiança do certificado. Se não houver detalhes disponíveis, essa matriz estará vazia.

  • Quantidade mínima de itens: 0

metadados

"type_astra_metadados_update"

Falso

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

  • Está em conformidade com 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",
  "trustStateDesired": "trusted"
}

Resposta

Status: 204, Indicates if the certificate resource was updated.

Resposta

Status: 401, Unauthorized
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/3",
  "title": "Missing bearer token",
  "detail": "The request is missing the required bearer token.",
  "status": "401"
}

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
Exemplo de resposta 
{
  "type": "https://astra.netapp.io/problems/5",
  "title": "Invalid query parameters",
  "detail": "The supplied query parameters are invalid.",
  "status": "400"
}

Resposta

Status: 409, Conflict
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/10",
  "title": "JSON resource conflict",
  "detail": "The request body JSON contains a field that conflicts with an idempotent value.",
  "status": "409"
}

Resposta

Status: 403, Forbidden
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: 503, Service unavailable
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: 404, Not found
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/2",
  "title": "Collection not found",
  "detail": "The collection specified in the request URI wasn't found.",
  "status": "404"
}

Definições

Ver definições

type_astra_stateTransition

Nome Tipo Obrigatório Descrição

de

string

Verdadeiro

para

array[string]

Verdadeiro

additionalDetails

type_astra_stateDetail

Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

additionalDetails

"additionalDetails"

Falso

tipo_astra_label

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:

  • Está em conformidade com 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

etiquetas

array["tipo_astra_label"]

Falso

CriaçãoTimestamp

string

Falso

Alteração do Timestamp

string

Falso

CreatedBy

string

Falso

modifiedBy

string

Falso

invalidParams

Nome Tipo Obrigatório Descrição

nome

string

Verdadeiro

Nome do parâmetro de consulta inválido

razão

string

Verdadeiro

Motivo pelo qual o parâmetro de consulta é inválido

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