Skip to main content
Astra Automation
이 제품의 최신 릴리즈를 사용할 수 있습니다.
본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

클라우드에 대한 네임스페이스를 검색합니다

클라우드에 대한 네임스페이스를 검색하여 클라우드 운영을 위한 저장된 네임스페이스 API 리소스를 제공합니다.

HTTP 메서드 및 엔드포인트

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

사용 참고 사항

JSON 응답 본문에 저장된 네임스페이스 API 리소스를 반환합니다.

매개변수

이름 유형 에서 필수 요소입니다 설명

account_id

문자열

경로

참

포함하는 계정 리소스의 ID

  • 예: {{.Account}}

cloud_id

문자열

경로

참

포함된 클라우드 리소스의 ID

클러스터_ID

문자열

경로

참

포함된 클러스터 리소스의 ID

namespace_id

문자열

경로

참

나열할 네임스페이스 컬렉션의 ID

응답

Status: 200, Returns the stored Namespace API resource in the JSON response body.
이름 유형 필수 요소입니다 설명

유형

문자열

참

리소스의 미디어 유형입니다. 정의된 값은 다음과 같습니다.

  • "application/astra-namespace"

버전

문자열

참

리소스 버전입니다. 정의된 값은 다음과 같습니다.

  • "1.0"

  • "1.1"

ID입니다

문자열

참

리소스의 전역 고유 식별자입니다. 정의된 값은 다음과 같습니다.

  • UUIDv4 스키마를 준수합니다.

링크

배열["type_astra_link"]

참

리소스에 대해 지원되는 작업을 설명하는 링크입니다.

이름

문자열

참

네임스페이스 이름을 나타내는 값을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • 최소 길이: 1

  • 최대 길이: 255

namespaceState

문자열

참

네임스페이스의 상태를 나타내는 값을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • "discovered" - 클러스터에서 네임스페이스를 찾았습니다.

  • "removed" - 네임스페이스가 클러스터에서 삭제되었거나 클러스터가 관리되지 않지만 네임스페이스를 참조하는 리소스가 있을 수 있습니다

namespaceStateDetails

배열["type_astra_stateDetail"]

참

"state"가 "state a", "state b" 또는 "state c"로 전환된 이유에 대한 추가 세부 정보를 나열하는 JSON 객체의 JSON 배열입니다. 정보가 없는 경우 이 배열은 비어 있습니다. 정의된 값은 다음과 같습니다.

  • 최소 항목: 0

kubernetesLabels

배열["type_astra_label"]

거짓

네임스페이스와 연결된 Kubernetes 레이블을 각각 포함하는 JSON 객체의 JSON 배열입니다. 정의된 값은 다음과 같습니다.

  • Kubernetes 레이블 배열 스키마를 준수합니다.

clusterID

문자열

참

네임스페이스가 포함된 클러스터의 전역적으로 고유한 식별자를 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • Astra 식별자 스키마를 준수합니다.

systemType

문자열

거짓

네임스페이스가 시스템 네임스페이스 유형임을 나타내는 JSON 문자열입니다. 이 필드는 네임스페이스가 어떤 유형의 시스템 네임스페이스인지 식별합니다(버전 1.1에만 해당). 정의된 값은 다음과 같습니다.

  • "kubernetes" - 일반 Kubernetes(K8s) 시스템 네임스페이스(예: "kube-system")

  • "netapp" - NetApp 시스템 네임스페이스(예: "trident" 또는 "netapp-monitoring")

  • "openshift" - OpenShift 시스템 네임스페이스(예: "openshift-monitoring")

  • "rke" - Rancher 네임스페이스(예: "cattle-logging")

  • "other" - 다른 곳에 반드시 맞지 않는 일반적인 시스템 네임스페이스(예: "ingress-nginx", "tekton-system")

메타데이터

"type_astra_메타데이터"

참

리소스와 연결된 클라이언트 및 서비스 지정 메타데이터입니다. 정의된 값은 다음과 같습니다.

  • Astra 메타데이터 스키마를 준수합니다.

응답 예
{
  "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"
  }
}

응답

Status: 401, Unauthorized
이름 유형 필수 요소입니다 설명

유형

문자열

참

제목

문자열

참

세부 정보

문자열

참

상태

문자열

참

correlationID

문자열

거짓

응답 예
{
  "type": "https://astra.netapp.io/problems/3",
  "title": "Missing bearer token",
  "detail": "The request is missing the required bearer token.",
  "status": "401"
}

응답

Status: 400, Bad request
이름 유형 필수 요소입니다 설명

유형

문자열

참

제목

문자열

참

세부 정보

문자열

참

상태

문자열

참

correlationID

문자열

거짓

invalidParams

배열["invalidParams"]

거짓

유효하지 않은 쿼리 매개변수 목록

응답 예
{
  "type": "https://astra.netapp.io/problems/5",
  "title": "Invalid query parameters",
  "detail": "The supplied query parameters are invalid.",
  "status": "400"
}

응답

Status: 403, Forbidden
이름 유형 필수 요소입니다 설명

유형

문자열

참

제목

문자열

참

세부 정보

문자열

참

상태

문자열

참

correlationID

문자열

거짓

응답 예
{
  "type": "https://astra.netapp.io/problems/11",
  "title": "Operation not permitted",
  "detail": "The requested operation isn't permitted.",
  "status": "403"
}

오류

Status: 404, Not found
이름 유형 필수 요소입니다 설명

유형

문자열

참

제목

문자열

참

세부 정보

문자열

참

상태

문자열

참

correlationID

문자열

거짓

예시 오류 응답
{
  "type": "https://astra.netapp.io/problems/2",
  "title": "Collection not found",
  "detail": "The collection specified in the request URI wasn't found.",
  "status": "404"
}

정의

정의를 참조하세요

targetSchema

accept-post

accept-put

힌트

이름 유형 필수 요소입니다 설명

상태

문자열

거짓

허용

배열[string]

거짓

accept-post

"accept-post"

거짓

권한

배열[string]

거짓

accept-put

"accept-put"

거짓

이름 유형 필수 요소입니다 설명

rel

문자열

참

href

문자열

참

유형

문자열

거짓

targetSchema

"targetSchema"

거짓

제목

문자열

거짓

힌트

"힌트"

거짓

type_astra_stateDetail

이름 유형 필수 요소입니다 설명

유형

문자열

참

제목

문자열

참

세부 정보

문자열

참

type_astra_label

이름 유형 필수 요소입니다 설명

이름

문자열

참

값

문자열

참

type_astra_메타데이터

리소스와 연결된 클라이언트 및 서비스 지정 메타데이터입니다. 정의된 값은 다음과 같습니다.

  • Astra 메타데이터 스키마를 준수합니다.

이름 유형 필수 요소입니다 설명

라벨

배열["type_astra_label"]

참

CreationTimestamp 를 클릭합니다

문자열

참

modificationTimestamp

문자열

참

생성 시

문자열

참

modifiedBy

문자열

거짓

invalidParams

이름 유형 필수 요소입니다 설명

이름

문자열

참

잘못된 쿼리 매개변수의 이름

이유

문자열

참

쿼리 매개변수가 유효하지 않은 이유