Role Assignments - List For Scope

スコープに適用されるすべてのロールの割り当てを一覧表示します。

GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleAssignments?api-version=2022-04-01
GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleAssignments?$filter={$filter}&api-version=2022-04-01&tenantId={tenantId}&$skipToken={$skipToken}

URI パラメーター

名前 / 必須 説明
scope
path True

string

操作またはリソースのスコープ。 有効なスコープは、サブスクリプション (形式: '/subscriptions/{subscriptionId}')、リソース グループ (形式: '/subscriptionId}/resourceGroups/{resourceGroupName}')、またはリソース (形式: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}' です。

api-version
query True

string

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

$filter
query

string

操作に適用するフィルター。 スコープ以上のすべてのロールの割り当てを返すには、$filter=atScope() を使用します。 $filter=principalId eq {id} を使用して、指定したプリンシパルのスコープの上または下にあるすべてのロールの割り当てを返します。

$skipToken
query

string

操作に適用する skipToken。 渡された skipToken の後にページ ロールの割り当てを返すには、$skipToken={skiptoken} を使用します。 プロバイダー レベルの呼び出しでのみサポートされます。

tenantId
query

string

テナント間要求のテナント ID

応答

名前 説明
200 OK

RoleAssignmentListResult

ロールの割り当ての配列を返します。

Other Status Codes

ErrorResponse

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

アクセス許可

この API を呼び出すには、次のアクセス許可を持つロールがお客様に割り当てられている必要があります。 詳細については、Azure の組み込みロールに関するページを参照してください。

Microsoft.Authorization/roleAssignments/read

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントの借用

List role assignments for scope

要求のサンプル

GET https://management.azure.com/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/providers/Microsoft.Authorization/roleAssignments?api-version=2022-04-01

応答のサンプル

{
  "value": [
    {
      "properties": {
        "roleDefinitionId": "/providers/Microsoft.Authorization/roleDefinitions/0b5fe924-9a61-425c-96af-cfe6e287ca2d",
        "principalId": "ce2ce14e-85d7-4629-bdbc-454d0519d987",
        "principalType": "User",
        "scope": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2"
      },
      "id": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/providers/Microsoft.Authorization/roleAssignments/b0f43c54-e787-4862-89b1-a653fa9cf747",
      "type": "Microsoft.Authorization/roleAssignments",
      "name": "b0f43c54-e787-4862-89b1-a653fa9cf747"
    }
  ]
}

定義

名前 説明
ErrorAdditionalInfo

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

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

PrincipalType

割り当てられたプリンシパル ID のプリンシパルの種類。

RoleAssignment

ロールの割り当て

RoleAssignmentListResult

ロールの割り当てリスト操作の結果。

ErrorAdditionalInfo

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

名前 説明
info

object

追加情報。

type

string

追加情報の種類。

ErrorDetail

エラーの詳細。

名前 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

ErrorDetail[]

エラーの詳細です。

message

string

エラー メッセージ。

target

string

エラーのターゲット。

ErrorResponse

エラー応答

名前 説明
error

ErrorDetail

error オブジェクト。

PrincipalType

割り当てられたプリンシパル ID のプリンシパルの種類。

名前 説明
Device

string

ForeignGroup

string

Group

string

ServicePrincipal

string

User

string

RoleAssignment

ロールの割り当て

名前 規定値 説明
id

string

ロールの割り当て ID

name

string

ロールの割り当て名。

properties.condition

string

ロールの割り当てに関する条件。 これにより、割り当てることができるリソースが制限されます。例: @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'

properties.conditionVersion

string

条件のバージョン。 現在、受け入れられる値は '2.0' のみです

properties.createdBy

string

割り当てを作成したユーザーの ID

properties.createdOn

string

作成された時刻

properties.delegatedManagedIdentityResourceId

string

委任されたマネージド ID リソースの ID

properties.description

string

ロールの割り当ての説明

properties.principalId

string

プリンシパル ID。

properties.principalType

PrincipalType

User

割り当てられたプリンシパル ID のプリンシパルの種類。

properties.roleDefinitionId

string

ロール定義 ID

properties.scope

string

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

properties.updatedBy

string

割り当てを更新したユーザーの ID

properties.updatedOn

string

更新された時刻

type

string

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

RoleAssignmentListResult

ロールの割り当てリスト操作の結果。

名前 説明
nextLink

string

次の結果セットの取得に使用する skipToken。

value

RoleAssignment[]

ロールの割り当てリスト。