チュートリアル: Azure CLI を使用して Azure カスタムロールを作成する

Azure の組み込みロールが組織の特定のニーズを満たさない場合は、独自のカスタムロールを作成することができます。このチュートリアルでは、Azure CLI を使用して Reader Support Tickets という名前のカスタムロールを作成します。カスタムロールを使用すると、ユーザーはサブスクリプションのコントロールプレーン内のすべてを表示したり、サポートチケットを開いたりすることができます。

このチュートリアルでは、以下の内容を学習します。

カスタムロールの作成
カスタムロールを一覧表示する
カスタムロールを更新する
カスタムロールを削除する

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。

[前提条件]

このチュートリアルを完了するには、次のものが必要です。

ユーザーアクセス管理者などのカスタムロールを作成するためのアクセス許可
Azure Cloud Shell または Azure CLI

Azure CLI にサインインします。

カスタムロールの作成

カスタムロールを作成する最も簡単な方法は、JSON テンプレートから開始し、変更を追加してから、新しいロールを作成することです。

Microsoft.Support リソースプロバイダーのアクションの一覧を確認します。アクセス許可の作成に使用できるアクションを把握しておくと便利です。

アクション	Description
Microsoft.Support/register/action	リソースプロバイダーをサポートするためのレジスタ
Microsoft.Support/supportTickets/read	サポートチケットの詳細 (状態、重大度、連絡先の詳細、通信を含む) を取得するか、サブスクリプション全体のサポートチケットの一覧を取得します。
Microsoft.Support/supportTickets/write	サポートチケットを作成または更新します。テクニカル、課金、クォータ、またはサブスクリプション管理に関連する問題のサポートチケットを作成できます。既存のサポートチケットの重大度、連絡先の詳細、通信を更新できます。

ReaderSupportRole.jsonという名前の新しいファイル を作成します 。
エディターで ReaderSupportRole.json を開き、次の JSON を追加します。

さまざまなプロパティの詳細については、 Azure カスタムロールに関するページを参照してください。
```
{
  "Name": "",
  "IsCustom": true,
  "Description": "",
  "Actions": [],
  "NotActions": [],
  "DataActions": [],
  "NotDataActions": [],
  "AssignableScopes": [
    "/subscriptions/{subscriptionId1}"
  ]
}
```
Actions プロパティに次のアクションを追加します。これらのアクションを使用すると、ユーザーはサブスクリプション内のすべてを表示し、サポートチケットを作成できます。
```
"*/read",
"Microsoft.Support/*"
```
az account list コマンドを使用して、サブスクリプションの ID を取得します。
```
az account list --output table
```
AssignableScopesで、{subscriptionId1}をサブスクリプション ID に置き換えます。

明示的なサブスクリプション ID を追加する必要があります。そうしないと、ロールをサブスクリプションにインポートすることはできません。

NameとDescriptionのプロパティを "閲覧者サポートチケット" と "サブスクリプション内のすべてを表示し、サポートチケットを開く" に変更します。

JSON ファイルは次のようになります。

{
  "Name": "Reader Support Tickets",
  "IsCustom": true,
  "Description": "View everything in the subscription and also open support tickets.",
  "Actions": [
    "*/read",
    "Microsoft.Support/*"
  ],
  "NotActions": [],
  "DataActions": [],
  "NotDataActions": [],
  "AssignableScopes": [
    "/subscriptions/00000000-0000-0000-0000-000000000000"
  ]
}

新しいカスタムロールを作成するには、 az role definition create コマンドを使用し、JSON ロール定義ファイルを指定します。

az role definition create --role-definition "~/CustomRoles/ReaderSupportRole.json"

{
  "additionalProperties": {},
  "assignableScopes": [
    "/subscriptions/00000000-0000-0000-0000-000000000000"
  ],
  "description": "View everything in the subscription and also open support tickets.",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Authorization/roleDefinitions/22222222-2222-2222-2222-222222222222",
  "name": "22222222-2222-2222-2222-222222222222",
  "permissions": [
    {
      "actions": [
        "*/read",
        "Microsoft.Support/*"
      ],
      "additionalProperties": {},
      "dataActions": [],
      "notActions": [],
      "notDataActions": []
    }
  ],
  "roleName": "Reader Support Tickets",
  "roleType": "CustomRole",
  "type": "Microsoft.Authorization/roleDefinitions"
}

新しいカスタムロールが使用可能になり、組み込みロールと同様に、ユーザー、グループ、またはサービスプリンシパルに割り当てることができます。

カスタムロールを一覧表示する

すべてのカスタムロールを一覧表示するには、 az role definition list コマンドと --custom-role-only パラメーターを使用します。

az role definition list --custom-role-only true

[
  {
    "additionalProperties": {},
    "assignableScopes": [
      "/subscriptions/00000000-0000-0000-0000-000000000000"
    ],
    "description": "View everything in the subscription and also open support tickets.",
    "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Authorization/roleDefinitions/22222222-2222-2222-2222-222222222222",
    "name": "22222222-2222-2222-2222-222222222222",
    "permissions": [
      {
        "actions": [
          "*/read",
          "Microsoft.Support/*",
          "Microsoft.Resources/deployments/*",
          "Microsoft.Insights/diagnosticSettings/*/read"
        ],
        "additionalProperties": {},
        "dataActions": [],
        "notActions": [],
        "notDataActions": []
      }
    ],
    "roleName": "Reader Support Tickets",
    "roleType": "CustomRole",
    "type": "Microsoft.Authorization/roleDefinitions"
  }
]

Azure portal でカスタムロールを確認することもできます。

Azure portal でインポートされたカスタムロールのスクリーンショット

カスタムロールを更新する

カスタムロールを更新するには、JSON ファイルを更新してから、カスタムロールを更新します。

ReaderSupportRole.json ファイルを開きます。

Actionsで、"Microsoft.Resources/deployments/*"リソースグループのデプロイを作成および管理するアクションを追加します。前のアクションの後にコンマを必ず含めます。

更新された JSON ファイルは次のようになります。

{
  "Name": "Reader Support Tickets",
  "IsCustom": true,
  "Description": "View everything in the subscription and also open support tickets.",
  "Actions": [
    "*/read",
    "Microsoft.Support/*",
    "Microsoft.Resources/deployments/*"
  ],
  "NotActions": [],
  "DataActions": [],
  "NotDataActions": [],
  "AssignableScopes": [
    "/subscriptions/00000000-0000-0000-0000-000000000000"
  ]
}

カスタムロールを更新するには、 az role definition update コマンドを使用し、更新された JSON ファイルを指定します。

az role definition update --role-definition "~/CustomRoles/ReaderSupportRole.json"

{
  "additionalProperties": {},
  "assignableScopes": [
    "/subscriptions/00000000-0000-0000-0000-000000000000"
  ],
  "description": "View everything in the subscription and also open support tickets.",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Authorization/roleDefinitions/22222222-2222-2222-2222-222222222222",
  "name": "22222222-2222-2222-2222-222222222222",
  "permissions": [
    {
      "actions": [
        "*/read",
        "Microsoft.Support/*",
        "Microsoft.Resources/deployments/*"
      ],
      "additionalProperties": {},
      "dataActions": [],
      "notActions": [],
      "notDataActions": []
    }
  ],
  "roleName": "Reader Support Tickets",
  "roleType": "CustomRole",
  "type": "Microsoft.Authorization/roleDefinitions"
}

カスタムロールを削除する

az role definition delete コマンドを使用し、カスタムロールを削除するロール名またはロール ID を指定します。
```
az role definition delete --name "Reader Support Tickets"
```

次のステップ

Azure CLI を使用して Azure カスタムロールを作成または更新する

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-10-09

次の方法で共有

チュートリアル: Azure CLI を使用して Azure カスタム ロールを作成する

[前提条件]

Azure CLI へのサインイン

カスタム ロールの作成

カスタム ロールを一覧表示する

カスタム ロールを更新する

カスタム ロールを削除する