Role Assignments - List For Scope

서비스:

Key Vault

API 버전:

2025-07-01

범위에 대한 역할 할당을 가져옵니다.

GET {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleAssignments?api-version=2025-07-01

선택적 매개 변수:

GET {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleAssignments?api-version=2025-07-01&$filter={$filter}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
scope	path	True	string	역할 할당의 범위입니다.
vaultBaseUrl	path	True	string (uri)	Key Vault 인스턴스의 기본 URL(예: https://myvault.vault.azure.net/)
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.
$filter	query		string	작업에 적용할 필터입니다. $filter=atScope()를 사용하여 범위 이상의 모든 역할 할당을 반환합니다. $filter=principalId eq {id}를 사용하여 지정된 보안 주체의 범위, 위 또는 아래의 모든 역할 할당을 반환합니다.

응답

Name	형식	Description
200 OK	RoleAssignmentListResult	요청이 성공했습니다.
Other Status Codes	KeyVaultError	예기치 않은 오류 응답입니다.

보안

OAuth2Auth

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
https://vault.azure.net/.default

예제

Get role assignments for a scope

샘플 요청

HTTP

GET https://myvault.vault.azure.net//keys/providers/Microsoft.Authorization/roleAssignments?api-version=2025-07-01

샘플 응답

상태 코드:

200

{
  "value": [
    {
      "properties": {
        "roleDefinitionId": "/keys/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
        "principalId": "principalId",
        "scope": "/keys"
      },
      "id": "/keys/providers/Microsoft.Authorization/roleAssignments/roleAssignmentId",
      "type": "Microsoft.Authorization/roleAssignments",
      "name": "roleAssignmentId"
    }
  ]
}

정의

Name	Description
Error
KeyVaultError	키 자격 증명 모음 오류 예외입니다.
RoleAssignment	역할 할당
RoleAssignmentListResult	역할 할당 목록 작업 결과입니다.
RoleAssignmentPropertiesWithScope	범위가 있는 역할 할당 속성입니다.
RoleScope	역할 범위입니다.

Error

Object

Name	형식	Description
code	string	오류 코드입니다.
innererror	Error	키 자격 증명 모음 서버 오류입니다.
message	string	오류 메시지입니다.

KeyVaultError

Object

키 자격 증명 모음 오류 예외입니다.

Name	형식	Description
error	Error	키 자격 증명 모음 서버 오류입니다.

RoleAssignment

Object

역할 할당

Name	형식	Description
id	string	역할 할당 ID입니다.
name	string	역할 할당 이름입니다.
properties	RoleAssignmentPropertiesWithScope	역할 할당 속성입니다.
type	string	역할 할당 유형입니다.

RoleAssignmentListResult

Object

역할 할당 목록 작업 결과입니다.

Name	형식	Description
nextLink	string	다음 결과 집합을 가져오는 데 사용할 URL입니다.
value	RoleAssignment[]	역할 할당 목록.

RoleAssignmentPropertiesWithScope

Object

범위가 있는 역할 할당 속성입니다.

Name	형식	Description
principalId	string	보안 주체 ID입니다.
roleDefinitionId	string	역할 정의 ID입니다.
scope	RoleScope	역할 범위입니다.

RoleScope

열거형

역할 범위입니다.

값	Description
/	전역 범위
/keys	키 범위