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

클러스터의 네임스페이스를 검색합니다

PDF

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

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

매개변수

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

account_id

문자열

경로

참

포함하는 계정 리소스의 ID

  • 예: {{.Account}}

클러스터_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"

  • "1.2"

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 레이블 배열 스키마를 준수합니다.

kubernetesUID

문자열

참

Kubernetes에서 생성된 네임스페이스 리소스의 UID를 포함하는 JSON 문자열

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.2",
  "id": "214dc2eb-19a6-5444-b156-f4b6b551a81a",
  "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",
  "kubernetesUID": "4f28c377-e5dc-4dcd-b7cd-319cf2b8a345",
  "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"

거짓

type_astra_link

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

rel

문자열

참

href

문자열

참

유형

문자열

거짓

targetSchema

"targetSchema"

거짓

제목

문자열

거짓

힌트

"힌트"

거짓

additionalDetails

type_astra_stateDetail

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

유형

문자열

참

제목

문자열

참

세부 정보

문자열

참

additionalDetails

"additionalDetails"

거짓

type_astra_label

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

이름

문자열

참

값

문자열

참

type_astra_메타데이터

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

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

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

라벨

배열["type_astra_label"]

참

CreationTimestamp 를 클릭합니다

문자열

참

modificationTimestamp

문자열

참

생성 시

문자열

참

modifiedBy

문자열

거짓

invalidParams

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

이름

문자열

참

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

이유

문자열

참

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