Role Assignments - Create

ロールの割り当てを作成します。

PUT https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleAssignments/{roleAssignmentName}?api-version=2015-07-01

URI パラメーター

Name In Required Type Description
roleAssignmentName
path True
  • string

作成するロールの割り当ての名前。 任意の有効な GUID を指定できます。

scope
path True
  • string

作成するロールの割り当てのスコープ。 スコープには、任意の REST リソース インスタンスを指定できます。 たとえば、サブスクリプションには '/subscriptions/{subscription-id}/' を使用し、リソース グループには '/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}' を使用し、リソースには '/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/{resource-provider}/{resource-type}/{resource-name}' を使用します。

api-version
query True
  • string

この操作に使用する API バージョン。

要求本文

Name Required Type Description
properties True

ロールの割り当てプロパティ。

応答

Name Type Description
201 Created

Created - ロールの割り当てに関する情報を返します。

Other Status Codes

操作に失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation ユーザー アカウントを偽装する

Create role assignment

Sample Request

PUT https://management.azure.com/scope/providers/Microsoft.Authorization/roleAssignments/roleAssignmentName?api-version=2015-07-01
{
  "properties": {
    "roleDefinitionId": "/subscriptions/4004a9fd-d58e-48dc-aeb2-4a4aec58606f/providers/Microsoft.Authorization/roleDefinitions/de139f84-1756-47ae-9be6-808fbbe84772",
    "principalId": "d93a38bc-d029-4160-bfb0-fbda779ac214"
  }
}

Sample Response

{
  "properties": {
    "roleDefinitionId": "/subscriptions/subId/providers/Microsoft.Authorization/roleDefinitions/roledefinitionId",
    "principalId": "Pid",
    "scope": "/subscriptions/subId/resourcegroups/rgname"
  },
  "id": "/subscriptions/subId/resourcegroups/rgname/providers/Microsoft.Authorization/roleAssignments/roleassignmentId",
  "type": "Microsoft.Authorization/roleAssignments",
  "name": "roleassignmentId"
}

定義

ErrorAdditionalInfo

リソース管理エラーの追加情報。

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

RoleAssignment

ロールの割り当て

RoleAssignmentCreateParameters

ロールの割り当てによってパラメーターが作成されます。

RoleAssignmentProperties

ロールの割り当てプロパティ。

RoleAssignmentPropertiesWithScope

スコープを持つロールの割り当てプロパティ。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

Name Type Description
info
  • object

追加情報。

type
  • string

追加情報の種類。

ErrorDetail

エラーの詳細。

Name Type Description
additionalInfo

エラーの追加情報。

code
  • string

エラー コード。

details

エラーの詳細です。

message
  • string

エラー メッセージ。

target
  • string

エラー ターゲット。

ErrorResponse

エラー応答

Name Type Description
error

エラー オブジェクト。

RoleAssignment

ロールの割り当て

Name Type Description
id
  • string

ロールの割り当て ID

name
  • string

ロールの割り当て名。

properties

ロールの割り当てプロパティ。

type
  • string

ロールの割り当ての種類。

RoleAssignmentCreateParameters

ロールの割り当てによってパラメーターが作成されます。

Name Type Description
properties

ロールの割り当てプロパティ。

RoleAssignmentProperties

ロールの割り当てプロパティ。

Name Type Description
principalId
  • string

ロールに割り当てられたプリンシパル ID。 これは Active Directory 内の ID にマップされます。 ユーザー、サービス プリンシパル、またはセキュリティ グループを指す場合があります。

roleDefinitionId
  • string

ロールの割り当てで使用されるロール定義 ID。

RoleAssignmentPropertiesWithScope

スコープを持つロールの割り当てプロパティ。

Name Type Description
principalId
  • string

プリンシパル ID。

roleDefinitionId
  • string

ロール定義 ID

scope
  • string

ロールの割り当てスコープ。