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.

Enumera los clústeres de una nube

PDF

GET /accounts/{account_id}/topology/v1/clouds/{cloud_id}/clusters

Devuelve una matriz JSON de todos los recursos coincidentes de la colección. Si se especifican campos individuales en la solicitud, la matriz JSON de elementos contendrá los campos solicitados para cada recurso coincidente en el orden especificado.

Parámetros

Nombre Tipo En Obligatorio Descripción

account_id

cadena

ruta

Verdadero

ID del recurso de cuenta que lo contiene

  • ejemplo: {{.Account}}

cloud_id

cadena

ruta

Verdadero

ID del recurso de nube que lo contiene

incluya

cadena

consulta

Falso

Indica qué campos deben devolverse al listar una colección.

Ejemplos de URL: "include=id", "include=id,name"

Ejemplos OpenAPI: "id"

  • ejemplo: id,name,managedState

límite

cadena

consulta

Falso

Indica el número máximo de recursos a devolver al listar una colección.

Ejemplos de URL: "limit=2"

Ejemplos OpenAPI: "2"

filtro

cadena

consulta

Falso

Indica qué campos deben coincidir para devolver un recurso al listar una colección.

Los operadores admitidos son:

  • eq - Igualdad

  • lt/gt - Menor que/Mayor que

  • lte/gte - Menor o igual que/Mayor o igual que

Ejemplo de URL: "filter=field%20eq%20%27value%27"

Ejemplos OpenAPI: "field eq 'value'"

Respuesta

Status: 200, Returns a JSON array of all matching resources in the collection. If individual fields are specified in the request, the items JSON array will contain the fields requested for each matching resource in the order specified.
Nombre Tipo Obligatorio Descripción

artículos

array[Cualquiera de: "cluster_1.7_get_response_body", array[]]

Verdadero

metadatos

"type_astra_metadata_list"

Verdadero
Ejemplo de respuesta 
{
  "type": "application/astra-clusters",
  "version": "1.7",
  "items": [
    [
      "0f284377-e5dc-4dcd-bacd-3197f2b8a347",
      "GKE-21",
      "managed"
    ],
    [
      "04dc80fa-d1d8-4850-a49f-3b70d0ec1369",
      "GKE-22",
      "unmanaged"
    ]
  ],
  "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

invalidParams

matriz["invalidParams"]

Falso

Lista de parámetros de consulta 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: 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

additionalDetails

type_astra_stateDetail

Nombre Tipo Obligatorio Descripción

tipo

cadena

Verdadero

título

cadena

Verdadero

detalle

cadena

Verdadero

additionalDetails

"additionalDetails"

Falso

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

cluster_1.7_get_response_body

Nombre Tipo Obligatorio Descripción

tipo

cadena

Verdadero

Tipo de medio del recurso. Los valores definidos son:

  • "application/astra-cluster"

versión

cadena

Verdadero

Versión del recurso. Los valores definidos son:

  • "1,0"

  • "1,1"

  • "1,2"

  • "1,3"

  • "1,4"

  • "1,5"

  • "1,6"

  • "1,7"

id

cadena

Verdadero

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

  • Cumple con el esquema UUIDv4

nombre

cadena

Verdadero

Cadena JSON que contiene un nombre para el clúster. Si no se especifica, se utilizará el nombre de Kubernetes del clúster. Los valores definidos son:

  • Longitud mínima: 1

  • Longitud máxima: 63

  • Esta cadena se valida internamente para evitar ataques XSS, Unicode, de traspaso de directorios y de inyección SQL

estado

cadena

Verdadero

Cadena JSON que contiene un valor que indica el estado operativo del clúster. Los valores definidos son:

  • "pendiente" - El clúster está programado para ser descubierto

  • "descubriendo" - El clúster está en proceso de ser descubierto

  • "provisioning" - El cluster está en proceso de aprovisionamiento

  • "running" - El clúster funciona con normalidad

  • "failed" - El clúster está en un estado de fallo permanente

  • "eliminado" - El clúster no es accesible actualmente

  • "desconocido" - No se puede determinar el estado del clúster

stateUnready

array[string]

Verdadero

Matriz JSON de cadenas JSON, cada una indica un motivo por el que el clúster no puede pasar al estado "en ejecución" cuando hay problemas mientras está en estado "en ejecución" o por qué ha pasado al estado "fallido" o "eliminado". 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 clúster. Los valores definidos son:

  • "pendiente" - El clúster está programado para ser descubierto o añadido

  • "ineligible" - El cluster está en estado "running", no está bajo gestión y no es elegible para gestión. Las razones de esta inelegibilidad se proporcionan en el valor clave unready

  • "borrando" - El clúster está en proceso de ser eliminado

  • "unmanaged" - El cluster está en estado "running" o "failed", no está bajo gestión y es elegible para gestión

  • "gestionando" - El clúster está en estado "en ejecución" y está en proceso de ser gestionado

  • "managed" - El clúster se encuentra en estado "running", "failed" o "removed" y está bajo gestión

managedStateDetails

array["type_astra_stateDetail"]

Falso

Matriz JSON de objetos JSON que enumera detalles adicionales sobre el estado actual, incluyendo por qué se alcanzó el estado actual. Si no hay detalles disponibles, esta matriz estará vacía. Los valores definidos son:

  • Artículos mínimos: 0

protectionState

cadena

Verdadero

Cadena JSON que contiene un valor que indica el estado de protección del clúster. Los valores definidos son:

  • "full" - La clase de almacenamiento por defecto del clúster soporta snapshots

  • "parcial" - El clúster solo tiene storageClasses que no admiten instantáneas

  • "atRisk" - La clase de almacenamiento predeterminada del clúster no admite instantáneas

protectionStateDetails

array["type_astra_stateDetail"]

Verdadero

Matriz JSON de objetos JSON que enumera detalles adicionales sobre el estado de protección actual, incluyendo por qué se alcanzó el estado actual. Si no hay detalles disponibles, esta matriz estará vacía. Los valores definidos son:

  • Artículos mínimos: 0

restoreTargetSupported

cadena

Falso

Cadena JSON que contiene un valor que indica la capacidad del clúster para ser objetivo de operaciones de gestión de datos de aplicaciones. Los valores definidos son:

  • "true" - El clúster es un objetivo elegible para las operaciones de gestión de datos de la app.

  • "false" - El clúster no es un objetivo elegible para las operaciones de gestión de datos de la app.

snapshotSupported

cadena

Falso

Cadena JSON que contiene un valor que indica la capacidad del clúster para realizar operaciones de tipo copia de seguridad de gestión de datos de aplicaciones. Los valores definidos son:

  • "true" - El clúster es elegible para realizar operaciones de gestión de datos de la app.

  • "false" - El clúster no es apto para realizar operaciones de gestión de datos de la app.

managedStateUnready

array[string]

Verdadero

Matriz JSON de cadenas JSON, cada una de las cuales indica una razón por la que el clúster no es elegible para ser gestionado, o que el clúster está gestionado pero se han encontrado errores no fatales mientras se gestionaba el clúster. Los valores definidos son:

  • Longitud mínima: 1

  • Longitud máxima: 127

managedTimestamp

cadena

Falso

Cadena JSON que contiene la marca de tiempo que indica cuándo el clúster se puso bajo gestión. Los valores definidos son:

  • Conforme al esquema de fecha y hora ISO-8601 Esta clave solo se devuelve cuando un clúster tiene un managedState de "managed".

tridentVersion

cadena

Falso

Cadena JSON que contiene la versión de Trident instalada en el clúster. Los valores definidos son:

  • Conforme al esquema de versiones de software

acpVersion

cadena

Falso

Cadena JSON que contiene la versión de Astra Control Provisioner instalada en el clúster. Los valores definidos son:

  • Conforme al esquema de versiones de software

tridentManagedState

cadena

Falso

Cadena JSON que contiene uno de un conjunto de valores enumerados que indican el estado de gestión de Trident en este clúster. Los valores definidos son:

  • "managed" - La instancia de Trident en el clúster es gestionada por Astra

  • "unmanaged" - La instancia de Trident en el clúster no está gestionada por Astra

tridentManagedStateDesired

cadena

Falso

Cadena JSON que contiene un valor que indica el estado de gestión deseado para Trident. Los valores definidos son:

  • "managed" - Gestiona Trident en este clúster

  • "unmanaged" - No gestionar Trident en este clúster

tridentManagedStateDetails

array["type_astra_stateDetail"]

Falso

Matriz JSON de objetos JSON que enumera detalles adicionales sobre por qué el estado pasó a "managed" o "unmanaged". + Si no hay detalles disponibles, esta matriz estará vacía.

  • Elementos mínimos: 0

tridentManagedStateAllowed

array[string]

Falso

Estados que pueden solicitarse en un determinado tridentManagedState. Los siguientes estados pueden solicitarse en cada estado definido:

  • "managed": "gestionado"

  • "unmanaged": "no gestionado"

inUse

cadena

Verdadero

Cadena JSON que contiene un valor que indica si el clúster tiene alguna aplicación gestionada y, por lo tanto, no se puede eliminar. Los valores definidos son:

  • "false" - El clúster no está gestionado o está gestionado pero no tiene aplicaciones gestionadas asociadas

  • "true" - El clúster está gestionado y tiene aplicaciones gestionadas asociadas con él

accHost

cadena

Falso

Cadena JSON que indica que este cluster aloja la instancia de Astra Control Center a la que se está accediendo actualmente. Los valores definidos son:

  • "true" - Este clúster aloja la instancia de Astra Control Center a la que se está accediendo actualmente.

clusterType

cadena

Verdadero

Cadena JSON que contiene un valor que indica el tipo de clúster. Los valores definidos son:

  • "gke" - Kubernetes alojado en Google Kubernetes Engine

  • "aks" - Kubernetes alojado en Microsoft Azure Kubernetes Service

  • "eks" - Kubernetes alojado en Amazon Elastic Kubernetes Service

  • "rke" - El clúster es de tipo Rancher

  • "tanzu" -El clúster es de tipo Tanzu Kubernetes Grid

  • "openshift" - El clúster es de tipo OpenShift

  • "anthos" - El clúster es de tipo GKE Anthos

  • "kubernetes" - El clúster es Kubernetes genérico

clusterVersion

cadena

Falso

Cadena JSON que contiene un valor que indica la representación semántica de versiones del entorno de clúster. Para clústeres Kubernetes, esta es la versión de Kubernetes. Los valores definidos son:

  • Longitud mínima: 1

  • Longitud máxima: 31

clusterVersionString

cadena

Falso

Cadena JSON que contiene un valor que indica la información de versionado ampliada para el entorno de clúster. Para los clústeres Kubernetes, esta es la versión completa de Kubernetes. Los valores definidos son:

  • Longitud mínima: 1

  • Longitud máxima: 31

clusterCreationTimestamp

cadena

Falso

Cadena JSON que contiene la marca de tiempo que indica cuándo se creó originalmente el clúster. Los valores definidos son:

  • Cumple con el esquema de fecha y hora ISO-8601

espacios de nombres

array[string]

Falso

Matriz JSON de cadenas JSON, cada una de las cuales indica un espacio de nombres dentro del clúster. Los valores definidos son:

  • Longitud mínima: 1

  • Longitud máxima: 253

defaultStorageClass

cadena

Falso

Cadena JSON que contiene un ID de clase de almacenamiento que corresponde a la clase de almacenamiento predeterminada establecida en Kubernetes. Los valores definidos son:

  • Cumple con el esquema del identificador Astra

cloudID

cadena

Verdadero

Cadena JSON que contiene un valor que indica el ID de la nube en la que se ejecuta el clúster. Los valores definidos son:

  • Cumple con el esquema del identificador Astra

credentialID

cadena

Falso

Cadena JSON que contiene un valor que indica el ID de la credencial que contiene el archivo kubeconfig para el clúster. Los valores definidos son:

  • Conforme al Astra Identifier Schema si se proporcionan privateRouteID y connectorCapabilities con la opción connectorV2, credentialID es opcional. Si no se proporcionan, credentialID es obligatorio, de lo contrario, se genera un error. Si se proporciona credentialID y un conector con capacidad de relay, se genera un error.

ubicación

cadena

Falso

Cadena JSON que contiene un valor proporcionado por la nube en la que se ejecuta el clúster, indicando la ubicación específica de la nube del clúster. Los valores definidos son:

  • Longitud mínima: 1

  • Longitud máxima: 63

isMultizonal

cadena

Falso

Cadena JSON que contiene un valor proporcionado por la nube en la que se ejecuta el clúster, indicando si el clúster abarca dos o más zonas de disponibilidad. Los valores definidos son:

  • "true" - El clúster abarca dos o más zonas de disponibilidad

  • "false" - El clúster se encuentra íntegramente dentro de una única zona de disponibilidad

privateRouteID

cadena

Falso

Cadena JSON que contiene el ID de ubicación de los clusters privados.

  • Longitud mínima: 1

  • Longitud máxima: 255

connectorCapabilities

array[string]

Falso

Capacidades del conector que está asociado con este clúster. Opcional para compatibilidad con versiones anteriores. Si no está presente, proxy es la capacidad asumida.

apiServiceID

cadena

Falso

Cadena JSON que contiene el UUID del objeto de servicio API de Kubernetes (k8s). Se utiliza para identificar un clúster de forma exclusiva.

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.

type_astra_metadata_list

Nombre Tipo Obligatorio Descripción

continuar

cadena

Falso

cuente

número

Falso

etiquetas

array["etiqueta_tipo_astra"]

Falso

CreationTimestamp

cadena

Falso

Modificación.Marca de hora

cadena

Falso

CreatedBy

cadena

Falso

modifiedBy

cadena

Falso

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