Skip to main content
Astra Automation
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 backend de almacenamiento

PDF

POST /accounts/{account_id}/topology/v1/storageBackends

Indica los valores deseados para el recurso Storage Backend API 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}}

Cuerpo de la solicitud

Indica los valores deseados para el recurso Storage Backend API que se va a crear.

Nombre Tipo Obligatorio Descripción

tipo

cadena

Verdadero

Tipo de medio del recurso. Los valores definidos son:

  • "application/astra-storageBackend"

versión

cadena

Verdadero

Versión del recurso. Los valores definidos son:

  • "1,0"

  • "1,1"

  • "1,2"

  • "1,3"

backendName

cadena

Falso

Cadena JSON que contiene un nombre especificado por el usuario para el backend de almacenamiento. Los valores definidos son:

  • Longitud mínima: 1

  • Longitud máxima: 63

backendType

cadena

Verdadero

Cadena JSON que contiene un valor que indica el tipo de backend de almacenamiento que se está representando. Los valores definidos son:

  • "ontap" - El backend de almacenamiento representa un sistema NetApp ONTAP

  • enum: ["ontap"]

  • ejemplo: ONTAP

backendVersion

cadena

Falso

Cadena JSON que contiene un valor que indica la versión del backend de almacenamiento que se está representando. Los valores definidos son:

  • Longitud mínima: 1

  • Longitud máxima: 63

backendCredentialsName

cadena

Falso

Cadena JSON que contiene un valor que indica el nombre de uno o más recursos de credenciales utilizados para el backend de almacenamiento. Permite la rotación de credenciales cuando varios objetos de credenciales tienen el mismo nombre. Los valores definidos son:

  • Longitud mínima: 1

  • Longitud máxima: 63

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-storageBackend",
  "version": "1.3",
  "backendName": "st1-45",
  "backendType": "ontap",
  "backendCredentialsName": "st1-45-cred"
}

Respuesta

Status: 201, Returns the newly created storageBackend 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-storageBackend"

versión

cadena

Verdadero

Versión del recurso. Los valores definidos son:

  • "1,0"

  • "1,1"

  • "1,2"

  • "1,3"

id

cadena

Verdadero

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

  • Cumple con el esquema UUIDv4

backendName

cadena

Verdadero

Cadena JSON que contiene un nombre especificado por el usuario para el backend de almacenamiento. Los valores definidos son:

  • Longitud mínima: 1

  • Longitud máxima: 63

backendType

cadena

Verdadero

Cadena JSON que contiene un valor que indica el tipo de backend de almacenamiento que se está representando. Los valores definidos son:

  • "ontap" - El backend de almacenamiento representa un sistema NetApp ONTAP

  • enum: ["ontap"]

  • ejemplo: ONTAP

backendVersion

cadena

Verdadero

Cadena JSON que contiene un valor que indica la versión del backend de almacenamiento que se está representando. Los valores definidos son:

  • Longitud mínima: 1

  • Longitud máxima: 63

backendCredentialsName

cadena

Verdadero

Cadena JSON que contiene un valor que indica el nombre de uno o más recursos de credenciales utilizados para el backend de almacenamiento. Permite la rotación de credenciales cuando varios objetos de credenciales tienen el mismo nombre. Los valores definidos son:

  • Longitud mínima: 1

  • Longitud máxima: 63

configVersion

cadena

Falso

Cadena JSON que contiene un valor que indica la configuración activa que utilizará el backend de almacenamiento. Los valores definidos son:

  • Longitud mínima: 1

  • Longitud máxima: 63

estado

cadena

Verdadero

Cadena JSON que contiene un valor que indica el estado operativo del backend de almacenamiento. Los valores definidos son:

  • "descubierto" - El backend de almacenamiento ha sido descubierto desde un cluster gestionado

  • "running" - El backend de almacenamiento está funcionando con normalidad

  • "desconocido" - No se puede determinar el estado del backend de almacenamiento

  • "failed" - El backend de almacenamiento está en un estado no disponible

stateDesired

cadena

Falso

Cadena JSON que contiene un valor que indica el estado operativo deseado del backend de almacenamiento. Los valores definidos son:

  • "running" - El backend de almacenamiento estará en un estado de ejecución normal

stateUnready

array[string]

Verdadero

Matriz JSON de cadenas JSON, cada una de las cuales indica un motivo por el que un backend de almacenamiento no puede pasar a "en ejecución", por el que ha pasado a "fallido" o "desconocido", y/o por el que corre el riesgo de pasar a "fallido". Los valores definidos son:

  • Longitud mínima: 1

  • Longitud máxima: 127

managedState

cadena

Verdadero

Cadena JSON que contiene un valor que indica el estado de gestión del backend de almacenamiento. Los valores definidos son:

  • "pendiente" - El backend de almacenamiento está programado para ser descubierto o añadido

  • "no gestionado" - El backend de almacenamiento está en estado "descubierto", no está bajo gestión y es elegible para gestión

  • "managed" - El backend de almacenamiento se encuentra en estado "running" o "unknown" y está bajo gestión

managedStateUnready

array[string]

Verdadero

Matriz JSON de cadenas JSON, cada una de las cuales indica un motivo por el que el backend de almacenamiento no puede gestionarse. Los valores definidos son:

  • Longitud mínima: 1

  • Longitud máxima: 127

healthState

cadena

Falso

Cadena JSON que contiene un valor que indica el estado de salud del backend de almacenamiento. Los valores definidos son:

  • "indeterminado" - No se puede determinar la salud del recurso (por ejemplo, por falta de conectividad)

  • "normal" - El recurso no tiene problemas conocidos y puede prestar servicios de acuerdo con la especificación de la interfaz

  • "advertencia" - El recurso tiene problemas conocidos que no le impiden prestar servicios de acuerdo con la especificación de la interfaz

  • "crítico" - El recurso tiene problemas conocidos que le impiden prestar servicios de acuerdo con la especificación de la interfaz

healthStateUnready

array[string]

Falso

Matriz JSON de cadenas JSON, cada una de las cuales indica un motivo por el que un backend de almacenamiento no se encuentra en un estado de salud normal. Los valores definidos son:

  • Longitud mínima: 1

  • Longitud máxima: 127

protectionState

cadena

Verdadero

Cadena JSON que contiene un valor que indica el estado de protección del backend de almacenamiento. "unknown" para ONTAP. Los valores definidos son:

  • "protected" - El backend de almacenamiento tiene definida una política de protección y está en conformidad con esa política

  • "parcial": el backend de almacenamiento tiene definida una política de protección pero no se ajusta a esa política

  • "none" - El backend de almacenamiento no está protegido

  • "desconocido" - No se puede determinar la conformidad de la política de protección del backend de almacenamiento

  • enum: ["protegido", "parcial", "ninguno", "desconocido"]

  • ejemplo: protegido

protectionStateUnready

array[string]

Verdadero

Matriz JSON de cadenas JSON, cada una de las cuales indica una razón por la que una política de protección no es conforme. Los valores definidos son:

  • Longitud mínima: 1

  • Longitud máxima: 127

capacidades

"capacidades"

Verdadero

Objeto JSON que contiene las capacidades de este Storage Backend.

ONTAP

"ONTAP"

Falso

Objeto JSON que contiene información específica relacionada con los clusters ONTAP.

  • additionalProperties: falso

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-storageBackend",
  "version": "1.3",
  "id": "04ad4237-3c89-5ca5-8a40-282ab5eb6428",
  "backendName": "st1-45",
  "backendType": "ontap",
  "backendVersion": "9.8",
  "backendCredentialsName": "st1-45-cred",
  "state": "running",
  "stateUnready": [],
  "managedState": "managed",
  "managedStateUnready": [],
  "protectionState": "unknown",
  "protectionStateUnready": [
    "Waiting for storage backend discovery"
  ],
  "ontap": {
    "authenticationStyle": "basic",
    "backendManagementIP": "10.193.179.105",
    "managementIPs": [
      "10.193.188.110",
      "10.193.179.105",
      "10.193.179.106"
    ]
  },
  "capabilities": {
    "flexClone": "true",
    "snapMirror": "true",
    "s3": "true"
  },
  "metadata": {
    "labels": [],
    "creationTimestamp": "2022-10-06T20:58:16.305662Z",
    "modificationTimestamp": "2022-10-06T20:58:16.305662Z",
    "createdBy": "8f84cf09-8036-51e4-b579-bd30cb07b269"
  }
}

Respuesta

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

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

Respuesta

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

Respuesta

Status: 403, Forbidden
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"
}

Error

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

Definiciones

Ver definiciones

etiqueta_tipo_astra

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 Descripción

etiquetas

array["etiqueta_tipo_astra"]

Falso

CreationTimestamp

cadena

Falso

Modificación.Marca de hora

cadena

Falso

CreatedBy

cadena

Falso

modifiedBy

cadena

Falso

capacidades

Objeto JSON que contiene las capacidades de este Storage Backend.

Nombre Tipo Obligatorio Descripción

FlexClone

cadena

Verdadero

Cadena JSON que indica si este backend de almacenamiento admite FlexClone.

SnapMirror

cadena

Verdadero

Cadena JSON que indica si este backend de almacenamiento admite SnapMirror.

s3

cadena

Verdadero

Cadena JSON que indica si este Storage Backend soporta s3.

ONTAP

Objeto JSON que contiene información específica relacionada con los clusters ONTAP.

Nombre Tipo Obligatorio Descripción

authenticationStyle

cadena

Verdadero

Cadena JSON que indica si la autenticación de ONTAP se realiza mediante una combinación de nombre de usuario y contraseña o mediante un certificado. Los valores definidos son:

  • "basic" - Utiliza nombre de usuario/contraseña

  • "certificado" - Usa certificado

  • enum: ["basic", "certificate"]

  • ejemplo: básico

backendManagementIP

cadena

Falso

Cadena JSON que contiene la dirección IP utilizada para conectarte a este cluster ONTAP.

managementIPs

array[string]

Falso

Matriz JSON de cadenas JSON que contiene la lista de todas las posibles direcciones IP de gestión utilizadas para conectarse a este clúster ONTAP. Esto se utiliza para correlacionar los backends detectados a través de Trident y los backends de almacenamiento en Astra.

  • uniqueItems: 1

invalidParams

Nombre Tipo Obligatorio Descripción

nombre

cadena

Verdadero

Nombre del parámetro de consulta no válido

motivo

cadena

Verdadero

Razón por la que el parámetro de consulta no es válido

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