Skip to main content
Astra Automation
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.

Criar um novo cluster gerenciado

PDFs

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

Indica os valores desejados para o recurso da API Managed Cluster a ser criado.

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

Corpo da solicitação

Indica os valores desejados para o recurso da API Managed Cluster a ser criado.

Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

Tipo de mídia do recurso. Os valores definidos são:

  • "aplicação/astra-managedCluster"

versão

string

Verdadeiro

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

  • "1,0"

  • "1,1"

  • "1,2"

  • "1,3"

  • "1,4"

  • "1,5"

  • "1,6"

  • "1,7"

id

string

Verdadeiro

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

  • Em conformidade com o esquema UUIDv4

tridentManagedStateDesired

string

Falso

String JSON contendo um valor que indica o estado de gerenciamento desejado para Trident. Os valores definidos são:

  • "managed" - Gerencie Trident neste cluster

  • "Não gerenciado" - Não gerencie Trident neste cluster

defaultStorageClass

string

Falso

String JSON contendo um ID de classe de armazenamento que corresponde à classe de armazenamento padrão, conforme definida no Kubernetes. Valores definidos são:

  • Está em conformidade com o esquema de identificação Astra. Se não estiver incluído, significa que ainda não foi descoberto.

ID do bucket padrão

string

Falso

String JSON contendo o ID de um bucket que será usado por padrão para persistir metadados de aplicativo para um cluster Neptune gerenciado. Se nenhum bucket padrão for especificado no cluster, o bucket padrão correspondente na nuvem será usado.

metadados

"type_astra_metadados_update"

Falso

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

  • Conforme 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-managedCluster",
  "version": "1.7",
  "id": "241e9d94-eb8b-5c25-ba20-9292baac2396",
  "defaultStorageClass": "e280ff62-be35-4f31-a31b-a210a1ad1b33",
  "tridentManagedStateDesired": "managed"
}

Resposta

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

versão

string

Verdadeiro

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

  • "1,0"

  • "1,1"

  • "1,2"

  • "1,3"

  • "1,4"

  • "1,5"

  • "1,6"

  • "1,7"

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 nome para o cluster. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

  • Essa string é validada internamente para evitar ataques de XSS, Unicode, travessia de diretório e injeção de SQL.

estado

string

Verdadeiro

Cadeia JSON contendo um valor que indica o estado operacional do cluster. Os valores definidos são:

  • "Pendente" - O cluster está agendado para descoberta

  • "descobrindo" - O cluster está em processo de descoberta

  • "Provisionamento" - O cluster está em processo de provisionamento

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

  • "failed" - O cluster está em estado de falha permanente

  • "removido" - O cluster não está acessível no momento

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

restoreTargetSupported

string

Falso

String JSON contendo um valor que indica a capacidade do cluster gerenciado de ser um alvo de operações de gerenciamento de dados de aplicativos. Valores definidos são:

  • "verdadeiro" - O cluster é um alvo elegível para operações de gerenciamento de dados de aplicativos.

  • "falso" - O cluster não é um alvo elegível para operações de gerenciamento de dados de app.

snapshotSupported

string

Falso

String JSON contendo um valor que indica a capacidade do cluster gerenciado de executar operações semelhantes a backup de gerenciamento de dados de aplicativos. Valores definidos são:

  • "verdadeiro" - O cluster está apto a executar operações de gerenciamento de dados de aplicativos.

  • "false" - O cluster não está qualificado para executar operações de gerenciamento de dados do aplicativo.

stateUnready

array[string]

Verdadeiro

Matriz JSON de strings JSON, cada uma indicando um motivo pelo qual o cluster não consegue transitar para o estado "em execução", quando há problemas enquanto está no estado "em execução" ou por que transitou para o estado "com falha" ou "removido". Valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 127

managedState

string

Verdadeiro

String JSON contendo um valor que indica o estado de gerenciamento do cluster. Os valores definidos são:

  • "Pendente" - O cluster está agendado para ser descoberto ou adicionado

  • "inelegível" - O cluster está em estado "em execução", não está sob gerenciamento e não é elegível para gerenciamento. O motivo ou motivos dessa inelegibilidade são fornecidos no valor da chave unready

  • "Excluindo" - O cluster está em processo de exclusão

  • "Não gerenciado" - O cluster está em um estado "em execução" ou "com falha", não está sob gerenciamento e é elegível para gerenciamento

  • "Gerenciando" - O cluster está em estado "em execução" e está em processo de gerenciamento

  • "Gerenciado" - O cluster está em um estado "em execução", "com falha" ou "removido" e está sob gerenciamento

managedStateDetails

array["type_astra_stateDetail"]

Falso

Array JSON de objetos JSON que lista detalhes adicionais sobre o estado atual, incluindo o motivo pelo qual o estado atual foi alcançado. Se nenhum detalhe estiver disponível, este array estará vazio. Os valores definidos são:

  • Quantidade mínima de itens: 0

protectionState

string

Verdadeiro

String JSON contendo um valor que indica o estado de proteção do cluster. Os valores definidos são:

  • "full" - A classe de armazenamento padrão do cluster suporta snapshots

  • "Parcial" - O cluster possui apenas classes de armazenamento que não suportam snapshots

  • "atRisk" - A classe de armazenamento padrão do cluster não suporta snapshots

protectionStateDetails

array["type_astra_stateDetail"]

Verdadeiro

Matriz JSON de objetos JSON que lista detalhes adicionais sobre o estado de proteção atual, incluindo o motivo pelo qual esse estado foi atingido. Se não houver detalhes disponíveis, essa matriz estará vazia. Os valores definidos são:

  • Quantidade mínima de itens: 0

managedStateUnready

array[string]

Verdadeiro

Matriz JSON de strings JSON, cada uma indicando um motivo pelo qual o cluster não é elegível para ser gerenciado. Valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 127

managedTimestamp

string

Verdadeiro

String JSON contendo o carimbo de data/hora que indica quando o cluster foi colocado sob gerenciamento. Os valores definidos são:

  • Em conformidade com o esquema de data e hora ISO-8601. Esta chave só é retornada quando um cluster tem um managedState de "managed".

tridentVersion

string

Falso

String JSON contendo a versão do Trident instalada no cluster. Os valores definidos são:

  • Em conformidade com o esquema de versão do software

acpVersion

string

Falso

String JSON contendo a versão do Astra Control Provisioner instalada no cluster. Os valores definidos são:

  • Em conformidade com o esquema de versão do software

tridentManagedState

string

Falso

String JSON contendo um de um conjunto de valores enumerados que indicam o estado de gerenciamento do Trident neste cluster. Os valores definidos são:

  • "Gerenciado" - a instância Trident no cluster é gerenciada pelo Astra

  • "Não gerenciado" - a instância Trident no cluster não é gerenciada pelo Astra

tridentManagedStateDesired

string

Falso

String JSON contendo um valor que indica o estado de gerenciamento desejado para Trident. Os valores definidos são:

  • "managed" - Gerencie Trident neste cluster

  • "Não gerenciado" - Não gerencie Trident neste cluster

tridentManagedStateDetails

array["type_astra_stateDetail"]

Falso

Matriz JSON de objetos JSON que lista detalhes adicionais sobre o motivo da transição do "state" para "managed" ou "unmanaged". + Se não houver detalhes disponíveis, esta matriz estará vazia.

  • Quantidade mínima de itens: 0

tridentManagedStateAllowed

array[string]

Falso

Estados que podem ser solicitados em um determinado tridentManagedState. Os seguintes estados podem ser solicitados em cada estado definido:

  • "gerenciado": "gerenciado"

  • "não gerenciado": "não gerenciado"

inUse

string

Verdadeiro

String JSON contendo um valor que indica se o cluster possui algum aplicativo gerenciado e, portanto, não pode ser excluído. Os valores definidos são:

  • "falso" - O cluster não é gerenciado ou é gerenciado, mas não possui aplicativos gerenciados associados a ele

  • "verdadeiro" - O cluster é gerenciado e possui aplicativos gerenciados associados a ele

accHost

string

Falso

String JSON que indica que este cluster hospeda a instância do Astra Control Center que está sendo acessada no momento. Os valores definidos são:

  • "true" - Este cluster está hospedando a instância do Astra Control Center que está sendo acessada no momento.

clusterType

string

Verdadeiro

String JSON contendo um valor que indica o tipo de cluster. Os valores definidos são:

  • "gke" - Kubernetes hospedado no Google Kubernetes Engine

  • "aks" - Kubernetes hospedado no serviço de Kubernetes do Microsoft Azure

  • "eks" - Kubernetes hospedado no Amazon Elastic Kubernetes Service

  • "rke" - O cluster é do tipo Rancher

  • "tanzu" - O cluster é do tipo Tanzu Kubernetes Grid

  • "openshift" - O cluster é do tipo OpenShift

  • "anthos" - O cluster é do tipo GKE Anthos

  • "kubernetes" - O cluster é Kubernetes genérico

clusterVersion

string

Verdadeiro

String JSON contendo a representação semântica de versionamento do ambiente do cluster. Para clusters Kubernetes, esta é a versão do Kubernetes. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 31

clusterVersionString

string

Verdadeiro

String JSON contendo um valor que indica as informações de versionamento estendidas para o ambiente de cluster. Para clusters Kubernetes, esta é a versão completa do Kubernetes. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 31

clusterCreationTimestamp

string

Falso

String JSON contendo o carimbo de data/hora que indica quando o cluster foi criado originalmente. Os valores definidos são:

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

espaços de nomes

array[string]

Falso

Matriz JSON de strings JSON, cada uma indicando um namespace dentro do cluster. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 253

defaultStorageClass

string

Falso

String JSON contendo um ID de classe de armazenamento que corresponde à classe de armazenamento padrão, conforme definida no Kubernetes. Valores definidos são:

  • Está em conformidade com o esquema de identificação Astra. Se não estiver incluído, significa que ainda não foi descoberto.

cloudID

string

Verdadeiro

String JSON contendo um valor que indica o ID da nuvem na qual o cluster está sendo executado. Os valores definidos são:

  • Conforme o esquema de identificador Astra

ID da credencial

string

Falso

String JSON contendo um valor que indica o ID da credencial que contém o arquivo kubeconfig do cluster. Os valores definidos são:

  • Conforme o esquema de identificador Astra

localização

string

Falso

String JSON contendo um valor fornecido pela nuvem na qual o cluster está sendo executado, indicando a localização específica do cluster nessa nuvem. Valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

isMultizonal

string

Verdadeiro

String JSON contendo um valor fornecido pela nuvem na qual o cluster está sendo executado, indicando se o cluster abrange duas ou mais zonas de disponibilidade. Valores definidos são:

  • "verdadeiro" - O cluster abrange duas ou mais zonas de disponibilidade

  • "falso" - O cluster está totalmente localizado dentro de uma única zona de disponibilidade

ID da rota privada

string

Falso

String JSON contendo o locationID para clusters privados.

  • Comprimento mínimo: 1

  • Comprimento máximo: 255

ID do serviço de API

string

Falso

String JSON contendo o UUID do objeto de serviço da api do Kubernetes (k8s). Usada para identificar um cluster de forma única.

ID do bucket padrão

string

Falso

String JSON contendo o ID de um bucket que será usado por padrão para persistir metadados de aplicativo para um cluster Neptune gerenciado. Se nenhum bucket padrão for especificado no cluster, o bucket padrão correspondente na nuvem será usado.

metadados

"type_astra_metadados_update"

Verdadeiro

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

  • Conforme 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 resposta 
{
  "type": "application/astra-managedCluster",
  "version": "1.7",
  "id": "241e9d94-eb8b-5c25-ba20-9292baac2396",
  "name": "GKE-22",
  "state": "running",
  "stateUnready": [],
  "managedState": "managed",
  "managedStateUnready": [],
  "managedTimestamp": "2020-08-06T12:24:52.256624Z",
  "protectionState": "full",
  "protectionStateDetails": [],
  "tridentVersion": "23.10.0",
  "acpVersion": "23.10.0",
  "tridentManagedState": "managed",
  "tridentManagedStateDesired": "managed",
  "tridentManagedStateDetails": [],
  "inUse": "false",
  "clusterType": "kubernetes",
  "clusterVersion": "1.91.1",
  "clusterVersionString": "1.19.1",
  "clusterCreationTimestamp": "2020-08-06T12:24:52.256624Z",
  "namespaces": [
    "kube-system",
    "kube-public",
    "my-app-1"
  ],
  "defaultStorageClass": "e280ff62-be35-4f31-a31b-a210a1ad1b33",
  "cloudID": "548bdc1f-f00e-4a23-a062-83265d224d46",
  "credentialID": "055e365a-2215-40de-aecb-a4070a7e6f1e",
  "location": "europe-west4",
  "isMultizonal": "false",
  "apiServiceID": "6bf33af2-872a-4553-a891-26b510c3edbe",
  "defaultBucketID": "a549b757-2be1-494f-aafa-4ee399ca3f00",
  "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
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"
}

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

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:

  • Conforme 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

additionalDetails

type_astra_stateDetail

Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

additionalDetails

"additionalDetails"

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