ごみ箱の保持ポリシーを構成する

gcloud CLI

gcloud beta compute snapshot-recycle-bin-policy update コマンドを使用します。デフォルトの保持ポリシー ルールを設定するには --set-rule=default フラグを使用し、ルールの保持期間を指定するには --standard-snapshots-retention-duration-days フラグを使用します。

• 組織のデフォルトの保持ポリシーを設定するには、次のコマンドを使用します。

  gcloud beta compute snapshot-recycle-bin-policy update \
    --set-rule=default \
    --standard-snapshots-retention-duration-days=DEFAULT_RETENTION_PERIOD_DAYS \
    --organization=ORGANIZATION_ID
  

  以下を対応する値に置き換えます。

  • DEFAULT_RETENTION_PERIOD_DAYS: プロジェクトまたは組織の保持期間（日数）。0～7 の値を指定します。ごみ箱を無効にするには、0 を指定します。
  • ORGANIZATION_ID: 省略可。 デフォルトの保持ルールを設定する組織の ID。例: 123456789012。組織 ID またはプロジェクト ID のいずれかを指定する必要があります。両方を指定することはできません。

  プロジェクトのデフォルトの保持ポリシーを設定するには、上記のコマンドで --organization フラグを --project=<var>PROJECT_ID</var> に置き換えます。ここで、PROJECT_ID はプロジェクトの ID です。

• プロジェクトまたは組織のデフォルトの保持ルールを削除するには、同じコマンドを使用しますが、--set-rule=default ではなく --remove-rule=default を指定します。

  たとえば、組織のデフォルトの保持ポリシー ルールを削除するには:

  gcloud beta compute snapshot-recycle-bin-policy update \
    --organization=ORGANIZATION_ID \
    --remove-rule=default
  

  ORGANIZATION_ID は、組織の ID に置き換えます。

REST

snapshotRecycleBinPolicy メソッドに対して PATCH リクエストを作成します。

リクエストの本文に、デフォルトのゴミ箱の期間（日数）を指定する rules オブジェクトを含めます。

• プロジェクトの保持ポリシーを追加または変更するには:

  PATCH  https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/global/snapshotRecycleBinPolicy
  {
  "rules": {
    "default": {
      "standardSnapshots": {
        "retentionDurationDays": DEFAULT_RETENTION_PERIOD_DAYS
      }
    }
  }
  }
  

  以下を対応する値に置き換えます。

  • PROJECT_ID: プロジェクト ID（例: dev-project）。
  • DEFAULT_RETENTION_PERIOD_DAYS: デフォルトの保持期間（日数）。0～7 の値を指定します。ごみ箱を無効にするには、0 を指定します。

• 組織の保持ポリシーを追加または変更するには、前の例のように PATCH リクエストを行いますが、次の URL を使用します。

  PATCH https://compute.s3nsapis.fr/compute/beta/organizations/ORGANIZATION_ID/global/snapshotRecycleBinPolicy/
  
  
  

  リクエスト本文は、前の例と同じです。

  ORGANIZATION_ID は組織の ID に置き換えます。例: 123456789012。

• プロジェクトまたは組織のデフォルトの保持ルールを削除するには、同様の PATCH リクエストを行いますが、default ルールに null を指定します。

  たとえば、組織のデフォルトの保持ルールを削除するには:

  PATCH https://compute.s3nsapis.fr/compute/beta/organizations/ORGANIZATION_ID/global/snapshotRecycleBinPolicy/
  {
  "rules": {
     "default": null
   }
  }
  

  ORGANIZATION_ID は、組織の ID に置き換えます。

gcloud CLI

タグの保持ポリシー ルールを設定するには、gcloud beta compute snapshot-recycle-bin-policy update コマンドを使用します。--set-rule フラグを使用してタグの名前を指定し、--standard-snapshots-retention-duration-days フラグを使用してタグのゴミ箱の保持期間（日数）を指定します。

gcloud beta compute snapshot-recycle-bin-policy update \
  --set-rule=TAG_NAMESPACED_NAME \
  --standard-snapshots-retention-duration-days=RETENTION_PERIOD_DAYS \
  --organization=ORGANIZATION_ID

以下を対応する値に置き換えます。

• TAG_NAMESPACED_NAME: 値を含むタグの名前空間付きの名前。たとえば、my-project-id/tag-key/tag-value や my-organization-id/tag-key/tag-value です。
• RETENTION_PERIOD_DAYS: 保持期間（日数）。0～7 の範囲で指定します。このタグのスナップショットのごみ箱を無効にするには、0 を指定します。
• ORGANIZATION_ID: 省略可。 ルールが適用される組織の ID。例: 123456789012。組織 ID またはプロジェクト ID のいずれかを指定する必要があります。両方を指定することはできません。

プロジェクトのデフォルトの保持ポリシーを設定するには、上記のコマンドで --organization フラグを --project=<var>PROJECT_ID</var> に置き換えます。ここで、PROJECT_ID はプロジェクトの ID です。

タグの保持ポリシー ルールを削除するには、同じコマンドを使用しますが、--set-rule ではなく --remove-rule=TAG_NAMESPACED_NAME を指定します。たとえば、組織のタグベースのルールを削除するには:

gcloud beta compute snapshot-recycle-bin-policy update \
  --organization=ORGANIZATION_ID \
  --remove-rule=TAG_NAMESPACED_NAME

REST

タグの保持ポリシー ルールを設定するには、snapshotRecycleBinPolicy メソッドに PATCH リクエストを送信します。リクエストの本文に、タグの名前と保持期間（日数）を指定する rules オブジェクトを含めます。

• プロジェクト内のタグの保持ポリシー ルールを設定または更新するには:

PATCH https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/global/snapshotRecycleBinPolicy/
{
  "rules": {
    "TAG_NAMESPACED_NAME_1": {
      "standardSnapshots": { 
        "retentionDurationDays": RETENTION_PERIOD_DAYS
      }
    }
  }
}

以下を対応する値に置き換えます。

• PROJECT_ID: プロジェクトの ID。
• TAG_NAMESPACED_NAME: 値を含むタグの名前空間付きの名前。たとえば、my-project-id/env/prod や my-organization-id/env/build です。

• RETENTION_PERIOD_DAYS: 保持期間（日数）。0～7 の範囲で指定します。このタグが付いたスナップショットのごみ箱を無効にするには、0 を指定します。

• 組織内のタグの保持ポリシー ルールを設定または更新するには、前の例のように PATCH リクエストを送信しますが、次の URL を使用します。

PATCH https://compute.s3nsapis.fr/compute/beta/organizations/ORGANIZATION_ID/global/snapshotRecycleBinPolicy/

ORGANIZATION_ID は、組織の ID に置き換えます。リクエストの本文は、前の例で説明したとおりです。

• タグの保持ポリシー ルールを削除するには、前の例のように PATCH リクエストを作成しますが、タグベースのルールには null を指定します。たとえば、プロジェクト内のタグベースのルールの保持ポリシー ルールを削除するには:

PATCH https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/global/snapshotRecycleBinPolicy
{
  "rules": {
    "TAG_NAMESPACED_NAME_1": null
  }
}

gcloud CLI

タグベースのルールなど、プロジェクトまたは組織のごみ箱の保持ポリシーを表示するには、gcloud beta compute snapshot-recycle-bin-policy describe コマンドを使用します。

• 組織のごみ箱の保持ポリシーを表示するには:

  gcloud beta compute snapshot-recycle-bin-policy describe \
    --organization=ORGANIZATION_ID
  

  ORGANIZATION_ID は、組織の ID に置き換えます。

• プロジェクトのごみ箱の保持ポリシーを表示するには:

  gcloud beta compute snapshot-recycle-bin-policy describe \
  --project=PROJECT_ID
  

  PROJECT_ID をそのプロジェクトの ID に置き換えます。

出力は、次のようなルール オブジェクトのリストです。3 日間のシステム デフォルト ルールが出力に含まれます。

  rules:
    default:
      standardSnapshots:
        retentionDurationDays: '2'
    database-project/Testing-tag-key/build:
      standardSnapshots:
        retentionDurationDays: '0'
    database-project/Testing-tag-key/critical:
      standardSnapshots:
        retentionDurationDays: '5'
    systemRules:
      default:
        standardSnapshots:
          retentionDurationDays: '3'

各ルールの retentionDurationDays フィールドには、ルールの保持期間が日数で示されます。この例では、プロジェクト database-project に 3 つのルールがあります。

• タグ Testing-tag-key/critical が付いているすべてのスナップショットの 5 日間のルール。
• タグ Testing-tag-key/build が付いているすべてのスナップショットを直ちに削除します。
• プロジェクト内の他のすべてのスナップショットのデフォルトの保持期間は 2 日間です。

REST

タグベースのルールを含む、プロジェクトまたは組織のすべての保持ポリシー ルールを表示するには、snapshotRecycleBinPolicy.get メソッドに対する GET リクエストを作成します。

• 組織の保持ポリシーを表示するには:

  GET https://compute.s3nsapis.fr/compute/beta/organizations/ORGANIZATION_ID/global/snapshotRecycleBinPolicy
  

  ORGANIZATION_ID は、組織の ID に置き換えます。

• プロジェクトの保持ポリシーを表示するには:

  GET https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/global/snapshotRecycleBinPolicy
  

  PROJECT_ID は、プロジェクトの ID に置き換えます。

レスポンスは次の例のようになります。3 日間のシステムのデフォルト ルールが出力に含まれます。

  {
    "rules": {
     "default": {
      "standardSnapshots": {
        "retentionDurationDays": "2"
      }
    },
    "database-project/Testing-tag-key/build": {
      "standardSnapshots": {
        "retentionDurationDays": "0"
      }
    },
    "database-project/Testing-tag-key/critical": {
      "standardSnapshots": {
        "retentionDurationDays": "5"
      }
    },
     "systemRules": {
      "default": {
       "standardSnapshots": {
         "retentionDurationDays": "3"
      }
     }
    }
  }
 }

各ルールの retentionDurationDays フィールドには、ルールの保持期間が日数で示されます。この例では、プロジェクト database-project に 3 つのルールがあります。

• タグ Testing-tag-key/critical が付いているすべてのスナップショットの 5 日間のルール。
• タグ Testing-tag-key/build が付いているすべてのスナップショットを直ちに削除します。
• プロジェクト内の他のすべてのスナップショットのデフォルトの保持期間は 2 日間です。

Cloud de Confiance コンソール

1. Cloud de Confiance コンソールで、[スナップショット] ページに移動します。

[スナップショット] ページに移動

1. [スナップショット] タブに、プロジェクト内のスナップショットの一覧が表示されます。

2. [名前] 列で、標準スナップショットの名前をクリックします。選択したスナップショットの [スナップショットの詳細] ページが表示されます。

3. [ゴミ箱の保持期間] プロパティには、スナップショットのゴミ箱の保持期間のスナップショットが表示されます。

gcloud CLI

特定のスナップショットの保持期間を表示するには、gcloud beta compute snapshots get-effective-recycle-bin-rule コマンドを使用します。

gcloud beta compute snapshots get-effective-recycle-bin-rule \
  SNAPSHOT_NAME \
  --project=PROJECT_ID

以下を対応する値に置き換えます。

• PROJECT_ID: スナップショットを含むプロジェクトの ID。
• SNAPSHOT_NAME: スナップショットの名前。

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

retentionDurationDays: '5'

retentionDurationDays フィールドは、スナップショットのごみ箱の保持期間（日数）を示します。

REST

特定のスナップショットの保持期間を表示するには、getEffectiveRecycleBinRule メソッドに対する GET リクエストを作成します。

GET https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/global/snapshots/SNAPSHOT_NAME/getEffectiveRecycleBinRule

以下を対応する値に置き換えます。

• PROJECT_ID: スナップショットを含むプロジェクトの ID。
• SNAPSHOT_NAME: スナップショットの名前。

レスポンスは次の例のようになります。

{
  "retentionDurationDays": "5"
}

retentionDurationDays フィールドは、スナップショットのごみ箱の保持期間（日数）を示します。