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

사용자와 연결된 그룹에 대한 역할 바인딩을 검색합니다

05/23/2026

GET /accounts/{account_id}/core/v1/users/{user_id}/groups/{group_id}/roleBindings/{roleBinding_id}

저장된 역할 바인딩 API 리소스를 JSON 응답 본문에 반환합니다. 요청이 /accounts/{account_id}/core/v1/users/{user_id}/roleBindings 엔드포인트에 대한 것이라면, 요청 URL의 사용자 ID와 일치하는 사용자 ID를 가진 roleBinding 리소스만 읽을 수 있습니다. 요청이 /accounts/{account_id}/core/v1/groups/{group_id}/roleBindings에 대한 것이라면, 요청 URL의 그룹 ID와 일치하는 그룹 ID를 가진 roleBinding 리소스만 읽을 수 있습니다.

매개변수

이름	유형	에서	필수 요소입니다	설명
account_id	문자열	경로	참	포함하는 계정 리소스의 ID 예: {{.Account}}
user_id	문자열	경로	참	포함하는 사용자 리소스의 ID
group_id	문자열	경로	참	포함하는 그룹 리소스의 ID
roleBinding_id	문자열	경로	참	목록에 표시할 roleBinding 컬렉션의 ID

이름

유형

에서

필수 요소입니다

설명

account_id

문자열

경로

참

포함하는 계정 리소스의 ID

예: {{.Account}}

user_id

문자열

경로

참

포함하는 사용자 리소스의 ID

group_id

문자열

경로

참

포함하는 그룹 리소스의 ID

roleBinding_id

문자열

경로

참

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

응답

Status: 200

이름	유형	필수 요소입니다	설명
유형	문자열	참	리소스의 미디어 유형입니다. 정의된 값은 다음과 같습니다. "application/astra-roleBinding"
버전	문자열	참	리소스 버전입니다. 정의된 값은 다음과 같습니다. "1.0" "1.1"
ID입니다	문자열	참	리소스의 전역 고유 식별자입니다. 정의된 값은 다음과 같습니다. UUIDv4 스키마를 준수합니다.
principalType	문자열	참	이 바인딩이 연결된 주체의 유형을 나타내는 JSON 문자열입니다. 정의된 값은 다음과 같습니다. "user" principalType "user"인 경우, null이 아닌 사용자 ID가 필요합니다. principalType "group"인 경우, null이 아닌 그룹 ID가 필요합니다.
userID	문자열	참	사용자 리소스 ID가 포함된 JSON 문자열입니다. 정의된 값은 다음과 같습니다. Astra 식별자 스키마를 준수합니다. 생성 시 지정하지 않으면 nil UUID가 사용됩니다. 생성 시에는 userID 또는 groupID만 지정할 수 있습니다.
groupID	문자열	참	그룹 리소스 ID가 포함된 JSON 문자열입니다. 정의된 값은 다음과 같습니다. Astra 식별자 스키마를 준수합니다. 생성 시 지정하지 않으면 nil UUID가 사용됩니다. 생성 시에는 userID 또는 groupID만 지정할 수 있습니다.
accountID	문자열	참	계정 리소스의 ID가 포함된 JSON 문자열입니다. 생성 시 요청 URI의 계정 ID와 일치해야 합니다. 정의된 값은 다음과 같습니다. Astra 식별자 스키마를 준수합니다.
역할	문자열	참	정의된 네 가지 역할 중 하나를 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다. "뷰어" "멤버" "admin" "소유자"
roleConstraints	배열[string]	거짓	역할 할당 범위를 지정하는 JSON 문자열의 JSON 배열입니다. 정의된 값은 다음과 같습니다. Astra 역할 제약 조건 스키마를 준수합니다. 생성 시 지정하지 않으면 "전체 범위"를 나타내는 문자열 ""가 포함된 크기 1의 배열로 설정됩니다. 업데이트 시 지정하지 않으면 값은 수정 없이 유지됩니다. 빈 배열은 "범위 없음"을 나타냅니다. 예: = 모든 리소스에 대한 액세스 허용: "roleConstraints": [""] + = 모든 리소스에 대한 접근 거부: "roleConstraints": [] * + = 특정 네임스페이스 리소스에만 액세스 허용: "roleConstraints": [ "namespaces:id='6fa2f917-f730-41b8-9c15-17f531843b31'" ] * + = 특정 네임스페이스 및 그 하위 모든 항목에 대한 접근 허용: "roleConstraints": [ "namespaces:id='6fa2f917-f730-41b8-9c15-17f531843b31'." ] + = 모든 클라우드의 모든 클러스터에서 "dev"로 표시된 모든 네임스페이스와 그 아래의 모든 항목에 대한 액세스를 허용합니다: "roleConstraints": [ "namespaces:kubernetesLabels='dev.example.com/appname=dev'." ] + = 모든 네임스페이스 리소스에 대한 액세스만 허용: "roleConstraints": [ "namespaces:" ] + = 모든 네임스페이스 리소스 및 그 하위 항목에 대한 접근을 허용합니다: "roleConstraints": [ "namespaces:." ]
메타데이터	"type_astra_메타데이터_업데이트"	참	리소스와 연결된 클라이언트 및 서비스 지정 메타데이터입니다. 정의된 값은 다음과 같습니다. Astra 메타데이터 스키마를 준수합니다. 생성 시 지정하지 않으면 레이블 없이 메타데이터 객체가 생성됩니다. 업데이트 시 지정하지 않으면 메타데이터 객체의 레이블인 creationTimestamp와 createdBy는 수정 없이 유지됩니다.

이름

유형

필수 요소입니다

설명

유형

문자열

참

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

"application/astra-roleBinding"

버전

문자열

참

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

"1.0"
"1.1"

ID입니다

문자열

참

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

UUIDv4 스키마를 준수합니다.

principalType

문자열

참

이 바인딩이 연결된 주체의 유형을 나타내는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

"user"
principalType "user"인 경우, null이 아닌 사용자 ID가 필요합니다. principalType "group"인 경우, null이 아닌 그룹 ID가 필요합니다.

userID

문자열

참

사용자 리소스 ID가 포함된 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

Astra 식별자 스키마를 준수합니다. 생성 시 지정하지 않으면 nil UUID가 사용됩니다. 생성 시에는 userID 또는 groupID만 지정할 수 있습니다.

groupID

문자열

참

그룹 리소스 ID가 포함된 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

Astra 식별자 스키마를 준수합니다. 생성 시 지정하지 않으면 nil UUID가 사용됩니다. 생성 시에는 userID 또는 groupID만 지정할 수 있습니다.

accountID

문자열

참

계정 리소스의 ID가 포함된 JSON 문자열입니다. 생성 시 요청 URI의 계정 ID와 일치해야 합니다. 정의된 값은 다음과 같습니다.

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

역할

문자열

참

정의된 네 가지 역할 중 하나를 포함하는 JSON 문자열입니다. 정의된 값은 다음과 같습니다.

"뷰어"
"멤버"
"admin"
"소유자"

roleConstraints

배열[string]

거짓

역할 할당 범위를 지정하는 JSON 문자열의 JSON 배열입니다. 정의된 값은 다음과 같습니다.

Astra 역할 제약 조건 스키마를 준수합니다. 생성 시 지정하지 않으면 "전체 범위"를 나타내는 문자열 "*"가 포함된 크기 1의 배열로 설정됩니다. 업데이트 시 지정하지 않으면 값은 수정 없이 유지됩니다. 빈 배열은 "범위 없음"을 나타냅니다. 예: *

= 모든 리소스에 대한 액세스 허용: "roleConstraints": ["*"]

+ = 모든 리소스에 대한 접근 거부: "roleConstraints": []

+ = 특정 네임스페이스 리소스에만 액세스 허용: "roleConstraints": [ "namespaces:id='6fa2f917-f730-41b8-9c15-17f531843b31'" ]

+ = 특정 네임스페이스 및 그 하위 모든 항목에 대한 접근 허용: "roleConstraints": [ "namespaces:id='6fa2f917-f730-41b8-9c15-17f531843b31'.*" ]

+ = 모든 클라우드의 모든 클러스터에서 "dev"로 표시된 모든 네임스페이스와 그 아래의 모든 항목에 대한 액세스를 허용합니다: "roleConstraints": [ "namespaces:kubernetesLabels='dev.example.com/appname=dev'.*" ]

+ = 모든 네임스페이스 리소스에 대한 액세스만 허용: "roleConstraints": [ "namespaces:*" ]

+ = 모든 네임스페이스 리소스 및 그 하위 항목에 대한 접근을 허용합니다: "roleConstraints": [ "namespaces:." ]

메타데이터

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

참

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

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

응답 예

{
  "type": "application/astra-roleBinding",
  "version": "1.1",
  "id": "a198f052-5cd7-59d3-9f27-9ea32a21fbca",
  "principalType": "user",
  "userID": "4c27d25a-9edb-4e85-9438-48dc8e917231",
  "groupID": "00000000-0000-0000-0000-000000000000",
  "accountID": "9fd87309-067f-48c9-a331-527796c14cf3",
  "role": "viewer",
  "roleConstraints": [
    "*"
  ],
  "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	문자열	거짓

이름

유형

필수 요소입니다

설명

유형

문자열

참

제목

문자열

참

세부 정보

문자열

참

상태

문자열

참

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"]	거짓	유효하지 않은 쿼리 매개변수 목록

이름

유형

필수 요소입니다

설명

유형

문자열

참

제목

문자열

참

세부 정보

문자열

참

상태

문자열

참

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	문자열	거짓

이름

유형

필수 요소입니다

설명

유형

문자열

참

제목

문자열

참

세부 정보

문자열

참

상태

문자열

참

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	문자열	거짓

이름

유형

필수 요소입니다

설명

유형

문자열

참

제목

문자열

참

세부 정보

문자열

참

상태

문자열

참

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

정의

정의를 참조하세요

type_astra_label

이름	유형	필수 요소입니다	설명
이름	문자열	참
값	문자열	참

이름

유형

필수 요소입니다

설명

이름

문자열

참

값

문자열

참

type_astra_메타데이터_업데이트

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

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

이름	유형	필수 요소입니다
라벨	배열["type_astra_label"]	거짓
CreationTimestamp 를 클릭합니다	문자열	거짓
modificationTimestamp	문자열	거짓
생성 시	문자열	거짓
modifiedBy	문자열	거짓

이름

유형

필수 요소입니다

설명

라벨

배열["type_astra_label"]

거짓

CreationTimestamp 를 클릭합니다

문자열

거짓

modificationTimestamp

문자열

거짓

생성 시

문자열

거짓

modifiedBy

문자열

거짓

invalidParams

이름	유형	필수 요소입니다	설명
이름	문자열	참	잘못된 쿼리 매개변수의 이름
이유	문자열	참	쿼리 매개변수가 유효하지 않은 이유

이름

유형

필수 요소입니다

설명

이름

문자열

참

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

이유

문자열

참

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

사용자와 연결된 그룹에 대한 역할 바인딩을 검색합니다

매개변수

응답

응답

응답

응답

오류

정의

Parameters

Headers

Body

Code

Response

사용자와 연결된 그룹에 대한 역할 바인딩을 검색합니다

Creating your file...

매개변수

응답

응답

응답

응답

오류

정의

Parameters

Headers

Body

Code

Response