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.

Recuperar um nó de cluster para um cluster

PDFs

GET /accounts/{account_id}/topology/v1/clusters/{cluster_id}/clusterNodes/{clusterNode_id}

Retorna o recurso da API Cluster Node armazenado no corpo da resposta JSON.

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

cluster_id

string

caminho

Verdadeiro

ID do recurso de cluster que o contém

clusterNode_id

string

caminho

Verdadeiro

ID da coleção clusterNode a ser listada

Resposta

Status: 200, Returns the stored Cluster Node API 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:

  • "aplicação/astra-clusterNode"

versão

string

Verdadeiro

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

  • "1,0"

id

string

Verdadeiro

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

  • Em conformidade com o esquema UUIDv4

nome

string

Verdadeiro

String JSON contendo um valor que indica o nome do nó no Kubernetes. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 254

papel

string

Verdadeiro

String JSON contendo um valor que indica a função do Kubernetes para o nó. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 254

etiquetas

array["etiquetas"]

Verdadeiro

Matriz JSON de objetos JSON, cada um contendo rótulos do Kubernetes associados ao nó. Se não houver detalhes disponíveis, essa matriz estará vazia.

  • Itens mínimos: 0

creationTime

string

Verdadeiro

String JSON contendo um timestamp ISO 8601 que indica quando o nó foi criado. Os valores definidos são:

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

IP externo

string

Verdadeiro

String JSON contendo um valor que indica o endereço IP interno do nó. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

IP interno

string

Verdadeiro

String JSON contendo um valor que indica o endereço IP externo do nó. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

zona

string

Verdadeiro

String JSON contendo um valor que indica a zona Kubernetes do nó. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 254

região

string

Verdadeiro

String JSON contendo um valor que indica a região do Kubernetes para o nó. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 254

instanceType

string

Verdadeiro

String JSON contendo um valor que indica o tipo de instância do Kubernetes para o nó. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 254

kernelVersion

string

Verdadeiro

String JSON contendo um valor que indica a versão do kernel usada pelo nó. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 254

osImage

string

Verdadeiro

String JSON contendo um valor que indica a imagem do sistema operacional usada pelo nó. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 254

numCpus

string

Verdadeiro

String JSON contendo um valor que indica o número de CPUs atribuídas ao nó. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 254

memória

string

Verdadeiro

String JSON contendo um valor que indica a quantidade de memória alocada ao nó. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 254

estado

string

Verdadeiro

String JSON contendo um valor que indica o estado operacional do nó. Os valores definidos são:

  • "Em execução" - O nó está em execução normalmente

  • "Provisionamento" - O nó está em processo de provisionamento

  • "Descobrindo" - Aspectos do nó estão em processo de descoberta

  • "Pendente" - O nó está agendado para descoberta

  • "failed" - O nó está em estado de falha

  • "Desconhecido" - O estado do nó não pode ser determinado

metadados

"tipo_metadados_astra"

Verdadeiro

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

  • Conforme o esquema de metadados Astra
Exemplo de resposta 
{
  "type": "application/astra-clusterNode",
  "version": "1.0",
  "id": "5df0e09f-2c30-5b8a-b6b6-4fb4063525e4",
  "name": "test-0",
  "role": "node-role.kubernetes.io/worker",
  "labels": [],
  "creationTime": "2020-09-06T04:35:23.593845Z",
  "externalIP": "192.168.12.44",
  "internalIP": "10.0.1.1",
  "zone": "us-west1-c",
  "region": "us-east1",
  "instanceType": "e2-medium",
  "kernelVersion": "4.18.0-147.0.3.el8_1.x86_64",
  "osImage": "Red Hat Enterprise Linux CoreOS 42.81.20191203.0",
  "numCpus": "2",
  "memory": "67108864Ki",
  "state": "running",
  "metadata": {
    "labels": [],
    "creationTimestamp": "2022-10-06T20:58:16.305662Z",
    "modificationTimestamp": "2022-10-06T20:58:16.305662Z",
    "createdBy": "8f84cf09-8036-51e4-b579-bd30cb07b269"
  }
}

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

invalidParams

array["invalidParams"]

Falso

Lista de parâmetros de consulta inválidos
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: 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"
}

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

etiquetas

Nome Tipo Obrigatório Descrição

nome

string

Verdadeiro

String JSON contendo o nome do rótulo Definidos valores são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

  • A expressão regular definida é: "^([\S.]{1,253}\/)?([a-z0-9A-Z_.-]){1,63}$"

valor

string

Verdadeiro

String JSON contendo o valor do rótulo Definidos valores são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

  • A expressão regular definida é: "^([a-z0-9A-Z_.-]){1,63}$"

tipo_astra_label

Nome Tipo Obrigatório Descrição

nome

string

Verdadeiro

valor

string

Verdadeiro

tipo_metadados_astra

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

  • Conforme o esquema de metadados Astra

Nome Tipo Obrigatório Descrição

etiquetas

array["tipo_astra_label"]

Verdadeiro

CriaçãoTimestamp

string

Verdadeiro

Alteração do Timestamp

string

Verdadeiro

CreatedBy

string

Verdadeiro

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