このドキュメントは、プロジェクトの削除に対する保護を追加しようと考えているプロジェクト オーナーと組織管理者を対象としています。
プロジェクトにリーエンを適用すると、リーエンを削除するまでプロジェクトを削除できなくなります。これは、重要なプロジェクトを保護する場合に役立ちます。
また、リーエンは、プロジェクトに自動的に配置することもできます。たとえば、あるプロジェクトの 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 は、削除するリーエンの名前に置き換えます（例: p1061081023732-l3d8032b3-ea2c-4683-ad48-5ca23ddd00e7）。
リファレンス
API リファレンス: REST リソース: リーエン