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

관리형 클러스터 검색

PDF

GET /accounts/{account_id}/topology/v1/managedClusters/{managedCluster_id}

JSON 응답 본문에 저장된 관리형 클러스터 API 리소스를 반환합니다.

매개변수

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

account_id

문자열

경로

참

포함하는 계정 리소스의 ID

  • 예: {{.Account}}

managedCluster_id

문자열

경로

참

목록에 표시할 managedCluster 컬렉션의 ID

응답

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

유형

문자열

참

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

  • "application/astra-managedCluster"

버전

문자열

참

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

  • "1.0"

  • "1.1"

  • "1.2"

  • "1.3"

  • "1.4"

  • "1.5"

  • "1.6"

  • "1.7"

ID입니다

문자열

참

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

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

이름

문자열

참

클러스터 이름을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • 최소 길이: 1

  • 최대 길이: 63

  • 이 문자열은 XSS, 유니코드, 디렉터리 탐색 및 SQL 인젝션 공격을 방지하기 위해 내부적으로 유효성 검사를 거칩니다.

상태

문자열

참

클러스터의 작동 상태를 나타내는 값을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • "pending" - 클러스터가 검색될 예정입니다.

  • "discovering" - 클러스터가 검색 중입니다

  • "provisioning" - 클러스터가 프로비저닝되는 중입니다

  • "running" - 클러스터가 정상적으로 실행 중입니다.

  • "failed" - 클러스터가 영구적인 실패 상태에 있습니다.

  • "removed" - 현재 클러스터에 접근할 수 없습니다.

  • "unknown" - 클러스터의 상태를 확인할 수 없습니다

restoreTargetSupported

문자열

거짓

관리형 클러스터가 애플리케이션 데이터 관리 작업의 _대상_이 될 수 있는지 여부를 나타내는 값을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • "true" - 클러스터는 앱 데이터 관리 작업의 적합한 대상입니다.

  • "false" - 클러스터는 앱 데이터 관리 작업의 적합한 대상이 아닙니다.

snapshotSupported

문자열

거짓

관리형 클러스터가 애플리케이션 데이터 관리 백업과 유사한 작업을 수행할 수 있는지 여부를 나타내는 값을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • "true" - 클러스터는 앱 데이터 관리 작업을 수행할 수 있습니다.

  • "false" - 클러스터는 앱 데이터 관리 작업을 수행할 자격이 없습니다.

stateUnready

배열[string]

참

클러스터가 "실행 중" 상태로 전환되지 못하는 이유, "실행 중" 상태에서 문제가 발생하는 이유, 또는 "실패"나 "제거됨" 태로 전환된 이유를 각각 나타내는 JSON 문자열의 JSON 배열입니다. 정의된 값은 다음과 같습니다:

  • 최소 길이: 1

  • 최대 길이: 127

managedState

문자열

참

클러스터의 관리 상태를 나타내는 값을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • "pending" - 클러스터가 검색되거나 추가될 예정입니다.

  • "ineligible" - 클러스터가 "running" 상태이며 관리 대상이 아니고 관리 대상 자격도 없습니다. 이러한 관리 대상 아님의 이유는 unready 키 값에 제공됩니다.

  • "deleting" - 클러스터가 삭제되는 중입니다

  • "unmanaged" - 클러스터가 "running" 또는 "failed" 상태이며, 관리 대상이 아니며, 관리 대상이 될 수 있는 상태입니다

  • "managing" - 클러스터가 "running" 상태이며 관리 프로세스가 진행 중입니다.

  • "managed" - 클러스터가 "running", "failed" 또는 "removed" 상태이며 관리되고 있습니다.

managedStateDetails

배열["type_astra_stateDetail"]

거짓

현재 상태에 대한 추가 정보(현재 상태에 도달한 이유 포함)를 나열하는 JSON 객체의 JSON 배열입니다. 정보가 없는 경우 이 배열은 비어 있습니다. 정의된 값은 다음과 같습니다:

  • 최소 항목: 0

protectionState

문자열

참

클러스터의 보호 상태를 나타내는 값을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • "full" - 클러스터의 기본 스토리지 클래스는 스냅샷을 지원합니다.

  • "partial" - 클러스터에는 스냅샷을 지원하지 않는 스토리지 클래스만 있습니다.

  • "atRisk" - 클러스터의 기본 스토리지 클래스는 스냅샷을 지원하지 않습니다

protectionStateDetails

배열["type_astra_stateDetail"]

참

현재 보호 상태에 대한 추가 정보(현재 상태에 도달한 이유 포함)를 나열하는 JSON 객체의 JSON 배열입니다. 정보가 없는 경우 이 배열은 비어 있습니다. 정의된 값은 다음과 같습니다.

  • 최소 항목: 0

managedStateUnready

배열[string]

참

클러스터 관리가 불가능한 이유를 각각 나타내는 JSON 문자열들의 JSON 배열입니다. 정의된 값은 다음과 같습니다.

  • 최소 길이: 1

  • 최대 길이: 127

managedTimestamp

문자열

참

클러스터가 관리 상태로 전환된 시점을 나타내는 타임스탬프가 포함된 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • ISO-8601 날짜/시간 스키마를 준수합니다. 이 키는 클러스터의 managedState가 "managed"일 때만 반환됩니다.

tridentVersion

문자열

거짓

클러스터에 설치된 Trident 버전을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • 소프트웨어 버전 스키마를 준수합니다

acpVersion

문자열

거짓

클러스터에 설치된 Astra Control Provisioner 버전을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • 소프트웨어 버전 스키마를 준수합니다

tridentManagedState

문자열

거짓

이 클러스터에서 Trident의 관리 상태를 나타내는 열거형 값 중 하나를 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • "managed" - 클러스터의 Trident 인스턴스는 Astra에서 관리됩니다

  • "unmanaged" - 클러스터의 Trident 인스턴스가 Astra에서 관리되지 않습니다

tridentManagedStateDesired

문자열

거짓

Trident의 원하는 관리 상태를 나타내는 값이 포함된 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • "managed" - 이 클러스터에서 Trident를 관리합니다

  • "unmanaged" - 이 클러스터에서 Trident를 관리하지 마십시오

tridentManagedStateDetails

배열["type_astra_stateDetail"]

거짓

"state"가 "managed" 또는 "unmanaged"로 전환된 이유에 대한 추가 세부 정보를 나열하는 JSON 객체의 JSON 배열입니다. + 사용 가능한 세부 정보가 없는 경우 이 배열은 비어 있습니다.

  • 최소 항목: 0

tridentManagedStateAllowed

배열[string]

거짓

특정 tridentManagedState에서 요청할 수 있는 상태입니다. 정의된 각 상태에서 다음과 같은 상태를 요청할 수 있습니다.

  • "managed": "managed"

  • "unmanaged": "unmanaged"

inUse

문자열

참

클러스터에 관리형 애플리케이션이 있는지 여부를 나타내는 값을 포함하는 JSON 문자열이므로 삭제할 수 없습니다. 정의된 값은 다음과 같습니다.

  • "false" - 클러스터 노드가 관리되지 않거나, 관리되지만 연결된 관리형 애플리케이션이 없습니다.

  • "true" - 클러스터가 관리되며 관리되는 애플리케이션이 연결되어 있습니다

accHost

문자열

거짓

현재 액세스 중인 Astra Control Center 인스턴스를 이 클러스터에서 호스팅한다는 것을 나타내는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • "true" - 이 클러스터는 현재 접속 중인 Astra Control Center 인스턴스를 호스팅하고 있습니다.

clusterType

문자열

참

클러스터 유형을 나타내는 값을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • "gke" - Google Kubernetes Engine에서 호스팅되는 Kubernetes

  • "aks" - Microsoft Azure Kubernetes Service에서 호스팅되는 Kubernetes

  • "eks" - Amazon Elastic Kubernetes Service에서 호스팅되는 Kubernetes

  • "rke" - 클러스터는 Rancher 유형입니다

  • "tanzu" - 클러스터는 Tanzu Kubernetes Grid 유형입니다

  • "openshift" - 클러스터 유형은 OpenShift

  • "anthos" - 클러스터는 GKE Anthos 유형입니다

  • "kubernetes" - 클러스터는 일반 Kubernetes입니다

clusterVersion

문자열

참

클러스터 환경의 시맨틱 버전 표현을 포함하는 JSON 문자열입니다. Kubernetes 클러스터의 경우 Kubernetes 버전입니다. 정의된 값은 다음과 같습니다.

  • 최소 길이: 1

  • 최대 길이: 31

clusterVersionString

문자열

참

클러스터 환경에 대한 확장 버전 정보를 나타내는 값을 포함하는 JSON 문자열입니다. Kubernetes 클러스터의 경우 전체 Kubernetes 버전입니다. 정의된 값은 다음과 같습니다.

  • 최소 길이: 1

  • 최대 길이: 31

clusterCreationTimestamp

문자열

거짓

클러스터가 처음 생성된 시점을 나타내는 타임스탬프가 포함된 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • ISO-8601 날짜/시간 스키마를 준수합니다.

네임스페이스

배열[string]

거짓

클러스터 내의 네임스페이스를 나타내는 JSON 문자열들의 JSON 배열입니다. 정의된 값은 다음과 같습니다.

  • 최소 길이: 1

  • 최대 길이: 253

defaultStorageClass

문자열

거짓

Kubernetes에 설정된 기본 스토리지 클래스에 해당하는 스토리지 클래스 ID가 포함된 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

  • Astra 식별자 스키마를 준수합니다. 포함되지 않은 경우 아직 검색되지 않은 것입니다.

cloudID

문자열

참

클러스터가 실행 중인 클라우드의 ID를 나타내는 값을 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

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

credentialID

문자열

거짓

클러스터의 kubeconfig 파일이 포함된 자격 증명의 ID를 나타내는 값을 담고 있는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

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

위치

문자열

거짓

클러스터가 실행되는 클라우드에서 제공하는 값을 포함하는 JSON 문자열로, 클러스터의 클라우드별 위치를 나타냅니다. 정의된 값은 다음과 같습니다.

  • 최소 길이: 1

  • 최대 길이: 63

isMultizonal

문자열

참

클러스터가 실행되는 클라우드에서 제공하는 값을 포함하는 JSON 문자열로, 클러스터가 둘 이상의 가용 영역에 걸쳐 있는지 여부를 나타냅니다. 정의된 값은 다음과 같습니다.

  • "true" - 클러스터가 둘 이상의 가용 영역에 걸쳐 있습니다.

  • "false" - 클러스터는 단일 가용 영역 내에 완전히 위치해 있습니다.

privateRouteID

문자열

거짓

비공개 클러스터의 locationID가 포함된 JSON 문자열입니다.

  • 최소 길이: 1

  • 최대 길이: 255

apiServiceID

문자열

거짓

Kubernetes(k8s) API 서비스 객체의 UUID를 포함하는 JSON 문자열입니다. 클러스터를 고유하게 식별하는 데 사용됩니다.

defaultBucketID

문자열

거짓

관리형 Neptune 클러스터의 애플리케이션 메타데이터를 유지하는 데 기본적으로 사용될 버킷의 ID가 포함된 JSON 문자열입니다. 클러스터에 기본 버킷이 지정되지 않은 경우 해당 클라우드 기본 버킷이 사용됩니다.

메타데이터

"type_astra_메타데이터_업데이트"

참

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

  • Astra 메타데이터 스키마를 준수합니다. 생성 시 지정하지 않으면 레이블 없이 메타데이터 객체가 생성됩니다. 업데이트 시 지정하지 않으면 메타데이터 객체의 레이블인 creationTimestamp와 createdBy는 수정 없이 유지됩니다.
응답 예 
{
  "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": "true",
  "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"
  }
}

응답

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

정의

정의를 참조하세요

additionalDetails

type_astra_stateDetail

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

유형

문자열

참

제목

문자열

참

세부 정보

문자열

참

additionalDetails

"additionalDetails"

거짓

type_astra_label

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

이름

문자열

참

값

문자열

참

type_astra_메타데이터_업데이트

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

  • Astra 메타데이터 스키마를 준수합니다. 생성 시 지정하지 않으면 레이블 없이 메타데이터 객체가 생성됩니다. 업데이트 시 지정하지 않으면 메타데이터 객체의 레이블인 creationTimestamp와 createdBy는 수정 없이 유지됩니다.

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

라벨

배열["type_astra_label"]

거짓

CreationTimestamp 를 클릭합니다

문자열

거짓

modificationTimestamp

문자열

거짓

생성 시

문자열

거짓

modifiedBy

문자열

거짓

invalidParams

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

이름

문자열

참

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

이유

문자열

참

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