本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Amazon S3 API 操作的必要許可
注意
此頁面是關於一般用途儲存貯體的 Amazon S3 政策動作。若要進一步了解目錄儲存貯體的 Amazon S3 政策動作,請參閱 目錄儲存貯體的動作。
若要執行 S3 API 操作,您必須具有適當的許可。此頁面會將 S3 API 操作對應至所需的許可。若要授予執行 S3 API 操作的許可,您必須撰寫有效的政策 (例如 S3 儲存貯體政策或 IAM 身分型政策),並在政策的 Action
元素中指定對應的動作。這些動作稱為政策動作。並非每個 S3 API 操作都由單一許可 (單一政策動作) 表示,而且許多不同的 API 操作都需要一些許可 (某些政策動作)。
當您編寫政策時,您必須根據對應 Amazon S3 政策動作所需的正確資源類型指定 Resource
元素。此頁面會依資源類型分類 S3 API 操作的許可。如需 資源類型的詳細資訊,請參閱服務授權參考中的 Amazon S3 定義的資源類型。如需政策中使用的 Amazon S3 政策動作、資源和條件索引鍵的完整清單,請參閱服務授權參考中的 Amazon S3 的動作、資源和條件索引鍵。如需 Amazon S3 API 操作的完整清單,請參閱 Amazon Simple Storage Service API 參考中的 Amazon S3 Word 動作。 API
主題
儲存貯體操作和許可
儲存貯體操作是在儲存貯體資源類型上執行的 S3 API 操作。您必須為儲存貯體政策或 IAM 身分型政策中的儲存貯體操作指定 S3 政策動作。
在政策中,Resource
元素必須是 Amazon Resource Name (ARN) 儲存貯體。如需Resource
元素格式和範例政策的詳細資訊,請參閱 儲存貯體操作。
注意
若要在存取點政策中授予儲存貯體操作的許可,請注意下列事項:
-
只有在基礎儲存貯體允許相同的許可時,存取點政策中為儲存貯體操作授予的許可才有效。使用存取點時,您必須將存取控制從儲存貯體委派給存取點,或在存取點政策中將相同的許可新增至基礎儲存貯體的政策。
-
在授予儲存貯體操作許可的存取點政策中,
Resource
元素必須是accesspoint
ARN。如需Resource
元素格式和範例政策的詳細資訊,請參閱 存取點政策中的儲存貯體操作。如需存取點政策的詳細資訊,請參閱 設定 IAM 政策以使用存取點。 存取點不支援所有儲存貯體操作。如需詳細資訊,請參閱存取點與 S3 操作的相容性。
以下是儲存貯體操作和必要政策動作的映射。
API 操作 | 政策動作 | 政策動作的說明 |
---|---|---|
(必要) |
建立新 s3 儲存貯體所需的 。 |
|
(有條件必要) |
如果您想要在提出 |
|
(有條件需要) |
如果您想要在建立儲存貯體時啟用物件鎖定,則需要 。 |
|
(有條件必要) |
如果您想要在建立儲存貯體時指定 S3 物件擁有權,則需要 。 |
|
(必要) |
刪除 S3 儲存貯體的必要項目。 |
|
(必要) |
從 S3 儲存貯體刪除 S3 分析組態時需要。 |
|
(必要) |
刪除儲存貯體的跨來源資源共用 (CORS) 組態時需要。 |
|
(必要) |
需要使用 Amazon S3 受管金鑰 (SSE-S3) 將 S3 儲存貯體的預設加密組態重設為伺服器端加密。 Amazon S3 |
|
(必要) |
從 S3 儲存貯體刪除現有 S3 Intelligent-Tiering 組態時需要。 |
|
(必要) |
從 S3 儲存貯體刪除 S3 庫存組態時需要。 |
|
(必要) |
需要刪除 S3 儲存貯體的 S3 生命週期組態。 |
|
(必要) |
需要從 S3 儲存貯體刪除 Amazon CloudWatch 請求指標的指標組態。 |
|
(必要) |
需要移除 S3 儲存貯體的物件擁有權設定。移除後,物件擁有權設定會變成 |
|
(必要) |
需要刪除 S3 儲存貯體的政策。 |
|
(必要) |
需要刪除 S3 儲存貯體的複寫組態。 |
|
(必要) |
從 S3 儲存貯體刪除標籤所需的項目。 |
|
(必要) |
需要移除 S3 儲存貯體的網站組態。 |
|
DeletePublicAccessBlock (儲存貯體層級) |
(必要) |
需要移除 S3 儲存貯體的區塊公有存取組態。 |
(必要) |
需要使用加速子資源來傳回儲存貯體的 Amazon S3 Transfer Acceleration 狀態,該狀態為已啟用或已暫停。 |
|
(必要) |
需要傳回 S3 儲存貯體的存取控制清單 (ACL)。 |
|
(必要) |
需要傳回由 S3 儲存貯體的分析組態 ID 識別的分析組態。 |
|
(必要) |
傳回 S3 儲存貯體的跨來源資源共用 (CORS) 組態所必需。 |
|
(必要) |
需要傳回 S3 儲存貯體的預設加密組態。 |
|
(必要) |
取得 S3 儲存貯體的 S3 Intelligent-Tiering 組態所需的項目。 |
|
(必要) |
從儲存貯體傳回由庫存組態 ID 識別的庫存組態時,需要此組態。 |
|
(必要) |
需要傳回儲存貯體的 S3 生命週期組態。 |
|
(必要) |
需要傳回 AWS 區域 S3 儲存貯體所在的 。 |
|
(必要) |
需要傳回 S3 儲存貯體的記錄狀態,以及使用者檢視和修改該狀態的許可。 |
|
(必要) |
需要從儲存貯體取得指標組態 ID 指定的指標組態。 |
|
(必要) |
需要傳回 S3 儲存貯體的通知組態。 |
|
(必要) |
擷取 S3 儲存貯體的物件擁有權設定所需。 |
|
(必要) |
需要傳回 S3 儲存貯體的政策。 |
|
(必要) |
需要擷取 S3 儲存貯體的政策狀態,指出儲存貯體是否為公有。 |
|
(必要) |
需要傳回 S3 儲存貯體的複寫組態。 |
|
(必要) |
需要傳回 S3 儲存貯體的請求付款組態。 |
|
(必要) |
需要傳回 S3 儲存貯體的版本控制狀態。 |
|
(必要) |
需要傳回與 S3 儲存貯體相關聯的標籤集。 |
|
(必要) |
需要傳回 S3 儲存貯體的網站組態。 |
|
(必要) |
取得 S3 儲存貯體的物件鎖定組態所需的項目。 |
|
GetPublicAccessBlock (儲存貯體層級) |
(必要) |
擷取 S3 儲存貯體的區塊公有存取組態時需要。 |
(必要) |
判斷儲存貯體是否存在,以及您是否具有存取儲存貯體的許可時的必要項目。 |
|
(必要) |
需要列出 S3 儲存貯體的分析組態。 |
|
(必要) |
需要列出 S3 儲存貯體的 S3 Intelligent-Tiering 組態。 |
|
(必要) |
傳回 S3 儲存貯體庫存組態清單的必要項目。 |
|
(必要) |
需要列出 S3 儲存貯體的指標組態。 |
|
(必要) |
需要列出 S3 儲存貯體中部分或全部 (最多 1,000 個) 物件。 |
|
(有條件必要) |
如果您想要顯示物件擁有者資訊,則需要 。 |
|
(必要) |
需要列出 S3 儲存貯體中部分或全部 (最多 1,000 個) 物件。 |
|
(有條件必要) |
如果您想要顯示物件擁有者資訊,則需要 。 |
|
(必要) |
若要取得 S3 儲存貯體中所有物件版本的中繼資料,則需要此項目。 |
|
(必要) |
需要設定現有儲存貯體的加速組態。 |
|
(必要) |
需要使用存取控制清單 (ACLs) 來設定現有儲存貯體的許可。 |
|
(必要) |
設定 S3 儲存貯體的分析組態時需要。 |
|
(必要) |
設定 S3 儲存貯體的跨來源資源共用 (CORS) 組態時需要。 |
|
(必要) |
設定 S3 儲存貯體的預設加密時需要。 |
|
(必要) |
將 S3 Intelligent-Tiering 組態放入 S3 儲存貯體時需要。 |
|
(必要) |
需要將庫存組態新增至 S3 儲存貯體。 |
|
(必要) |
建立新的 S3 生命週期組態或取代 S3 儲存貯體的現有生命週期組態時需要。 |
|
(必要) |
為 S3 儲存貯體設定記錄參數,並指定誰可以檢視和修改記錄參數的許可時的必要項目。 |
|
(必要) |
為 S3 儲存貯體的 Amazon CloudWatch 請求指標設定或更新指標組態所必需。 |
|
(必要) |
為 S3 儲存貯體啟用指定事件通知所需的 。 |
|
(必要) |
建立或修改 S3 儲存貯體的物件擁有權設定時需要。 |
|
(必要) |
將 S3 儲存貯體政策套用到儲存貯體所需的 。 |
|
(必要) |
建立新複寫組態或取代 S3 儲存貯體的現有複寫組態時需要。 |
|
(必要) |
設定儲存貯體的請求付款組態時需要。 |
|
(必要) |
需要將一組標籤新增至 S3 儲存貯體。 |
|
(必要) |
設定 S3 儲存貯體的版本控制狀態所需的 。 |
|
(必要) |
將儲存貯體設定為網站,並設定網站組態所需的項目。 |
|
(必要) |
在 S3 儲存貯體上放置物件鎖定組態時需要。 |
|
PutPublicAccessBlock (儲存貯體層級) |
(必要) |
為 S3 儲存貯體建立或修改區塊公有存取組態時需要。 |
物件操作和許可
物件操作是在物件資源類型上執行的 S3 API 操作。您必須為資源型政策 (例如儲存貯體政策、存取點政策、多區域存取點政策、VPC 端點政策) 或 IAM 身分型政策中的物件操作指定 S3 政策動作。
在政策中,Resource
元素必須是物件 ARN。如需Resource
元素格式和範例政策的詳細資訊,請參閱 物件操作。
注意
AWS KMS 政策動作 (
kms:GenerateDataKey
和kms:Decrypt
) 僅適用於 AWS KMS 資源類型,且必須在 IAM 身分型政策和 AWS KMS 資源型政策 (AWS KMS 金鑰政策) 中指定。您無法在 S3 資源型政策中指定 AWS KMS 政策動作,例如 S3 儲存貯體政策。-
當您使用存取點控制物件操作的存取時,您可以使用存取點政策。若要在存取點政策中授予物件操作的許可,請注意下列事項:
-
在授予物件操作許可的存取點政策中,
Resource
元素必須是透過存取點存取物件的 ARNs。如需Resource
元素格式和範例政策的詳細資訊,請參閱 存取點政策中的物件操作。 存取點不支援所有物件操作。如需詳細資訊,請參閱存取點與 S3 操作的相容性。
-
多區域存取點不支援所有物件操作。如需詳細資訊,請參閱多區域存取點與 S3 操作的相容性。
以下是物件操作和必要政策動作的映射。
API 操作 | 政策動作 | 政策動作的說明 |
---|---|---|
(必要) |
需要中止分段上傳。 |
|
(必要) |
需要完成分段上傳。 |
|
(有條件需要) |
如果您想要完成 AWS KMS 客戶受管金鑰加密物件的分段上傳,則此為必要項目。 |
|
對於來源物件: |
對於來源物件: |
|
(必要) |
|
|
(有條件需要) |
如果您想要從來源儲存貯體複製 AWS KMS 客戶受管金鑰加密物件,則此為必要項目。 |
|
對於目的地物件: |
對於目的地物件: |
|
(必要) |
需要將複製的物件放入目的地儲存貯體。 |
|
(有條件必要) |
如果您想要在提出 |
|
(有條件必要) |
如果您想要在提出 |
|
(有條件必要) |
如果您想要使用 AWS KMS 客戶受管金鑰加密複製的物件,並將其放入目的地儲存貯體,則此為必要項目。 |
|
(有條件必要) |
如果您想要設定新物件的物件鎖定保留組態,則需要 。 |
|
(有條件必要) |
如果您想要在新物件上放置物件鎖定法務保存,則此為必要項目。 |
|
(必要) |
建立分段上傳時需要。 |
|
(有條件必要) |
如果您想要為上傳的物件設定物件存取控制清單 (ACL) 許可,則需要此項目。 |
|
(有條件必要) |
如果您想要將物件標記 (多個) 新增至上傳的物件,則此為必要項目。 |
|
(有條件必要) |
如果您想要在啟動分段上傳時,使用 AWS KMS 客戶受管金鑰來加密物件,則此為必要項目。 |
|
(有條件必要) |
如果您想要為上傳的物件設定物件鎖定保留組態,則需要 。 |
|
(有條件必要) |
如果您想要將物件鎖定法務保存套用至上傳的物件,則此為必要項目。 |
|
(必要) |
|
|
(有條件必要) |
如果您想要刪除受物件鎖定保留管理模式保護的物件,則需要此項目。 |
|
(必要) |
|
|
(有條件必要) |
如果您想要刪除受物件鎖定保留的管理模式保護的物件,則需要此選項。 |
|
(必要) |
|
|
(必要) |
|
|
(有條件需要) |
如果您想要取得和解密 AWS KMS 客戶受管金鑰加密物件,則需要 。 |
|
(有條件需要) |
如果您想要在提出 |
|
(有條件必要) |
如果您想要取得物件的目前物件鎖定法務保存狀態,則需要 。 |
|
(有條件必要) |
如果您想要擷取物件的物件鎖定保留設定,則需要 。 |
|
(必要) |
|
|
(必要) |
|
|
(有條件需要) |
如果您想要擷取 AWS KMS 與客戶受管金鑰加密物件相關的屬性,則需要 。 |
|
(必要) |
若要取得物件目前的物件鎖定法務保存狀態,必須執行此作業。 |
|
(必要) |
擷取物件的物件鎖定保留設定時需要。 |
|
(必要) |
|
|
(必要) |
傳回物件的 torrent 檔案所必需。 |
|
(必要) |
需要從物件擷取中繼資料,而不傳回物件本身。 |
|
(有條件必要) |
如果您想要取得物件的目前物件鎖定法務保存狀態,則需要 。 |
|
(有條件必要) |
如果您想要擷取物件的物件鎖定保留設定,則需要 。 |
|
(必要) |
需要列出儲存貯體中正在進行的分段上傳。 |
|
(必要) |
需要列出已針對特定分段上傳上傳的部分。 |
|
(有條件需要) |
如果您想要列出 AWS KMS 客戶受管金鑰加密分段上傳的部分,則此為必要項目。 |
|
(必要) |
放置物件的必要項目。 |
|
(有條件必要) |
如果您想要在提出 |
|
(有條件必要) |
如果您想要在提出 |
|
(有條件必要) |
如果您想要加密具有 AWS KMS 客戶受管金鑰的物件,則需要 。 |
|
(有條件必要) |
如果您想要在物件上設定物件鎖定保留組態,則需要 。 |
|
(有條件必要) |
如果您想要將物件鎖定法務保存組態套用至指定的物件,則此為必要項目。 |
|
(必要) |
|
|
(必要) |
需要將物件鎖定法務保存組態套用至物件。 |
|
(必要) |
需要將物件鎖定保留組態套用至物件。 |
|
(有條件必要) |
如果您想要繞過物件鎖定保留組態的管理模式,則需要 。 |
|
(必要) |
|
|
(必要) |
還原封存物件的副本時需要。 |
|
(必要) |
需要根據簡單的結構化查詢語言 (SQL) 陳述式來篩選 S3 物件的內容。 |
|
(有條件需要) |
如果您想要篩選使用 AWS KMS 客戶受管金鑰加密的 S3 物件內容,則需要此項目。 |
|
(必要) |
在分段上傳中上傳組件時需要。 |
|
(有條件必要) |
如果您想要放置上傳部分,並使用 AWS KMS 客戶受管金鑰對其進行加密,則此為必要項目。 |
|
對於來源物件: |
對於來源物件: |
|
(必要) |
|
|
(有條件必要) |
如果您想要從來源儲存貯體複製 AWS KMS 客戶受管金鑰加密物件,則需要 。 |
|
對於目的地部分: |
對於目的地部分: |
|
(必要) |
需要將分段上傳部分上傳至目的地儲存貯體。 |
|
(有條件必要) |
如果您想要在將零件上傳到目的地儲存貯體時,使用 AWS KMS 客戶受管金鑰加密零件,則需要此項目。 |
存取點操作和許可
存取點操作是在accesspoint
資源類型上執行的 S3 API 操作。您必須在 IAM 身分型政策中指定存取點操作的 S3 政策動作,而不是儲存貯體政策或存取點政策。
在政策中,Resource
元素必須是 accesspoint
ARN。如需Resource
元素格式和範例政策的詳細資訊,請參閱 存取點操作。
注意
如果您想要使用存取點來控制對儲存貯體或物件操作的存取,請注意下列事項:
-
如需使用存取點控制對儲存貯體操作的存取,請參閱 存取點政策中的儲存貯體操作。
-
如需使用存取點控制物件操作的存取,請參閱 存取點政策中的物件操作。
如需如何設定存取點政策的詳細資訊,請參閱 設定 IAM 政策以使用存取點。
以下是存取點操作和所需政策動作的映射。
API 操作 | 政策動作 | 政策動作的說明 |
---|---|---|
(必要) |
建立與 S3 儲存貯體相關聯的存取點時需要。 |
|
(必要) |
刪除存取點的必要項目。 |
|
(必要) |
刪除存取點政策的必要項目。 |
|
(必要) |
擷取存取點政策所需的 。 |
|
(必要) |
需要擷取指定存取點目前是否有允許公開存取的政策的資訊。 |
|
(必要) |
放置存取點政策的必要項目。 |
Object Lambda 存取點操作和許可
Object Lambda Access Point 操作是在objectlambdaaccesspoint
資源類型上執行的 S3 API 操作。如需如何設定 Object Lambda Access Point 操作政策的詳細資訊,請參閱 設定 Object Lambda 存取點的 IAM 政策。
以下是 Object Lambda Access Point 操作和必要政策動作的映射。
API 操作 | 政策動作 | 政策動作的說明 |
---|---|---|
(必要) |
建立 Object Lambda 存取點所需的項目。 |
|
(必要) |
需要刪除指定的 Object Lambda 存取點。 |
|
(必要) |
需要刪除指定 Object Lambda 存取點上的政策。 |
|
(必要) |
擷取 Object Lambda 存取點的組態所需。 |
|
(必要) |
擷取 Object Lambda 存取點的相關資訊時需要。 |
|
(必要) |
需要傳回與指定 Object Lambda 存取點相關聯的存取點政策。 |
|
(必要) |
傳回特定 Object Lambda Access Point 政策的政策狀態所必需。 |
|
(必要) |
設定 Object Lambda Access Point 組態所需的 。 |
|
(必要) |
將存取政策與指定的 Object Lambda Access Point 建立關聯時需要。 |
多區域存取點操作和許可
多區域存取點操作是在multiregionaccesspoint
資源類型上執行的 S3 API 操作。如需如何設定多區域存取點操作政策的詳細資訊,請參閱 多區域存取點政策範例。
以下是多區域存取點操作和所需政策動作的映射。
API 操作 | 政策動作 | 政策動作的說明 |
---|---|---|
(必要) |
需要建立多區域存取點並將其與 S3 儲存貯體建立關聯。 |
|
(必要) |
刪除多區域存取點的必要項目。 |
|
(必要) |
需要擷取非同步請求的狀態,才能管理多區域存取點。 |
|
(必要) |
需要傳回指定多區域存取點的組態資訊。 |
|
(必要) |
需要傳回指定多區域存取點的存取控制政策。 |
|
(必要) |
需要傳回特定多區域存取點的政策狀態,以了解指定的多區域存取點是否具有允許公開存取的存取控制政策。 |
|
(必要) |
需要傳回多區域存取點的路由組態。 |
|
(必要) |
需要更新指定多區域存取點的存取控制政策。 |
|
(必要) |
需要為多區域存取點提交更新的路由組態。 |
批次任務操作和許可
(批次操作) 任務操作是在job
資源類型上操作的 S3 API 操作。您必須為 IAM 身分型政策中的任務操作指定 S3 政策動作,而不是在儲存貯體政策中。
在政策中,Resource
元素必須是 job
ARN。如需Resource
元素格式和範例政策的詳細資訊,請參閱 批次任務操作。
以下是批次任務操作和所需政策動作的映射。
API 操作 | 政策動作 | 政策動作的說明 |
---|---|---|
(必要) |
需要從現有的 S3 批次操作任務中移除標籤。 |
|
(必要) |
擷取批次操作任務的組態參數和狀態時需要。 |
|
(必要) |
需要傳回現有 S3 批次操作任務的標籤集。 |
|
(必要) |
在現有的 S3 批次操作任務上放置或取代標籤時需要。 |
|
(必要) |
需要更新現有任務的優先順序。 |
|
(必要) |
必須更新指定任務的狀態。 |
S3 Storage Lens 組態操作和許可
S3 Storage Lens 組態操作是在storagelensconfiguration
資源類型上操作的 S3 API 操作。如需如何設定 S3 Storage Lens 組態操作的詳細資訊,請參閱 設定 Amazon S3 Storage Lens 許可。
以下是 S3 Storage Lens 組態操作和必要政策動作的映射。
API 操作 | 政策動作 | 政策動作的說明 |
---|---|---|
(必要) |
刪除 S3 Storage Lens 組態的必要項目。 |
|
(必要) |
刪除 S3 Storage Lens 組態標籤所需的項目。 |
|
(必要) |
需要 才能取得 S3 Storage Lens 組態。 |
|
(必要) |
取得 S3 Storage Lens 組態的標籤所必需。 |
|
(必要) |
在現有的 S3 Storage Lens 組態上放置或取代標籤時需要。 |
S3 Storage Lens 群組操作和許可
S3 Storage Lens 群組操作是在storagelensgroup
資源類型上執行的 S3 API 操作。如需如何設定 S3 Storage Lens 群組許可的詳細資訊,請參閱 Storage Lens 群組許可。
以下是 S3 Storage Lens 群組操作和必要政策動作的映射。
API 操作 | 政策動作 | 政策動作的說明 |
---|---|---|
(必要) |
刪除現有 S3 Storage Lens 群組的必要項目。 |
|
(必要) |
擷取 S3 Storage Lens 群組組態詳細資訊所需的項目。 |
|
(必要) |
更新現有的 S3 Storage Lens 群組時需要。 |
帳戶操作和許可
帳戶操作是在帳戶層級操作的 S3 API 操作。帳戶不是 Amazon S3 定義的資源類型。您必須在 IAM 身分型政策中指定帳戶操作的 S3 政策動作,而非儲存貯體政策。
在政策中,Resource
元素必須是 "*"
。如需範例政策的詳細資訊,請參閱 帳戶操作。
以下是帳戶操作和必要政策動作的映射。
API 操作 | 政策動作 | 政策動作的說明 |
---|---|---|
(必要) |
建立新的 S3 批次操作任務時需要。 |
|
(必要) |
建立新的 S3 Storage Lens 群組並將其與指定的 AWS 帳戶 ID 建立關聯時需要。 |
|
(有條件必要) |
如果您想要使用 AWS 資源標籤建立 S3 Storage Lens 群組,則此為必要項目。 |
|
DeletePublicAccessBlock (帳戶層級) |
(必要) |
需要從 移除封鎖公有存取組態 AWS 帳戶。 |
(必要) |
擷取指定存取點的組態資訊時需要。 |
|
GetAccessPointPolicy (帳戶層級) |
(必要) |
擷取 的區塊公有存取組態所需 AWS 帳戶。 |
(必要) |
需要列出由 擁有之 S3 儲存貯體的存取點 AWS 帳戶。 |
|
(必要) |
列出 Object Lambda 存取點的必要項目。 |
|
(必要) |
需要傳回請求已驗證寄件者擁有的所有儲存貯體清單。 |
|
(必要) |
需要列出目前任務和最近結束的任務。 |
|
(必要) |
需要傳回目前與指定 相關聯的多區域存取點清單 AWS 帳戶。 |
|
(必要) |
需要取得 的 S3 Storage Lens 組態清單 AWS 帳戶。 |
|
(必要) |
需要列出指定首頁中的所有 S3 Storage Lens 群組 AWS 區域。 |
|
PutPublicAccessBlock (帳戶層級) |
(必要) |
為 建立或修改區塊公有存取組態時需要 AWS 帳戶。 |
(必要) |
放置 S3 Storage Lens 組態的必要項目。 |