Role Definitions - Get By Id

ロールの定義を ID で取得します。

GET https://management.azure.com/{roleDefinitionId}?api-version=2015-07-01

URI パラメーター

Name In Required Type Description
roleDefinitionId
path True
  • string

ロール定義の完全修飾 ID。 サブスクリプションレベルのロールの定義には/subscriptions/{guid}/providers/Microsoft.Authorization/roleDefinitions/{roleDefinitionId}、テナントレベルのロールの定義には/providers/Microsoft.Authorization/roleDefinitions/{roleDefinitionId} を使用します。

api-version
query True
  • string

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

応答

Name Type Description
200 OK

OK-ロールの定義に関する情報を返します。

Other Status Codes

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

セキュリティ

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation ユーザーアカウントの権限を借用する

Get role definition by ID

Sample Request

GET https://management.azure.com/roleDefinitionId?api-version=2015-07-01

Sample Response

{
  "properties": {
    "roleName": "Role name",
    "type": "roletype",
    "description": "Role description",
    "assignableScopes": [
      "/subscriptions/subId"
    ],
    "permissions": [
      {
        "actions": [
          "action"
        ],
        "notActions": []
      }
    ]
  },
  "id": "/subscriptions/subID/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
  "type": "Microsoft.Authorization/roleDefinitions",
  "name": "roleDefinitionId"
}

定義

ErrorAdditionalInfo

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

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

Permission

ロールの定義のアクセス許可。

RoleDefinition

ロールの定義。

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

エラーオブジェクト。

Permission

ロールの定義のアクセス許可。

Name Type Description
actions
  • string[]

許可されるアクション。

notActions
  • string[]

拒否されたアクション。

RoleDefinition

ロールの定義。

Name Type Description
id
  • string

ロール定義 ID

name
  • string

ロールの定義名。

properties.assignableScopes
  • string[]

ロール定義の割り当て可能スコープ。

properties.description
  • string

ロール定義の説明です。

properties.permissions

ロールの定義のアクセス許可。

properties.roleName
  • string

ロール名。

properties.type
  • string

ロールの種類。

type
  • string

ロールの定義の種類。