撰寫物件

總覽

本頁說明如何將多個 Cloud Storage 物件組合成單一物件。組合要求會採用 1 到 32 個物件,並建立新的複合物件。複合物件是來源物件的串連,順序與要求中指定的順序相同。

除非您決定在組合處理期間刪除來源物件,否則來源物件不會受到影響。

臨時物件的費用注意事項

如果來源物件是暫時性的,請在組合物件時注意下列費用考量:

  • 儲存空間級別而定,來源物件須符合最短儲存時間規定,否則可能會產生提前刪除費用

  • 如果啟用虛刪除物件版本管理功能,在組合完成後刪除來源物件,可能會導致來源物件遭到虛刪除或成為非目前版本,進而產生額外的儲存空間費用。

  • 如要盡量減少臨時物件的費用,請在組合程序中使用 deleteSourceObjects 選項,硬性刪除臨時物件。使用這個選項刪除的物件不會產生提前刪除費用。此外,使用這個選項刪除的物件不會透過虛刪除或物件版本管理功能保留,因為資料會保留在複合物件中。

必要的角色

如要取得組合物件所需的權限,請要求管理員授予您 bucket 的「Storage 物件使用者」(roles/storage.objectUser) IAM 角色。這個預先定義的角色具備撰寫物件所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

  • storage.objects.create
  • storage.objects.delete
    • 只有在您想將組合的物件命名為與值區中現有物件相同的名稱時,才需要這項權限。
  • storage.objects.get
  • storage.objects.list
    • 如果您想使用萬用字元組成具有相同前置字元的物件,而不必在 Google Cloud CLI 指令中個別列出每個物件,則需要此權限。

如要為撰寫的物件設定保留設定,您也需要 storage.objects.setRetention 權限。如要取得這項權限,請要求管理員授予您「Storage 物件管理員」(roles/storage.objectAdmin) 角色,而非「Storage 物件使用者」(roles/storage.objectUser) 角色。

您也可以透過其他預先定義的角色或自訂角色取得這些權限。

如要瞭解如何授予值區角色,請參閱「設定及管理值區的 IAM 政策」。

建立複合物件

指令列