Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Crear un nuevo certificado

05/23/2026

PDF

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

Indica los valores deseados para el recurso API de certificado que se va a crear.

Parámetros

Nombre	Tipo	En	Obligatorio	Descripción
account_id	cadena	ruta	Verdadero	ID del recurso de cuenta que lo contiene ejemplo: {{.Account}}

Nombre

Tipo

Obligatorio

Descripción

account_id

cadena

ruta

Verdadero

ID del recurso de cuenta que lo contiene

ejemplo: {{.Account}}

Cuerpo de la solicitud

Indica los valores deseados para el recurso API de certificado que se va a crear.

Nombre	Tipo	Obligatorio	Descripción
tipo	cadena	Verdadero	Tipo de medio del recurso. Los valores definidos son: "application/astra-certificate"
versión	cadena	Verdadero	Versión del recurso. Los valores definidos son: "1,0" "1,1"
certUse	cadena	Falso	Cadena JSON que indica el uso del certificado. Si no se especifica, por defecto es "rootCA". Los valores definidos son: "rootCA" - El certificado es un certificado de autoridad de certificación (CA) utilizado para confiar en cualquier certificado firmado por esa CA. "intermediateCA" - El certificado es un certificado de CA intermedia emitido por una CA raíz.
cert	cadena	Verdadero	Cadena JSON que contiene un certificado con formato PKCS-11 codificado en base64 (PEM). Los valores definidos son: Conforme al esquema de datos codificados en base64
isSelfSigned	cadena	Falso	Cadena JSON que indica si el certificado es autofirmado. Si no se proporciona en la creación, el valor predeterminado es "false". En la actualización: Si se proporciona el valor, se utilizará ese valor. Si no se proporciona el valor y el campo "cert" se incluye en la actualización, el valor se establecerá en "false". Si no se proporciona el valor y el campo "cert" no se incluye en la actualización, se conservará el valor existente. Los valores definidos son: "true" - El certificado es autofirmado. "false" - El certificado no está autofirmado.
trustStateDesired	cadena	Falso	Cadena JSON que contiene un valor que indica si el certificado es de confianza. Si no se especifica al crearlo, el valor predeterminado es "trusted". Los valores definidos son: "no fiable" - El certificado no es fiable. "trusted" - El certificado está marcado como de confianza.
metadatos	"type_astra_metadatos_update"	Falso	Metadatos especificados por el cliente y el servicio asociados con el recurso. Los valores definidos son: Conforme al esquema de metadatos de Astra. Si no se especifica al crear, se creará un objeto de metadatos sin etiquetas. Si no se especifica al actualizar, las etiquetas del objeto de metadatos, creationTimestamp y createdBy, se conservarán sin modificaciones.

Nombre

Tipo

Obligatorio

Descripción

tipo

cadena

Verdadero

Tipo de medio del recurso. Los valores definidos son:

"application/astra-certificate"

versión

cadena

Verdadero

Versión del recurso. Los valores definidos son:

"1,0"
"1,1"

certUse

cadena

Falso

Cadena JSON que indica el uso del certificado. Si no se especifica, por defecto es "rootCA". Los valores definidos son:

"rootCA" - El certificado es un certificado de autoridad de certificación (CA) utilizado para confiar en cualquier certificado firmado por esa CA.
"intermediateCA" - El certificado es un certificado de CA intermedia emitido por una CA raíz.

cert

cadena

Verdadero

Cadena JSON que contiene un certificado con formato PKCS-11 codificado en base64 (PEM). Los valores definidos son:

Conforme al esquema de datos codificados en base64

isSelfSigned

cadena

Falso

Cadena JSON que indica si el certificado es autofirmado. Si no se proporciona en la creación, el valor predeterminado es "false". En la actualización:

Si se proporciona el valor, se utilizará ese valor.
Si no se proporciona el valor y el campo "cert" se incluye en la actualización, el valor se establecerá en "false".
Si no se proporciona el valor y el campo "cert" no se incluye en la actualización, se conservará el valor existente. Los valores definidos son:
"true" - El certificado es autofirmado.
"false" - El certificado no está autofirmado.

trustStateDesired

cadena

Falso

Cadena JSON que contiene un valor que indica si el certificado es de confianza. Si no se especifica al crearlo, el valor predeterminado es "trusted". Los valores definidos son:

"no fiable" - El certificado no es fiable.
"trusted" - El certificado está marcado como de confianza.

metadatos

"type_astra_metadatos_update"

Falso

Metadatos especificados por el cliente y el servicio asociados con el recurso. Los valores definidos son:

Conforme al esquema de metadatos de Astra. Si no se especifica al crear, se creará un objeto de metadatos sin etiquetas. Si no se especifica al actualizar, las etiquetas del objeto de metadatos, creationTimestamp y createdBy, se conservarán sin modificaciones.

Ejemplo de solicitud

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

Respuesta

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

Nombre	Tipo	Obligatorio	Descripción
tipo	cadena	Verdadero	Tipo de medio del recurso. Los valores definidos son: "application/astra-certificate"
versión	cadena	Verdadero	Versión del recurso. Los valores definidos son: "1,0" "1,1"
id	cadena	Verdadero	Identificador único global del recurso. Los valores definidos son: Cumple con el esquema UUIDv4
certUse	cadena	Verdadero	Cadena JSON que indica el uso del certificado. Si no se especifica, por defecto es "rootCA". Los valores definidos son: "rootCA" - El certificado es un certificado de autoridad de certificación (CA) utilizado para confiar en cualquier certificado firmado por esa CA. "intermediateCA" - El certificado es un certificado de CA intermedia emitido por una CA raíz.
cert	cadena	Verdadero	Cadena JSON que contiene un certificado con formato PKCS-11 codificado en base64 (PEM). Los valores definidos son: Conforme al esquema de datos codificados en base64
cn	cadena	Verdadero	Cadena JSON que contiene un nombre común extraído del certificado. Los valores definidos son: Longitud mínima: 1 Longitud máxima: 511
expiryTimestamp	cadena	Verdadero	Cadena JSON que contiene una marca de tiempo que indica cuándo caduca el certificado. Los valores definidos son: Cumple con el esquema de fecha y hora ISO-8601
isSelfSigned	cadena	Verdadero	Cadena JSON que indica si el certificado es autofirmado. Si no se proporciona en la creación, el valor predeterminado es "false". En la actualización: Si se proporciona el valor, se utilizará ese valor. Si no se proporciona el valor y el campo "cert" se incluye en la actualización, el valor se establecerá en "false". Si no se proporciona el valor y el campo "cert" no se incluye en la actualización, se conservará el valor existente. Los valores definidos son: "true" - El certificado es autofirmado. "false" - El certificado no está autofirmado.
trustState	cadena	Verdadero	Cadena JSON que contiene uno de un conjunto de valores enumerados que indican si el certificado es de confianza. Los valores definidos son: "no fiable" - El certificado no es fiable. "trusted" - El certificado está marcado como de confianza. "caducado" - El certificado ha caducado, por lo que no es ni de confianza ni de no confianza.
trustStateTransitions	array["type_astra_stateTransition"]	Verdadero	Matriz JSON de objetos JSON, cada uno de los cuales representa el conjunto de transiciones de estado permitidas desde un estado definido dado. Cada objeto JSON contiene los campos "from" y "to", donde el valor "from" es el nombre de un estado y el valor "to" es una matriz de estados de destino permitidos.
trustStateDesired	cadena	Falso	Cadena JSON que contiene un valor que indica si el certificado es de confianza. Si no se especifica al crearlo, el valor predeterminado es "trusted". Los valores definidos son: "no fiable" - El certificado no es fiable. "trusted" - El certificado está marcado como de confianza.
trustStateDetails	array["type_astra_stateDetail"]	Verdadero	Matriz JSON de objetos JSON que enumera detalles adicionales sobre el estado de confianza del certificado. Si no hay detalles disponibles, esta matriz estará vacía. Artículos mínimos: 0
metadatos	"type_astra_metadatos_update"	Verdadero	Metadatos especificados por el cliente y el servicio asociados con el recurso. Los valores definidos son: Conforme al esquema de metadatos de Astra. Si no se especifica al crear, se creará un objeto de metadatos sin etiquetas. Si no se especifica al actualizar, las etiquetas del objeto de metadatos, creationTimestamp y createdBy, se conservarán sin modificaciones.

Nombre

Tipo

Obligatorio

Descripción

tipo

cadena

Verdadero

Tipo de medio del recurso. Los valores definidos son:

"application/astra-certificate"

versión

cadena

Verdadero

Versión del recurso. Los valores definidos son:

"1,0"
"1,1"

cadena

Verdadero

Identificador único global del recurso. Los valores definidos son:

Cumple con el esquema UUIDv4

certUse

cadena

Verdadero

Cadena JSON que indica el uso del certificado. Si no se especifica, por defecto es "rootCA". Los valores definidos son:

"rootCA" - El certificado es un certificado de autoridad de certificación (CA) utilizado para confiar en cualquier certificado firmado por esa CA.
"intermediateCA" - El certificado es un certificado de CA intermedia emitido por una CA raíz.

cert

cadena

Verdadero

Cadena JSON que contiene un certificado con formato PKCS-11 codificado en base64 (PEM). Los valores definidos son:

Conforme al esquema de datos codificados en base64

cadena

Verdadero

Cadena JSON que contiene un nombre común extraído del certificado. Los valores definidos son:

Longitud mínima: 1
Longitud máxima: 511

expiryTimestamp

cadena

Verdadero

Cadena JSON que contiene una marca de tiempo que indica cuándo caduca el certificado. Los valores definidos son:

Cumple con el esquema de fecha y hora ISO-8601

isSelfSigned

cadena

Verdadero

Cadena JSON que indica si el certificado es autofirmado. Si no se proporciona en la creación, el valor predeterminado es "false". En la actualización:

Si se proporciona el valor, se utilizará ese valor.
Si no se proporciona el valor y el campo "cert" se incluye en la actualización, el valor se establecerá en "false".
Si no se proporciona el valor y el campo "cert" no se incluye en la actualización, se conservará el valor existente. Los valores definidos son:
"true" - El certificado es autofirmado.
"false" - El certificado no está autofirmado.

trustState

cadena

Verdadero

Cadena JSON que contiene uno de un conjunto de valores enumerados que indican si el certificado es de confianza. Los valores definidos son:

"no fiable" - El certificado no es fiable.
"trusted" - El certificado está marcado como de confianza.
"caducado" - El certificado ha caducado, por lo que no es ni de confianza ni de no confianza.

trustStateTransitions

array["type_astra_stateTransition"]

Verdadero

Matriz JSON de objetos JSON, cada uno de los cuales representa el conjunto de transiciones de estado permitidas desde un estado definido dado. Cada objeto JSON contiene los campos "from" y "to", donde el valor "from" es el nombre de un estado y el valor "to" es una matriz de estados de destino permitidos.

trustStateDesired

cadena

Falso

Cadena JSON que contiene un valor que indica si el certificado es de confianza. Si no se especifica al crearlo, el valor predeterminado es "trusted". Los valores definidos son:

"no fiable" - El certificado no es fiable.
"trusted" - El certificado está marcado como de confianza.

trustStateDetails

array["type_astra_stateDetail"]

Verdadero

Matriz JSON de objetos JSON que enumera detalles adicionales sobre el estado de confianza del certificado. Si no hay detalles disponibles, esta matriz estará vacía.

Artículos mínimos: 0

metadatos

"type_astra_metadatos_update"

Verdadero

Metadatos especificados por el cliente y el servicio asociados con el recurso. Los valores definidos son:

Conforme al esquema de metadatos de Astra. Si no se especifica al crear, se creará un objeto de metadatos sin etiquetas. Si no se especifica al actualizar, las etiquetas del objeto de metadatos, creationTimestamp y createdBy, se conservarán sin modificaciones.

Ejemplo de respuesta

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

Respuesta

Status: 400, Bad request

Nombre	Tipo	Obligatorio	Descripción
tipo	cadena	Verdadero
título	cadena	Verdadero
detalle	cadena	Verdadero
estado	cadena	Verdadero
correlationID	cadena	Falso
invalidFields	array["invalidFields"]	Falso	Lista de campos del cuerpo de la solicitud no válidos

Nombre

Tipo

Obligatorio

Descripción

tipo

cadena

Verdadero

título

cadena

Verdadero

detalle

cadena

Verdadero

estado

cadena

Verdadero

correlationID

cadena

Falso

invalidFields

array["invalidFields"]

Falso

Lista de campos del cuerpo de la solicitud no válidos

Ejemplo de respuesta

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

Respuesta

Status: 403, Forbidden

Nombre	Tipo	Obligatorio
tipo	cadena	Verdadero
título	cadena	Verdadero
detalle	cadena	Verdadero
estado	cadena	Verdadero
correlationID	cadena	Falso

Nombre

Tipo

Obligatorio

Descripción

tipo

cadena

Verdadero

título

cadena

Verdadero

detalle

cadena

Verdadero

estado

cadena

Verdadero

correlationID

cadena

Falso

Ejemplo de respuesta

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

Respuesta

Status: 500, Internal server error

Nombre	Tipo	Obligatorio
tipo	cadena	Verdadero
título	cadena	Verdadero
detalle	cadena	Verdadero
estado	cadena	Verdadero
correlationID	cadena	Falso

Nombre

Tipo

Obligatorio

Descripción

tipo

cadena

Verdadero

título

cadena

Verdadero

detalle

cadena

Verdadero

estado

cadena

Verdadero

correlationID

cadena

Falso

Ejemplo de respuesta

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

Respuesta

Status: 503, Service unavailable

Nombre	Tipo	Obligatorio
tipo	cadena	Verdadero
título	cadena	Verdadero
detalle	cadena	Verdadero
estado	cadena	Verdadero
correlationID	cadena	Falso

Nombre

Tipo

Obligatorio

Descripción

tipo

cadena

Verdadero

título

cadena

Verdadero

detalle

cadena

Verdadero

estado

cadena

Verdadero

correlationID

cadena

Falso

Ejemplo de respuesta

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

Error

Status: 401, Unauthorized

Nombre	Tipo	Obligatorio
tipo	cadena	Verdadero
título	cadena	Verdadero
detalle	cadena	Verdadero
estado	cadena	Verdadero
correlationID	cadena	Falso

Nombre

Tipo

Obligatorio

Descripción

tipo

cadena

Verdadero

título

cadena

Verdadero

detalle

cadena

Verdadero

estado

cadena

Verdadero

correlationID

cadena

Falso

Ejemplo de respuesta de error

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

Definiciones

Ver definiciones

etiqueta_tipo_astra

Nombre	Tipo	Obligatorio	Descripción
nombre	cadena	Verdadero
valor	cadena	Verdadero

Nombre

Tipo

Obligatorio

Descripción

nombre

cadena

Verdadero

valor

cadena

Verdadero

type_astra_metadatos_update

Metadatos especificados por el cliente y el servicio asociados con el recurso. Los valores definidos son:

Conforme al esquema de metadatos de Astra. Si no se especifica al crear, se creará un objeto de metadatos sin etiquetas. Si no se especifica al actualizar, las etiquetas del objeto de metadatos, creationTimestamp y createdBy, se conservarán sin modificaciones.

Nombre	Tipo	Obligatorio
etiquetas	array["etiqueta_tipo_astra"]	Falso
CreationTimestamp	cadena	Falso
Modificación.Marca de hora	cadena	Falso
CreatedBy	cadena	Falso
modifiedBy	cadena	Falso

Nombre

Tipo

Obligatorio

Descripción

etiquetas

array["etiqueta_tipo_astra"]

Falso

CreationTimestamp

cadena

Falso

Modificación.Marca de hora

cadena

Falso

CreatedBy

cadena

Falso

modifiedBy

cadena

Falso

type_astra_stateTransition

Nombre	Tipo	Obligatorio	Descripción
de	cadena	Verdadero
a	array[string]	Verdadero

Nombre

Tipo

Obligatorio

Descripción

cadena

Verdadero

array[string]

Verdadero

additionalDetails

type_astra_stateDetail

Nombre	Tipo	Obligatorio
tipo	cadena	Verdadero
título	cadena	Verdadero
detalle	cadena	Verdadero
additionalDetails	"additionalDetails"	Falso

Nombre

Tipo

Obligatorio

Descripción

tipo

cadena

Verdadero

título

cadena

Verdadero

detalle

cadena

Verdadero

additionalDetails

"additionalDetails"

Falso

invalidFields

Nombre	Tipo	Obligatorio	Descripción
nombre	cadena	Verdadero	Nombre del campo no válido del cuerpo de la solicitud
motivo	cadena	Verdadero	Motivo por el que el campo del cuerpo de la solicitud no es válido

Nombre

Tipo

Obligatorio

Descripción

nombre

cadena

Verdadero

Nombre del campo no válido del cuerpo de la solicitud

motivo

cadena

Verdadero

Motivo por el que el campo del cuerpo de la solicitud no es válido

Crear un nuevo certificado

Creating your file...

Parámetros

Cuerpo de la solicitud

Respuesta

Respuesta

Respuesta

Respuesta

Respuesta

Error

Definiciones