リーエンによるプロジェクトの保護

このドキュメントは、プロジェクトの削除に対する保護を追加しようと考えているプロジェクト オーナー組織管理者を対象としています。

プロジェクトにリーエンを適用すると、リーエンを削除するまでプロジェクトを削除できなくなります。これは、重要なプロジェクトを保護する場合に役立ちます。

また、リーエンは、プロジェクトに自動的に配置することもできます。たとえば、あるプロジェクトの Identity and Access Management(IAM)サービス アカウントを他のプロジェクト内のリソースに接続できるようにすると、そのサービス アカウントが置かれているプロジェクトにリーエンが配置されます。

準備

プロジェクト リーエンを操作するには、gcloud CLI を使用するのが最も簡単な方法です。このツールをインストールしていない場合は、Google Cloud Shell を使用できます。

必要なロール

リーエンの変更に必要な権限を取得するには、プロジェクトに対するプロジェクト リーエン修飾子roles/resourcemanager.lienModifier)IAM ロールの付与を管理者に依頼してください。 ロールの付与の詳細については、アクセス権の管理をご覧ください。

この事前定義ロールには、リーエンの変更に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

リーエンを変更するには、次の権限が必要です。

  • resourcemanager.projects.updateLiens
  • プロジェクトのリーエンを一覧表示します: resourcemanager.projects.get

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

プロジェクトにリーエンを適用する

プロジェクトに差し押さえを設定するには、alpha resource-manager liens create コマンドを使用します。

gcloud alpha resource-manager liens create \
  --project=[PROJECT_ID] \
  --restrictions=[PERMISSION_RESTRICTION] \
  --reason=[LIEN_REASON] \
  --origin=[LIEN_ORIGIN]

次のように置き換えます。

  • [PROJECT_ID]: リーエンを適用するプロジェクトの ID。
  • [PERMISSION_RESTRICTION]: ブロックする IAM 権限のカンマ区切りリスト。プロジェクトで有効な唯一の制限は resourcemanager.projects.delete です。
  • [LIEN_REASON]: リーエンの存在理由に関する説明(人が読める形式)。この説明は二重引用符で囲みます。例: "This project is protected by a lien"
  • [LIEN_ORIGIN]: リーエンの発生源となったユーザーまたはシステムを示す文字列。これは必須フィールドですが、省略した場合はユーザーのメールアドレスが自動的に入力されます。

プロジェクトに適用されているリーエンを一覧表示する

プロジェクトに適用されているすべての抵当権を一覧表示するには、alpha resource-manager liens list コマンドを使用します。

gcloud alpha resource-manager liens list

出力は次のようになります。

gcloud alpha resource-manager liens list
NAME                                                  ORIGIN            REASON
p1061081023732-l3d8032b3-ea2c-4683-ad48-5ca23ddd00e7  user@example.com  testing

リーエンをプロジェクトから削除する

リーエンをプロジェクトから削除するには、alpha resource-manager liens delete コマンドを使用します。

gcloud alpha resource-manager liens delete [LIEN_NAME]

[LIEN_NAME] は、削除するリーエンの名前に置き換えます(例: liens/p1061081023732-l3d8032b3-ea2c-4683-ad48-5ca23ddd00e7)。

リファレンス

API リファレンス: REST リソース: リーエン