XML 要求所需的 IAM 權限

下表列出在指定資源上執行每個 Cloud Storage XML 方法所需的 Identity and Access Management (IAM) 權限。

注意： 您無法使用 XML API 管理 IAM 政策。如要瞭解可用的管理選項，請參閱使用 IAM 權限一文。

方法	資源	子資源	必要的 IAM 權限^1
DELETE	bucket		storage.buckets.delete
DELETE	object		storage.objects.delete
DELETE	object	uploadId	storage.multipartUploads.abort
GET			storage.buckets.list
GET	bucket		storage.objects.list
GET	bucket	acls^3	storage.buckets.get storage.buckets.getIamPolicy
GET	bucket	非 ACL 中繼資料	storage.buckets.get
GET	bucket	uploads	storage.multipartUploads.list
GET	object		storage.objects.get
GET	object	acls^3	storage.objects.get storage.objects.getIamPolicy
GET	object	encryption	storage.objects.get
GET	object	retention	storage.objects.get
GET	object	uploadId	storage.multipartUploads.listParts
HEAD	bucket		storage.buckets.get
HEAD	object		storage.objects.get
POST	object		storage.objects.create storage.objects.delete^4 storage.objects.setRetention^5
POST	object	uploadId	storage.multipartUploads.create storage.objects.create storage.objects.delete^4
POST	object	uploads	storage.multipartUploads.create storage.objects.create storage.objects.setRetention^5
PUT	bucket		storage.buckets.create storage.buckets.enableObjectRetention^6
PUT	bucket	acls^3	storage.buckets.get storage.buckets.getIamPolicy storage.buckets.setIamPolicy storage.buckets.update
PUT	bucket	非 ACL 中繼資料	storage.buckets.update
PUT^7	object		storage.objects.create storage.objects.get^2 storage.objects.delete^4 storage.objects.setRetention^5
PUT	object	acls^3	storage.objects.get storage.objects.getIamPolicy storage.objects.setIamPolicy storage.objects.update
PUT	object	compose	storage.objects.create storage.objects.get storage.objects.delete^4 storage.objects.setRetention^5
PUT	object	retention	storage.objects.setRetention storage.objects.update storage.objects.overrideUnlockedRetention^8
PUT	object	uploadId	storage.multipartUploads.create storage.objects.create
GET	Projects.hmacKeys		storage.hmacKeys.get
POST	Projects.hmacKeys		storage.hmacKeys.create storage.hmacKeys.update storage.hmacKeys.delete

¹ 如果您在要求中使用 x-goog-user-project 標頭或 userProject 查詢字串參數，則除了提出要求所需的一般 IAM 權限之外，還必須具有您所指定專案 ID 的 serviceusage.services.use 權限。

² 如果要求包含 x-goog-copy-source 標頭，來源 bucket 就需要這項權限。

³ 這個子資源不適用於已啟用統一值區層級存取權的值區。

⁴ 只有在插入物件名稱與值區中現有物件名稱相同時，才需要這項權限。

⁵ 只有在要求包含 x-goog-object-lock-mode 和 x-goog-object-lock-retain-until-date 標頭時，才需要這項權限。

⁶ 只有在要求包含設為 true 的 x-goog-bucket-object-lock-enabled 標頭時，才需要這項權限。

⁷ 如要發出與可續傳上傳相關聯的 PUT 要求，不需要任何權限。

⁸只有在要求包含設為 true 的 x-goog-bypass-governance-retention 標頭時，才需要這項權限。

後續步驟

• 如需查看角色及其相關權限的清單，請參閱適用於 Cloud Storage 的 IAM 角色一文。