本文說明如何管理區域性和可用區 Persistent Disk 和 Google Cloud Hyperdisk 磁碟的快照排程。
您可以透過下列方式管理快照排程:
- 查看快照排程
- 變更快照排程
- 刪除快照排程
您也可以設定快照排程的快訊。
事前準備
-
如果尚未設定,請先設定驗證機制。「驗證」是指驗證身分,以便存取 Trusted Cloud by S3NS 服務和 API 的程序。如要從本機開發環境執行程式碼或範例,請選取下列任一選項,以便對 Compute Engine 進行驗證:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, sign in to the gcloud CLI with your federated identity and then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
Install the Google Cloud CLI.
-
Configure the gcloud CLI to use your federated identity.
For more information, see Sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Install the Google Cloud CLI.
-
Configure the gcloud CLI to use your federated identity.
For more information, see Sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Install the Google Cloud CLI.
-
Configure the gcloud CLI to use your federated identity.
For more information, see Sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Install the Google Cloud CLI.
-
Configure the gcloud CLI to use your federated identity.
For more information, see Sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Compute 執行個體管理員 (v1) (
roles/compute.instanceAdmin.v1
) -
如要連線至可以服務帳戶形式執行的 VM,請按照下列步驟操作:
服務帳戶使用者 (v1) (
roles/iam.serviceAccountUser
) -
如要查看快照排程,請按照下列步驟操作:
compute.resourcePolicies.list
在專案或機構中 -
如要更新快照排程,請按照下列步驟操作:
-
資源政策的
compute.resourcePolicies.update
-
資源政策的
compute.resourcePolicies.get
-
資源政策的
-
如要取代快照排程,請按照下列步驟操作:
-
資源政策的
compute.resourcePolicies.use
-
磁碟的
compute.disks.addResourcePolicies
權限 -
磁碟的
compute.disks.removeResourcePolicies
權限
-
資源政策的
-
如要刪除快照排程,請按照下列步驟操作:
-
資源政策的
compute.resourcePolicies.delete
-
磁碟的
compute.disks.removeResourcePolicies
權限
-
資源政策的
- 前往 Trusted Cloud 控制台的「Snapshots」(快照) 頁面。
- 選取「快照排程」分頁標籤。
- 使用 「Filter」 欄位,縮小快照排程清單的範圍。
- 按一下快照排程的名稱,即可查看詳細資料。
- 前往 Trusted Cloud 控制台的「Snapshots」(快照) 頁面。
- 選取「快照排程」分頁標籤。
- 使用 「Filter」 欄位,列出特定地區的快照排程。
PROJECT_ID
:專案名稱REGION
:區域,例如us-west1
PROJECT_ID
:專案名稱REGION
:區域,例如us-west1
- 說明
- 快照排程
- 套用至產生快照的標籤
- 來源磁碟刪除政策,在來源磁碟遭到刪除時用來處理自動產生的快照
- 保留政策,可定義快照排程所產生的快照應保留多久
- 前往 Trusted Cloud 控制台的「Snapshots」(快照) 頁面。
- 選取 [Snapshot schedules] (快照排程) 以查看排程的清單。
- 按一下要修改的快照排程名稱。
- 在快照排程詳細資料頁面上,按一下 「編輯排程」按鈕。
- SCHEDULE_NAME:快照排程的名稱。
- REGION:快照排程所在的地區。
- DESCRIPTION:快照排程的說明。請在說明內容的前後加上引號。
- KEY 和 VALUE:鍵/值組合,可用於將相關或關聯的資源分門別類。
- DAYS:快照保留的天數上限。
- DELETE_OPTION:刪除原始磁碟後,自動快照的保留行為。值必須是下列其中一個:
apply-retention-policy
:當來源磁碟遭到刪除時,系統會繼續為快照排程建立的所有快照套用保留期間。keep-auto-snapshots
:(預設) 如果來源磁碟遭到刪除,系統會保留快照排程建立的所有快照,無論保留期間為何。
- START_TIME:世界標準時間的開始時間。時間必須從每個小時的整點開始,例如:
- 太平洋標準時間下午 2:00 是
22:00
。 - 如果您將開始時間設為
22:13
,則會收到錯誤訊息。
- 太平洋標準時間下午 2:00 是
SCHEDULE_FLAG:下列任一標記:
--hourly-schedule=
HOURLY_INTERVAL
:每個快照之間的時間長度 (以小時為單位)。HOURLY_INTERVAL
必須是介於1
至23
之間的整數。例如,將--hourly-schedule
設為 12,即代表系統每 12 個小時會產生一次快照。--daily-schedule
:每天在START_TIME
執行快照--weekly-schedule=
WEEKLY_INTERVAL
:定義要執行快照作業的日子。您必須填入星期幾,但不必區分大小寫。--weekly-schedule-from-file=
FILE_NAME
:指定包含每週快照排程的檔案。您可以透過檔案來指定每週排程在不同的日子和時間執行。舉例來說,您的檔案可能會指定在星期一和星期三建立快照的排程:none [{"day": "MONDAY", "startTime": "04:00"}, {"day": "WEDNESDAY", "startTime": "02:00"}]
。如果檔案中包含開始時間,則不需要設定--start-time
旗標。時間表會使用世界標準時間時區。時間必須從每個小時的整點開始,例如:- 太平洋標準時間下午 2:00 是
22:00
。 - 如果您將開始時間設為
22:13
,則會收到錯誤訊息。
- 太平洋標準時間下午 2:00 是
快照頻率標記
hourly-schedule
、daily-schedule
、weekly-schedule
和weekly-schedule-from-file
是相互排斥的,您只能為快照排程使用其中一種設定。變更說明和標籤:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME { "name": "SCHEDULE_NAME", "description": "DESCRIPTION", "snapshotProperties": { "labels": {"KEY": "VALUE"} } }
將快照排程變更為每小時:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME { "name": "SCHEDULE_NAME", "snapshotSchedulePolicy": { "schedule": { "hourlySchedule": { "hoursInCycle": HOURLY_INTERVAL, "startTime": START_TIME } } } }
將快照排程變更為每日:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME { "name": "SCHEDULE_NAME", "snapshotSchedulePolicy": { "schedule": { "dailySchedule": { "daysInCycle": DAILY_INTERVAL, "startTime": START_TIME } } } }
將快照排程改為每週:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME { "name": "SCHEDULE_NAME", "snapshotSchedulePolicy": { "schedule": { "weeklySchedule": { "dayOfWeeks": [ { "day": WEEKLY_INTERVAL, "startTime": START_TIME } ] } } } }
變更快照保留政策:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME { "name": "SCHEDULE_NAME", "snapshotSchedulePolicy": { "retentionPolicy": { "maxRetentionDays": DAYS, "onSourceDiskDelete":"DELETE_OPTION" } } }
- PROJECT_ID:專案名稱。
- REGION:快照排程所在的區域。
- SCHEDULE_NAME:快照排程的名稱。
- DESCRIPTION:快照排程的說明。請在說明內容的前後加上引號。
- KEY 和 VALUE:鍵/值組合,可用來將相關或關聯的資源分組。
- HOURLY_INTERVAL:定義建立快照的時間間隔。請使用介於
1
和23
的整數設定每小時排程,如要每天在同一時間建立快照,請選擇可整除 24 的數字 (1、2、3、4、6、8 或 12)。例如,將--hourly-schedule
設為 12,即代表系統每 12 個小時會產生一次快照。 - DAILY_INTERVAL:定義每個快照之間的天數。如要每天建立快照,請使用
1
值。 - WEEKLY_INTERVAL:定義在星期幾執行的排程。指定一或多天。可用的選項如下:
MONDAY
、TUESDAY
、WEDNESDAY
、THURSDAY
、FRIDAY
、SATURDAY
和SUNDAY
。您必須填入星期幾,但不必區分大小寫。您最多可以為dayOfWeeks
定義 7 個間隔,每週一天一個。 - START_TIME:世界標準時間的開始時間。時間必須從每個小時的整點開始,例如:
- 太平洋標準時間下午 2 點是世界標準時間
22:00
。 - 如果您將開始時間設為
22:13
,則會收到錯誤訊息。
- 太平洋標準時間下午 2 點是世界標準時間
- DAYS:快照保留的天數上限。
- DELETE_OPTION:刪除原始磁碟後,自動快照的保留行為。值必須是下列其中一個:
APPLY_RETENTION_POLICY
:當來源磁碟遭到刪除時,系統會繼續為快照排程建立的所有快照套用保留期間。KEEP_AUTO_SNAPSHOTS
:(預設) 如果來源磁碟遭到刪除,系統會保留快照排程建立的所有快照,無論保留期間為何。
- 在 Trusted Cloud 控制台中,前往「Disks」頁面。
- 選擇含有待卸離排程的磁碟。
- 在「管理磁碟」頁面中,按一下「編輯」圖示 。您可能需要先按一下「更多動作」 選單。
- 開啟「Snapshot schedule」(快照排程) 下拉式選單。
- 按一下 [No schedule] (沒有任何排程),將排程從磁碟卸離。
- 編輯磁碟選項時,您可以建立新的排程或替換排程。
- 按一下 [Save] (儲存) 來完成工作。
使用
gcloud disks remove-resource-policies
指令,將要變更的快照排程從磁碟上卸離。gcloud compute disks remove-resource-policies DISK_NAME \ --resource-policies SCHEDULE_NAME \ --region REGION \ --zone ZONE
更改下列內容:
DISK_NAME
:附加快照排程的磁碟名稱SCHEDULE_NAME
:要從這個磁碟卸離的快照排程名稱REGION
:快照排程所在的區域ZONE
:區域磁碟所在的區域
使用
gcloud disks add-resource-policies
指令將新的快照排程新增至磁碟。gcloud compute disks add-resource-policies DISK_NAME \ --resource-policies SCHEDULE_NAME \ --zone ZONE
更改下列內容:
DISK_NAME
:具有快照排程資源政策的磁碟名稱SCHEDULE_NAME
:要新增至該磁碟的快照排程名稱ZONE
:磁碟所在的可用區
建構目標為
disks.removeResourcePolicies
的POST
要求,從磁碟卸離目前的快照排程。POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME/removeResourcePolicies { "resourcePolicies": [ "regions/REGION/resourcePolicies/SCHEDULE_NAME" ] }
更改下列內容:
PROJECT_ID
:專案名稱ZONE
:磁碟所在的區域DISK_NAME
:具有相關快照排程的磁碟名稱REGION
:快照排程的位置SCHEDULE_NAME
:要從磁碟移除的快照排程名稱
建構
disks.addResourcePolicies
方法的POST
要求,將新的快照排程附加至磁碟。POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME/addResourcePolicies { "resourcePolicies": [ "regions/REGION/resourcePolicies/SCHEDULE_NAME" ] }
更改下列內容:
PROJECT_ID
:專案名稱ZONE
:磁碟的位置DISK_NAME
:磁碟名稱REGION
:快照排程的位置SCHEDULE_NAME
:要套用至這個磁碟的快照排程名稱
- 前往 Trusted Cloud 控制台的「Snapshots」(快照) 頁面。
- 選取 [Snapshot schedules] (快照排程) 以查看排程的清單。
- 選取沒有與磁碟建立關聯的排程。
按一下
「刪除」。SCHEDULE_NAME
:快照排程的名稱REGION
:快照排程的位置PROJECT_ID
:專案名稱REGION
:快照排程的位置SCHEDULE_NAME
:快照排程的名稱前往 Trusted Cloud 控制台的「Logs Explorer」頁面。
在「All resource」下拉式清單中,將滑鼠游標移至「Disk」,然後選取「All disk_id」。
在「All logs」下拉式清單中,選取「cloudaudit.googleapis.com/system_event」,然後按一下「OK」。
在「Any log level」(任何記錄層級) 下拉式清單中,選取記錄類型。
Go
如要在本機開發環境中使用本頁面上的 Go 範例,請先安裝並初始化 gcloud CLI,然後使用您的使用者憑證設定應用程式預設憑證。
詳情請參閱 Set up authentication for a local development environment。
Java
如要在本機開發環境中使用本頁面上的 Java 範例,請先安裝並初始化 gcloud CLI,然後使用您的使用者憑證設定應用程式預設憑證。
詳情請參閱 Set up authentication for a local development environment。
Node.js
如要在本機開發環境中使用本頁面上的 Node.js 範例,請先安裝並初始化 gcloud CLI,然後使用您的使用者憑證設定應用程式預設憑證。
詳情請參閱 Set up authentication for a local development environment。
Python
如要在本機開發環境中使用本頁面上的 Python 範例,請先安裝並初始化 gcloud CLI,然後使用您的使用者憑證設定應用程式預設憑證。
詳情請參閱 Set up authentication for a local development environment。
REST
如要在本機開發環境中使用本頁的 REST API 範例,請使用您提供給 gcloud CLI 的憑證。
After installing the Google Cloud CLI, sign in to the gcloud CLI with your federated identity and then initialize it by running the following command:
gcloud init
詳情請參閱 Trusted Cloud 驗證說明文件中的「驗證以使用 REST」。
必要角色和權限
如要取得建立快照排程所需的權限,請要求管理員授予您專案的下列 IAM 角色:
如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。
這些預先定義的角色包含建立快照排程所需的權限。如要查看確切的必要權限,請展開「必要權限」部分:
所需權限
如要建立快照排程,必須具備下列權限:
查看快照排程
如要取得快照排程的清單,可以使用主控台、
gcloud
指令或 Compute Engine API 方法進行操作。這項要求會顯示專案內所有快照排程的名稱、說明和地區。主控台
gcloud
如要查看快照排程清單,請使用
resource-policies list
指令。gcloud compute resource-policies list
如要查看特定快照排程的說明,請使用
resource-policies describe
指令。gcloud compute resource-policies describe SCHEDULE_NAME
將
SCHEDULE_NAME
替換為快照排程的名稱。Go
列出快照排程
說明快照排程
Java
列出快照排程
說明快照排程
Node.js
Python
列出快照排程
說明快照排程
REST
向
resourcePolicies.aggregatedList
發出GET
要求,即可傳回專案的快照排程清單。GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/resourcePolicies
將
PROJECT_ID
替換為專案名稱。依地區查看快照排程
如要查看特定地區內專案的快照排程,請使用Trusted Cloud 主控台、gcloud CLI 或 REST。
主控台
gcloud
如要查看特定地區內專案的快照排程,請使用
resource-policies list
指令。gcloud compute resource-policies list PROJECT_ID --filter REGION
更改下列內容:
REST
向
resourcePolicies.list
方法發出GET
要求,即可擷取在某地區中建立的快照排程。GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies
更改下列內容:
變更快照排程
建立快照排程後,您可以使用更新快照排程程序,動態修改下列欄位:
如要更新快照排程的其他值,請按照「取代快照排程」一節所述,刪除快照排程並建立新的排程。
快照排程更新會在更新後的第一個快照生效。如果在更新快照排程時,快照正在執行,則變更會在下一個快照中生效。
更新快照排程
您可以使用 Google Cloud CLI 或 Compute Engine API 變更快照排程的部分屬性,如變更快照排程所述。
如要變更快照排程的其他屬性,請使用「取代快照排程」一文所述的方法。
主控台
gcloud
使用
compute resource-policies update
指令更新快照排程的說明、排程、保留政策或標籤。gcloud compute resource-policies update snapshot-schedule SCHEDULE_NAME \ --region=REGION \ --description="DESCRIPTION" \ --snapshot-labels="KEY=VALUE" \ --max-retention-days=DAYS \ --on-source-disk-delete=DELETE_OPTION \ --start-time=START_TIME \ SCHEDULE_FLAG
更改下列內容:
範例:
如要將快照排程變更為每日排程,請按照下列步驟操作:
gcloud compute resource-policies update snapshot-schedule SCHEDULE_NAME \ --region=REGION --daily-schedule --start-time=START_TIME
如要將快照變更為每小時排程,並更新說明和快照標籤,請按照下列步驟操作:
gcloud compute resource-policies update snapshot-schedule SCHEDULE_NAME \ --region=REGION --description="DESCRIPTION" \ --hourly-schedule=HOURLY_INTERVAL --start-time=START_TIME \ --snapshot-labels="KEY=VALUE"
如要變更快照排程的快照保留和來源磁碟刪除政策,請按照下列步驟操作:
gcloud compute resource-policies update snapshot-schedule SCHEDULE_NAME \ --region=REGION --max-retention-days=DAYS \ --on-source-disk-delete=DELETE_OPTION
Go
Java
Node.js
Python
REST
建構
resourcePolicies
方法的PATCH
要求,以更新快照排程的說明、排程、保留政策、來源磁碟刪除政策或標籤。在要求主體中,您只需指定name
和要更新的欄位即可。更改下列內容:
取代快照排程
請按照下列步驟刪除快照排程,然後建立新的快照排程。使用這個方法修改無法透過更新快照排程程序變更的快照排程屬性。
如果您要取代已附加至磁碟的快照排程,則必須先將排程從磁碟卸離並刪除該排程,然後建立新的排程,並將新排程附加到磁碟。
從卸離的快照排程產生的快照不會由新政策管理。系統會無限期保留這些快照,直到您刪除為止。
使用 Trusted Cloud 控制台、gcloud CLI 或 REST 移除及取代快照排程。
主控台
gcloud
REST
刪除快照排程
如果您刪除了快照排程,系統會永久保留所有與快照排程相關的自動產生快照。然而,排程在刪除後便無法再產生快照。
您的保留政策屬於快照排程的一部分。因此排程遭到刪除後,保留政策也就不再適用。系統會永久保留已經產生的快照,如要刪除,您必須手動執行。
如要刪除現有的快照排程,可以使用Trusted Cloud 主控台、Google Cloud CLI 或 Compute Engine API 方法。如果排程已附加至磁碟,請先從磁碟卸離排程,再刪除該排程。您無法刪除已附加至磁碟的快照排程。
主控台
gcloud
如要刪除快照排程,請使用
resource-policies delete
指令。gcloud compute resource-policies delete SCHEDULE_NAME \ --region REGION
更改下列內容:
Go
Java
Node.js
Python
REST
如要刪除快照排程,請對
resourcePolicies.delete
方法發出DELETE
要求。如果快照排程已附加至磁碟,您會收到錯誤訊息。DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME
更改下列內容:
記錄和監控
每個與磁碟相關聯的排程快照都會持續建立隨時受系統監控及記錄的系統事件。系統事件稽核記錄功能永遠處於啟用狀態。
這些記錄會針對每個相關聯磁碟提供排程快照的行為資訊。您可以在 Trusted Cloud 控制台的「Logging」選單中查看記錄。
如要進一步瞭解如何使用記錄檔探索工具,請參閱「使用記錄檔探索工具查看記錄檔」。
主控台
後續步驟
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-06-23 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-06-23 (世界標準時間)。"],[[["This document details the management of snapshot schedules for zonal and regional Persistent Disks and Google Cloud Hyperdisks."],["Users can perform actions such as viewing, changing, and deleting snapshot schedules, as well as configure alerts for them."],["Before managing snapshot schedules, users need to set up authentication, which can be done via the Google Cloud console, gcloud CLI, or through various language-specific environments like Go, Java, Node.js, Python, or REST."],["Snapshot schedules can be updated to modify their description, schedule, retention policy, labels, or source disk deletion policy, and more extensive changes may require replacing the existing schedule."],["Deleting a snapshot schedule will keep the snapshots created up until that point, but will no longer generate new ones, and will stop the retention policy."]]],[]] -