設定回收桶保留政策

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。

• 如要移除專案或機構的預設保留規則，請使用相同指令，但指定 --remove-rule=default，而非 --set-rule=default。

  舉例來說，如要移除機構的預設保留政策規則，請執行下列操作：

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

  將 ORGANIZATION_ID 替換為組織 ID。

REST

建構 PATCH 要求，以呼叫 snapshotRecycleBinPolicy 方法。

在要求主體中，加入 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 要求 (如上例所示)，但使用下列網址：

  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。

如要移除標記的資料保留政策規則，請使用相同指令，但指定 --remove-rule=TAG_NAMESPACED_NAME 而非 --set-rule。舉例來說，如要移除機構的標記規則，請執行下列指令：

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 要求，但使用下列網址。

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。

輸出內容是規則物件清單，類似於下列內容。輸出內容會包含三天的系統預設規則。

  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 有三項規則：

• 所有含有 Testing-tag-key/critical 標記的快照都適用五天規則。
• 立即刪除所有含有 Testing-tag-key/build 標記的快照。
• 專案中所有其他快照的預設保留期限為兩天。

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。

回覆內容大致如下。輸出內容會包含系統預設的三天規則。

  {
    "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 有三項規則：

• 所有含有 Testing-tag-key/critical 標記的快照都適用五天規則。
• 立即刪除所有含有 Testing-tag-key/build 標記的快照。
• 專案中所有其他快照的預設保留期限為兩天。

Cloud de Confiance 控制台

1. 前往 Cloud de Confiance 控制台的「Snapshots」(快照) 頁面。

前往「快照」頁面

1. 在「快照」分頁中，查看專案中的快照清單。

2. 在「Name」(名稱) 欄中，按一下標準快照的名稱。系統會顯示所選快照的「快照詳細資料」頁面。

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 欄位會指出快照回收桶的保留期限 (以天為單位)。