ロールを作成してサービスエージェントに付与する

Google Cloud では、Google Cloud サービスを有効にして使用すると、プロジェクトレベル、フォルダレベル、組織レベルのサービスエージェントが自動的に作成されます。これらのサービスエージェントには、ユーザーに代わってリソースを作成してアクセスできるロールが自動的に付与されることもあります。

サービスを利用する前に、必要に応じて、プロジェクトレベル、フォルダレベル、組織レベルのサービスエージェントを作成するように Google Cloud にリクエストすることもできます。サービスエージェントの作成を Google Cloud にリクエストすると、サービスを使用する前にサービスエージェントにロールを付与できます。サービスエージェントがまだ作成されていない場合は、ロールをサービスエージェントに付与できません。

このオプションは、次のいずれかの方法で許可ポリシーを管理する場合に便利です。

Terraform などの宣言型フレームワーク。Terraform 構成にサービスエージェントのロールが含まれていない場合、構成を適用するときに、これらのロールが取り消されます。サービスエージェントを作成して Terraform 構成でロールを付与することで、それらのロールが取り消されないようにします。
コードとしてのポリシー。現在の許可ポリシーのコピーをコードリポジトリに格納します。Google Cloud がサービスエージェントに自動的にロールを付与した場合、これらのロールは実際の許可ポリシーには存在しますが、格納された許可ポリシーのコピーには存在しません。この不整合を解決するときに、これらのロールを誤って取り消してしまう可能性があります。サービスエージェントを作成してロールを付与することで、コードリポジトリと実際の許可ポリシーの間の不整合を防ぐことができます。

サービスエージェントの作成をトリガーしたら、サービスエージェントに自動的に付与されるロールをサービスエージェントに付与する必要があります。そうしないと、一部のサービスが正しく機能しない可能性があります。これは、ユーザーのリクエストで作成されたサービスエージェントにはロールが自動的に付与されないためです。

始める前に

Enable the Resource Manager API.
Enable the API
サービスエージェントについて理解する。

必要なロール

サービスエージェントの作成をトリガーするために、IAM 権限は必要ありません。ただし、このページの他のタスクには特定の IAM 権限が必要です。

使用可能なサービスとそのエンドポイントを一覧表示するために必要な権限を取得するには、使用可能なサービスを一覧表示するプロジェクト、フォルダ、または組織に対する Service Usage 閲覧者（roles/serviceusage.serviceUsageViewer）の IAM ロールを付与するように管理者に依頼します。ロールの付与の詳細については、アクセスの管理をご覧ください。

この事前定義ロールには、使用可能なサービスとそのエンドポイントを一覧表示するために必要な serviceusage.services.list 権限が含まれています。
カスタムロールや他の事前定義ロールを使用して、この権限を取得することもできます。
サービスエージェントにアクセス権を付与するために必要な権限を取得するには、アクセス権を付与するプロジェクト、フォルダ、または組織に対する次の IAM ロールを付与するように管理者へ依頼します。
- サービスエージェントにプロジェクトへのアクセス権を付与する: プロジェクト IAM 管理者（roles/resourcemanager.projectIamAdmin）
- サービスエージェントにフォルダへのアクセス権を付与する: フォルダ管理者（roles/resourcemanager.folderAdmin）
- サービスエージェントにプロジェクト、フォルダ、組織へのアクセス権を付与する: 組織管理者（roles/resourcemanager.organizationAdmin）
ロールの付与の詳細については、アクセスの管理をご覧ください。

これらの事前定義ロールには、サービスエージェントにアクセス権を付与するために必要な権限が含まれています。必要な権限を正確に確認するには、「必要な権限」セクションを開いてください。
必要な権限

サービスエージェントにアクセス権を付与するには、次の権限が必要です。
- サービスエージェントにプロジェクトへのアクセス権を付与する:
  - resourcemanager.projects.getIamPolicy
  - resourcemanager.projects.setIamPolicy
- サービスエージェントにフォルダへのアクセス権を付与する:
  - resourcemanager.folders.getIamPolicy
  - resourcemanager.folders.setIamPolicy
- サービスエージェントに組織へのアクセス権を付与する:
  - resourcemanager.organizations.getIamPolicy
  - resourcemanager.organizations.setIamPolicy
カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

作成するサービスエージェントを特定する

Google Cloud に作成をリクエストする必要のあるプロジェクトレベル、フォルダレベル、組織レベルのサービスエージェントを確認するには、次の操作を行います。

使用するサービスとそれらの API エンドポイントのリストを作成します。使用可能なサービスとそのエンドポイントを表示するには、次のいずれかの方法を使用します。
コンソール

Google Cloud コンソールで [API ライブラリ] ページに移動します。

[API ライブラリ] に移動

API エンドポイントは、[詳細] セクションに記載されているサービス名です。
gcloud

gcloud services list コマンドは、プロジェクトで使用可能なサービスを一覧表示します。

後述のコマンドデータを使用する前に、次のように置き換えます。
- EXPRESSION: 省略可。結果をフィルタリングする式。たとえば、次の式は、名前に googleapis.com を含み、sandbox を含まないすべてのサービスをフィルタリングします。
```
name ~ googleapis.com AND name !~ sandbox
```
  フィルタ式の一覧については、gcloud topic filters をご覧ください。
- LIMIT: 省略可。リストに表示する結果の最大数。デフォルトは unlimited です。
次のコマンドを実行します。
Linux、macOS、Cloud Shell
```
gcloud services list --available --filter='EXPRESSION' --limit=LIMIT
```
Windows（PowerShell）
```
gcloud services list --available --filter='EXPRESSION' --limit=LIMIT
```
Windows（cmd.exe）

注: このコマンドでコンテンツの引用に ' を使用する場合は、これらの一重引用符を二重引用符で置き換えてください。引用がネストされている場合は、\" を使用して内側の引用符をエスケープします。
```
gcloud services list --available --filter='EXPRESSION' --limit=LIMIT
```
レスポンスには、使用可能なすべてのサービスの名前とタイトルが含まれます。API エンドポイントは NAME フィールドの値です。
REST

Service Usage API の services.list メソッドは、プロジェクトで使用可能なすべてのサービスを一覧表示します。

リクエストのデータを使用する前に、次のように置き換えます。
- RESOURCE_TYPE: 使用可能なサービスを一覧表示するリソースのタイプ。projects、folders、または organizations を使用します。
- RESOURCE_ID: 使用可能なサービスを一覧表示する Google Cloud プロジェクト、フォルダ、または組織の ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。
- PAGE_SIZE: 省略可。レスポンスに含めるサービスの数。デフォルト値は 50、最大値は 200 です。サービスの数がページサイズより大きい場合、レスポンスには結果の次のページを取得するために使用できるページ設定トークンが含まれます。
- NEXT_PAGE_TOKEN: 省略可。以前のレスポンスでこのメソッドから返されたページ設定トークン。指定すると、前のリクエストが終了した時点からサービスの一覧表示が開始します。
HTTP メソッドと URL:
```
GET https://serviceusage.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/services?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN
```
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して自分のユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://serviceusage.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/services?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN"
PowerShell（Windows）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、自分のユーザーアカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://serviceusage.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/services?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN" | Select-Object -Expand Content
レスポンスには、リソースで使用可能なすべてのサービスの名前とタイトルが含まれます。使用可能なサービスの数がページサイズを超えた場合、レスポンスにはページネーショントークンも含まれます。

API エンドポイントは name フィールドの値です。
サービスエージェントのリファレンスページで API エンドポイントを検索します。

エンドポイントが表にある場合は、そのエンドポイントのすべてのサービスエージェントを見つけます。メールアドレスに IDENTIFIER プレースホルダが含まれているサービスエージェントは無視します。サービスエージェントはプロジェクト固有のリソースであり、プロジェクト、フォルダ、組織のリソースではありません。

プロジェクトレベル、フォルダレベル、組織レベルのサービスエージェントごとに、次のことを記録します。
- サービスアカウントのメールアドレスの形式。
- サービスエージェントに付与されているロール（ある場合）。

サービスエージェントの作成をトリガーする

どのサービスエージェントを作成する必要があるかを把握したら、Google Cloud に作成をリクエストします。

Google Cloud にサービスエージェントの作成をリクエストする場合は、サービスとリソースを提供します。Google Cloud は、そのサービスとそのリソース用のすべてのサービスエージェントを作成します。

gcloud

サービスエージェントを作成する必要があるサービスごとに、次の操作を行います。

サービスのサービスエージェントのメールアドレスを確認します。メールアドレスのプレースホルダを使用して、サービスエージェントの作成に必要なリソースを決定します。

プレースホルダ	サービスエージェントを作成する場所
`PROJECT_NUMBER`	サービスを使用する各プロジェクト
`FOLDER_NUMBER`	サービスを使用する各フォルダ
`ORGANIZATION_NUMBER`	サービスを使用する各組織

各リソースにサービスエージェントを作成します。

gcloud beta services identity create コマンドは、指定した API とリソースのすべてのサービスエージェントを作成します。

後述のコマンドデータを使用する前に、次のように置き換えます。
- ENDPOINT: サービスエージェントを作成する API のエンドポイント（例: aiplatform.googleapis.com）。
- RESOURCE_TYPE: サービスエージェントを作成するリソースのタイプ。project、folder、または organization を使用します。
- RESOURCE_ID: サービスエージェントを作成する Google Cloud のプロジェクト、フォルダ、または組織の ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。
  
  サービスエージェントは一度に 1 つのリソースに対して作成できます。複数のリソースにサービスエージェントを作成する必要がある場合は、リソースごとにコマンドを 1 回実行します。
次のコマンドを実行します。
Linux、macOS、Cloud Shell
```
gcloud beta services identity create --service=ENDPOINT \
    --RESOURCE_TYPE=RESOURCE_ID
```
Windows（PowerShell）
```
gcloud beta services identity create --service=ENDPOINT `
    --RESOURCE_TYPE=RESOURCE_ID
```
Windows（cmd.exe）
```
gcloud beta services identity create --service=ENDPOINT ^
    --RESOURCE_TYPE=RESOURCE_ID
```
レスポンスには、サービスのプライマリサービスエージェントのメールアドレスが含まれます。このメールアドレスには、サービスエージェントを作成したプロジェクト、フォルダ、または組織の数値 ID が含まれます。

サービスにプライマリサービスエージェントがない場合、レスポンスにメールアドレスは含まれません。

プライマリサービスエージェントがあるサービスのレスポンスは次のようになります。
```
Service identity created: service-232332569935@gcp-sa-aiplatform.iam.gserviceaccount.com
```
省略可: レスポンスに含まれているサービスエージェントのメールアドレスを記録します（存在する場合）。このメールアドレスにより、サービスのプライマリサービスエージェントを識別できます。この ID を使用して、プライマリサービスエージェントにロールを付与できます。

Terraform

Terraform 構成を適用または削除する方法については、基本的な Terraform コマンドをご覧ください。詳細については、Terraform プロバイダのリファレンスドキュメントをご覧ください。

サービスエージェントを作成する必要があるサービスごとに、次の操作を行います。

プレースホルダ	サービスエージェントを作成する場所
`PROJECT_NUMBER`	サービスを使用する各プロジェクト
`FOLDER_NUMBER`	サービスを使用する各フォルダ
`ORGANIZATION_NUMBER`	サービスを使用する各組織

各リソースにサービスエージェントを作成します。たとえば、次のコードは、AI Platform のすべてのプロジェクトレベルのサービスエージェントを作成します。

注: Terraform では、プロジェクトレベルのサービスエージェントの作成のみがサポートされています。フォルダレベルと組織レベルのサービスエージェントの作成をトリガーするには、Google Cloud CLI または REST API を使用します。

data "google_project" "default" {
}

# Create all project-level aiplatform.googleapis.com service agents
resource "google_project_service_identity" "default" {
  provider = google-beta

  project = data.google_project.default.project_id
  service = "aiplatform.googleapis.com"
}

REST

サービスエージェントを作成する必要があるサービスごとに、次の操作を行います。

プレースホルダ	サービスエージェントを作成する場所
`PROJECT_NUMBER`	サービスを使用する各プロジェクト
`FOLDER_NUMBER`	サービスを使用する各フォルダ
`ORGANIZATION_NUMBER`	サービスを使用する各組織

各リソースにサービスエージェントを作成します。

Service Usage API の services.generateServiceIdentity メソッドは、指定された API とリソースのすべてのサービスエージェントを作成します。

リクエストのデータを使用する前に、次のように置き換えます。
- RESOURCE_TYPE: サービスエージェントを作成するリソースのタイプ。projects、folders、または organizations を使用します。
- RESOURCE_ID: サービスエージェントを作成する Google Cloud のプロジェクト、フォルダ、または組織の ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。
  
  サービスエージェントは一度に 1 つのリソースに対して作成できます。複数のリソースにサービスエージェントを作成する必要がある場合は、リソースごとに 1 つのリクエストを送信します。
- ENDPOINT: サービスエージェントを作成する API のエンドポイント（例: aiplatform.googleapis.com）。
HTTP メソッドと URL:
```
POST https://serviceusage.googleapis.com/v1beta1/RESOURCE_TYPE/RESOURCE_ID/services/ENDPOINT:generateServiceIdentity
```
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して自分のユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。
```
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1beta1/RESOURCE_TYPE/RESOURCE_ID/services/ENDPOINT:generateServiceIdentity"
```
PowerShell（Windows）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、自分のユーザーアカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1beta1/RESOURCE_TYPE/RESOURCE_ID/services/ENDPOINT:generateServiceIdentity" | Select-Object -Expand Content
```
レスポンスには、リクエストのステータスを示す Operation が含まれています。オペレーションのステータスを確認するには、operations.get メソッドを使用します。

終了したオペレーションには、サービスのプライマリサービスエージェントのメールアドレスが含まれます。このメールアドレスには、サービスエージェントを作成したプロジェクト、フォルダ、または組織の数値 ID が含まれます。

サービスにプライマリサービスエージェントがない場合、レスポンスにメールアドレスは含まれません。

以下に、プライマリサービスエージェントがあるサービスに対して終了したオペレーションの例を示します。
```
{
  "name": "operations/finished.DONE_OPERATION",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1beta1.ServiceIdentity",
    "email": "service-232332569935@gcp-sa-aiplatform.iam.gserviceaccount.com",
    "uniqueId": "112245693826560101651"
  }
}
```
省略可: レスポンスに含まれているサービスエージェントのメールアドレスを記録します（存在する場合）。このメールアドレスにより、サービスのプライマリサービスエージェントを識別できます。この ID を使用して、プライマリサービスエージェントにロールを付与できます。

サービスエージェントにロールを付与する

Google Cloud でプロジェクト、フォルダ、組織に必要なサービスエージェントが作成されたら、サービスエージェントのメールアドレスを使用してロールを付与します。

Google Cloud でサービスエージェントの作成をリクエストした場合は、自動的に付与されるロールをそのサービスエージェントに付与する必要があります。そうしないと、一部のサービスが正しく機能しない可能性があります。これは、ユーザーのリクエストで作成されたサービスエージェントにはロールが自動的に付与されないためです。

自動的に付与されるロールを特定する方法については、作成するサービスエージェントを特定するをご覧ください。

サービスエージェントのメールアドレスを確認する

サービスエージェントのメールアドレスを確認するには、次の手順を行います。

gcloud

まだ行なっていない場合、サービスエージェントのメールアドレス形式を確認します。この形式は、サービスエージェントのリファレンスに記載されています。
メールアドレスのプレースホルダは、対応するプロジェクト、フォルダ、または組織番号に置き換えます。

または、サービスエージェントがプライマリサービスエージェントの場合は、サービスに対してサービスエージェントの作成をトリガーすることで、そのメールアドレスを取得できます。サービスエージェントの作成をトリガーするコマンドは、プライマリサービスエージェントのメールアドレスを返します。

Terraform

まだ行なっていない場合、サービスエージェントのメールアドレス形式を確認します。この形式は、サービスエージェントのリファレンスに記載されています。
メールアドレスのプレースホルダは、適切なプロジェクト、フォルダ、または組織番号を参照する式に置き換えます。

次の状況について考えてみましょう。
- メールアドレスの形式が service-PROJECT_NUMBER@gcp-sa-aiplatform-cc.iam.gserviceaccount.com
- サービスエージェントは default という名前のプロジェクト用
この場合、サービスエージェントのメールアドレスは次のようになります。
```
service-${data.google_project.default.number}@gcp-sa-aiplatform-cc.iam.gserviceaccount.com
```

また、サービスエージェントがサービスのプライマリサービスエージェントの場合は、google_project_service_identity リソースの email 属性からメールアドレスを取得できます。

たとえば、default というラベルが付いた google_project_service_identity ブロックがある場合、次の式を使用して、サービスのプライマリサービスエージェントのメールアドレスを取得できます。

${google_project_service_identity.default.email}

REST

まだ行なっていない場合、サービスエージェントのメールアドレス形式を確認します。この形式は、サービスエージェントのリファレンスに記載されています。
メールアドレスのプレースホルダは、対応するプロジェクト、フォルダ、または組織番号に置き換えます。

サービスアカウントにロールを付与する

サービスエージェントのメールアドレスを確認したら、他のプリンシパルにロールを付与する場合と同様にロールを付与できます。

コンソール

Google Cloud コンソールの [IAM] ページに移動します。

[IAM] に移動
プロジェクト、フォルダ、または組織を選択します。
[アクセス権を付与] をクリックして、サービスエージェントのメールアドレスを入力します。
付与するロールをプルダウンリストから選択します。
（省略可）ロールに条件を追加します。
[保存] をクリックします。リソースに対するロールがサービスエージェントに付与されます。

gcloud

add-iam-policy-binding コマンドを使用すると、プリンシパルにロールをすばやく付与できます。

後述のコマンドデータを使用する前に、次のように置き換えます。

RESOURCE_TYPE: アクセスを管理するリソースタイプ。projects、resource-manager folders、または organizations を使用します。
RESOURCE_ID: Google Cloud プロジェクト、フォルダ、または組織 ID。プロジェクト ID は英数字です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。
PRINCIPAL: プリンシパルまたはメンバーの識別子。通常、PRINCIPAL_TYPE:ID の形式で指定します（例: user:my-user@example.com）。PRINCIPAL に使用できる値の一覧については、ポリシーバインディングのリファレンスをご覧ください。

プリンシパルタイプが user の場合、識別子に含まれるドメイン名は Google Workspace ドメインまたは Cloud Identity ドメインである必要があります。Cloud Identity ドメインの設定方法については、Cloud Identity の概要をご覧ください。
ROLE_NAME: 取り消すロールの名前。次のいずれかの形式で指定してください。
- 事前定義ロール: roles/SERVICE.IDENTIFIER
- プロジェクトレベルのカスタムロール: projects/PROJECT_ID/roles/IDENTIFIER
- 組織レベルのカスタムロール: organizations/ORG_ID/roles/IDENTIFIER
事前定義ロールのリストについては、ロールについてをご覧ください。
CONDITION: ロールバインディングに追加する条件。条件を追加しない場合は、値 None を使用します。条件の詳細については、条件の概要をご覧ください。

次のコマンドを実行します。

Linux、macOS、Cloud Shell

gcloud RESOURCE_TYPE add-iam-policy-binding RESOURCE_ID \
    --member=PRINCIPAL --role=ROLE_NAME \
    --condition=CONDITION

Windows（PowerShell）

gcloud RESOURCE_TYPE add-iam-policy-binding RESOURCE_ID `
    --member=PRINCIPAL --role=ROLE_NAME `
    --condition=CONDITION

Windows（cmd.exe）

gcloud RESOURCE_TYPE add-iam-policy-binding RESOURCE_ID ^
    --member=PRINCIPAL --role=ROLE_NAME ^
    --condition=CONDITION

レスポンスには、更新された IAM ポリシーが含まれます。

Terraform

# Grant the AI Platform Custom Code Service Account the Vertex AI Custom
# Code Service Agent role (roles/aiplatform.customCodeServiceAgent)
resource "google_project_iam_member" "custom_code" {
  project = data.google_project.default.project_id
  role    = "roles/aiplatform.customCodeServiceAgent"
  member  = "serviceAccount:service-${data.google_project.default.number}@gcp-sa-aiplatform-cc.iam.gserviceaccount.com"
}

# Grant the primary aiplatform.googleapis.com service agent (AI Platform
# Service Agent) the Vertex AI Service Agent role
# (roles/aiplatform.serviceAgent)
resource "google_project_iam_member" "primary" {
  project = data.google_project.default.project_id
  role    = "roles/aiplatform.serviceAgent"
  member  = "serviceAccount:${google_project_service_identity.default.email}"
}

REST

REST API でロールを付与するには、読み取り - 変更 - 書き込みのパターンを使用します。

getIamPolicy() を呼び出して、現在の許可ポリシーを読み取ります。

Resource Manager API の getIamPolicy メソッドは、プロジェクト、フォルダ、または組織の許可ポリシーを取得します。

リクエストのデータを使用する前に、次のように置き換えます。
- API_VERSION: 使用する API のバージョン。プロジェクトと組織の場合は、v1 を使用します。フォルダの場合は、v2 を使用します。
- RESOURCE_TYPE: ポリシーを管理するリソースタイプ。値 projects、folders、または organizations を使用します。
- RESOURCE_ID: Google Cloud プロジェクト、組織、またはフォルダ ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。
- POLICY_VERSION: 返されるポリシーバージョン。リクエストでは、最新のポリシーバージョン（ポリシーバージョン 3）を指定する必要があります。詳細については、ポリシーの取得時にポリシーバージョンを指定するをご覧ください。
HTTP メソッドと URL:
```
POST https://cloudresourcemanager.googleapis.com/API_VERSION/RESOURCE_TYPE/RESOURCE_ID:getIamPolicy
```
リクエストの本文（JSON）:
```
{
  "options": {
    "requestedPolicyVersion": POLICY_VERSION
  }
}
```
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して自分のユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
```
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/API_VERSION/RESOURCE_TYPE/RESOURCE_ID:getIamPolicy"
```
PowerShell（Windows）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、自分のユーザーアカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/API_VERSION/RESOURCE_TYPE/RESOURCE_ID:getIamPolicy" | Select-Object -Expand Content
```
API Explorer（ブラウザ）

リクエスト本文をコピーして、メソッドのリファレンスページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。このツールにリクエスト本文を貼り付け、その他の必須フィールドに入力して、[Execute] をクリックします。

レスポンスには、リソースの許可ポリシーが含まれます。次に例を示します。
```
{
  "version": 1,
  "etag": "BwWKmjvelug=",
  "bindings": [
    {
      "role": "roles/owner",
      "members": [
        "user:owner@example.com"
      ]
    }
  ]
}
```
テキストエディタまたはプログラムでリソースの許可ポリシーを編集して、プリンシパルまたはロールバインディングの追加や削除を行います。たとえば、新しいロールバインディングの追加、既存のロールバインディングの削除、既存のロールバインディングからのプリンシパルの追加や削除を行うことができます。
setIamPolicy() を呼び出して、更新された許可ポリシーを作成します。

Resource Manager API の setIamPolicy メソッドを使用して、プロジェクト、フォルダまたは組織の新しい許可ポリシーとしてリクエストのポリシーを設定します。

リクエストのデータを使用する前に、次のように置き換えます。
- API_VERSION: 使用する API のバージョン。プロジェクトと組織の場合は、v1 を使用します。フォルダの場合は、v2 を使用します。
- RESOURCE_TYPE: ポリシーを管理するリソースタイプ。値 projects、folders、または organizations を使用します。
- RESOURCE_ID: Google Cloud プロジェクト、組織、またはフォルダ ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。
- POLICY: 設定するポリシーの JSON 表現。ポリシーの形式については、ポリシーリファレンスをご覧ください。
HTTP メソッドと URL:
```
POST https://cloudresourcemanager.googleapis.com/API_VERSION/RESOURCE_TYPE/RESOURCE_ID:setIamPolicy
```
リクエストの本文（JSON）:
```
{
  "policy": POLICY
}
```
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して自分のユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
```
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/API_VERSION/RESOURCE_TYPE/RESOURCE_ID:setIamPolicy"
```
PowerShell（Windows）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、自分のユーザーアカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/API_VERSION/RESOURCE_TYPE/RESOURCE_ID:setIamPolicy" | Select-Object -Expand Content
```
API Explorer（ブラウザ）

リクエスト本文をコピーして、メソッドのリファレンスページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。このツールにリクエスト本文を貼り付け、その他の必須フィールドに入力して、[Execute] をクリックします。

レスポンスには、更新された許可ポリシーが含まれます。

注: 許可ポリシーをコードとして扱い、バージョン管理システムに保存する場合は、リクエストで送信したポリシーではなく、返されるポリシーを保存する必要があります。

次のステップ

すべてのサービスエージェントのリストを表示する。
プリンシパルにロールを付与する他の方法を確認する。
ワークロードの ID として機能するユーザー管理のサービスアカウントを作成する方法を学習する。
Google Cloud で Terraform を使用するためのベストプラクティスの詳細を学習する。
すべての Google Cloud Terraform のサンプルを確認する。

ロールを作成してサービス エージェントに付与する

始める前に

必要なロール

必要な権限

作成するサービス エージェントを特定する

コンソール

gcloud

Linux、macOS、Cloud Shell

Windows（PowerShell）

Windows（cmd.exe）

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

サービス エージェントの作成をトリガーする

gcloud

Linux、macOS、Cloud Shell

Windows（PowerShell）

Windows（cmd.exe）

Terraform

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

サービス エージェントにロールを付与する

サービス エージェントのメールアドレスを確認する

gcloud

Terraform

REST

サービス アカウントにロールを付与する

コンソール

gcloud

Linux、macOS、Cloud Shell

Windows（PowerShell）

Windows（cmd.exe）

Terraform

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

API Explorer（ブラウザ）

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

API Explorer（ブラウザ）

次のステップ

ロールを作成してサービスエージェントに付与する

作成するサービスエージェントを特定する

サービスエージェントの作成をトリガーする

サービスエージェントにロールを付与する

サービスエージェントのメールアドレスを確認する

サービスアカウントにロールを付与する