Role Assignments - Create

Service:

Key Vault

API Version:

7.4

역할 할당을 만듭니다.

PUT {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleAssignments/{roleAssignmentName}?api-version=7.4

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
roleAssignmentName	path	True	string	만들 역할 할당의 이름입니다. 유효한 GUID일 수 있습니다.
scope	path	True	string	만들 역할 할당의 scope.
vaultBaseUrl	path	True	string	자격 증명 모음 이름(예: https://myvault.vault.azure.net)입니다.
api-version	query	True	string	클라이언트 API 버전입니다.

요청 본문

Name	필수	형식	Description
properties	True	RoleAssignmentProperties	역할 할당 속성입니다.

응답

Name	형식	Description
201 Created	RoleAssignment	만든 - 역할 할당에 대한 정보를 반환합니다.
Other Status Codes	KeyVaultError	작업이 실패한 이유를 설명하는 오류 응답을 Key Vault.

예제

PutRoleAssignments

Sample Request

HTTP

PUT https://myvault.vault.azure.net//keys/providers/Microsoft.Authorization/roleAssignments/roleAssignmentName?api-version=7.4

{
  "properties": {
    "roleDefinitionId": "/keys/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
    "principalId": "principalId"
  }
}

Sample Response

Status code:

201

{
  "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	역할 할당
RoleAssignmentCreateParameters	역할 할당은 매개 변수를 만듭니다.
RoleAssignmentProperties	역할 할당 속성입니다.
RoleAssignmentPropertiesWithScope	scope 있는 역할 할당 속성입니다.
RoleScope	역할 scope.

Error

키 자격 증명 모음 서버 오류입니다.

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

KeyVaultError

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

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

RoleAssignment

역할 할당

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

RoleAssignmentCreateParameters

역할 할당은 매개 변수를 만듭니다.

Name	형식	Description
properties	RoleAssignmentProperties	역할 할당 속성입니다.

RoleAssignmentProperties

역할 할당 속성입니다.

Name	형식	Description
principalId	string	역할에 할당된 보안 주체 ID입니다. Active Directory 내의 ID에 매핑됩니다. 사용자, 서비스 주체 또는 보안 그룹을 가리킬 수 있습니다.
roleDefinitionId	string	역할 할당에 사용되는 역할 정의 ID입니다.

RoleAssignmentPropertiesWithScope

scope 있는 역할 할당 속성입니다.

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

RoleScope

역할 scope.

Name	형식	Description
/	string	전역 범위
/keys	string	키 scope