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 namespace para um cluster

PDFs

GET /accounts/{account_id}/topology/v1/clusters/{cluster_id}/namespaces/{namespace_id}

Retorna o recurso da API Namespace 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

namespace_id

string

caminho

Verdadeiro

ID da coleção de namespace a ser listada

Resposta

Status: 200, Returns the stored Namespace 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:

  • "application/astra-namespace"

versão

string

Verdadeiro

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

  • "1,0"

  • "1,1"

id

string

Verdadeiro

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

  • Em conformidade com o esquema UUIDv4

links

array["tipo_astra_link"]

Verdadeiro

Links que descrevem as operações suportadas no recurso.

nome

string

Verdadeiro

String JSON contendo um valor que indica o nome do namespace. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 255

namespaceState

string

Verdadeiro

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

  • "descoberto" - O namespace foi encontrado no cluster

  • "removido" - O namespace foi excluído do cluster ou o cluster não está sendo gerenciado, mas pode haver recursos que se referem ao namespace

namespaceStateDetails

array["type_astra_stateDetail"]

Verdadeiro

Matriz JSON de objetos JSON que lista detalhes adicionais sobre o motivo da transição do "estado" para o "estado a", "estado b" ou "estado c". Se não houver detalhes disponíveis, essa matriz estará vazia. Os valores definidos são:

  • Itens mínimos: 0

kubernetesLabels

array["tipo_astra_label"]

Falso

Matriz JSON de objetos JSON, cada um contendo um rótulo do Kubernetes associado ao namespace. Os valores definidos são:

  • Está em conformidade com o esquema de matriz de rótulos do Kubernetes

ID do cluster

string

Verdadeiro

String JSON contendo um identificador globalmente único do cluster no qual o namespace está contido. Os valores definidos são:

  • Conforme o esquema de identificador Astra

systemType

string

Falso

String JSON que indica que o namespace é um tipo de namespace do sistema. Este campo identifica que tipo de namespace do sistema, se houver, o namespace é (somente versão 1.1). Os valores definidos são:

  • "kubernetes" - Um namespace genérico de sistema Kubernetes (K8s), por exemplo, "kube-system"

  • "netapp" - Um namespace de sistema NetApp, por exemplo, "trident" ou "netapp-monitoring"

  • "openshift" - Um namespace de sistema OpenShift, por exemplo, "openshift-monitoring"

  • "rke" - Um espaço de nomes do Rancher, por exemplo, "cattle-logging"

  • "outros" - Namespaces de sistema comuns que não se encaixam necessariamente em outros lugares, por exemplo, "ingress-nginx", "tekton-system"

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-namespace",
  "version": "1.1",
  "id": "2de811a6-ce8f-512c-9c3a-9585ca66de22",
  "links": [
    {
      "rel": "canonical",
      "href": "/accounts/0b311ae7-d89a-4a11-a52c-1349ca090415/topology/v1/namespaces/7d451d2f-196e-4234-aee9-7e2376047e63",
      "type": "application/vnd.netapp.astra.namespace"
    },
    {
      "rel": "collection",
      "href": "/accounts/0b311ae7-d89a-4a11-a52c-1349ca090415/topology/v1/clouds/e0490197-872e-4de8-9287-b04a938e801f/clusters/0f284377-e5dc-4dcd-bacd-3197f2b8a347/namespaces",
      "type": "application/vnd.netapp.astra.namespaces"
    }
  ],
  "name": "kube-system",
  "namespaceState": "discovered",
  "namespaceStateDetails": [
    {
      "type": "https://astra.netapp.io/stateDetails/9",
      "title": "Namespace Discovered",
      "detail": "The namespace was discovered in the indicated managed cluster"
    }
  ],
  "kubernetesLabels": [
    {
      "name": "app.kubernetes.io/environment",
      "value": "dev"
    }
  ],
  "clusterID": "0f284377-e5dc-4dcd-bacd-3197f2b8a347",
  "systemType": "kubernetes",
  "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

targetSchema

aceitar-post

aceitar-put

dicas

Nome Tipo Obrigatório Descrição

status

string

Falso

permitir

array[string]

Falso

aceitar-post

"aceitar-post"

Falso

permissões

array[string]

Falso

aceitar-put

"aceitar-put"

Falso

tipo_astra_link

Nome Tipo Obrigatório Descrição

rel

string

Verdadeiro

href

string

Verdadeiro

tipo

string

Falso

targetSchema

"targetSchema"

Falso

título

string

Falso

dicas

"dicas"

Falso

type_astra_stateDetail

Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

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