本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
AWS DataSync 的動作、資源及條件索引鍵
AWS DataSync (服務字首:datasync) 提供下列服務特定的資源、動作和條件內容索引鍵,可用於 IAM 許可政策。
參考資料:
-
了解如何設定此服務。
-
檢視可供此服務使用的 API 操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
AWS DataSync 定義的動作
您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。在政策中使用動作時,通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過,在某些情況下,單一動作可控制對多個操作的存取。或者,某些操作需要多種不同的動作。
動作資料表的存取層級欄說明動作的分類方式 (列出、讀取、許可管理或標記)。此分類可協助您了解在政策中使用某動作時,該動作授予您的存取層級。如需存取層級的詳細資訊,請參閱政策摘要中的存取層級。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值,您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型,則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源,呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取,則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要),則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊,請參閱「資源類型」資料表的條件索引鍵欄。
動作資料表的相依動作欄會顯示成功呼叫動作所需的其他許可。除了 動作本身的許可之外,還可能需要這些許可。當動作指定相依動作時,這些相依性可能適用於針對該動作定義的其他資源,而不只是資料表中列出的第一個資源。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄,其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊,請參閱動作資料表。
| 動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
|---|---|---|---|---|---|
| AddStorageSystem | 准許建立儲存系統 | 寫入 | |||
| CancelTaskExecution | 准許取消執行同步處理任務 | 寫入 | |||
| CreateAgent | 准許啟動您在主機上部署的代理程式 | 寫入 | |||
| CreateLocationAzureBlob | 准許建立 Microsoft Azure Blob 儲存容器的端點 | 寫入 | |||
| CreateLocationEfs | 准許為 Amazon EFS 檔案系統建立端點 | 寫入 | |||
| CreateLocationFsxLustre | 准許為 Amazon FSx Lustre 建立端點 | 寫入 | |||
| CreateLocationFsxOntap | 准許為 Amazon FSx for ONTAP 建立端點 | 寫入 | |||
| CreateLocationFsxOpenZfs | 准許為 Amazon FSx for OpenZFS 建立端點 | 寫入 | |||
| CreateLocationFsxWindows | 准許為 Amazon FSx Windows 檔案伺服器檔案系統建立端點 | 寫入 | |||
| CreateLocationHdfs | 准許為 Amazon Hdfs 建立端點 | 寫入 | |||
| CreateLocationNfs | 准許為 NFS 檔案系統建立端點 | 寫入 | |||
| CreateLocationObjectStorage | 准許為自我管理物件儲存貯體建立端點 | 寫入 | |||
| CreateLocationS3 | 准許為 Amazon S3 儲存貯體建立端點 | 寫入 | |||
| CreateLocationSmb | 准許建立 SMB 檔案系統的端點 | 寫入 | |||
| CreateTask | 准許建立同步任務 | 寫入 | |||
| DeleteAgent | 准許刪除代理程式 | 寫入 | |||
| DeleteLocation | 准許刪除 AWS DataSync 使用的位置 | 寫入 | |||
| DeleteTask | 准許刪除同步任務 | 寫入 | |||
| DescribeAgent | 准許檢視中繼資料,例如名稱、網路界面和同步代理程式的相關狀態 (也就是說,無論代理程式是否在執行中) | 閱讀 | |||
| DescribeDiscoveryJob | 准許描述有關探索任務的中繼資料 | 閱讀 | |||
| DescribeLocationAzureBlob | 准許檢視 Azure Blob Storage 同步位置的中繼資料 (例如路徑資訊) | 閱讀 | |||
| DescribeLocationEfs | 准許檢視中繼資料,例如 Amazon EFS 同步位置的路徑資訊 | 閱讀 | |||
| DescribeLocationFsxLustre | 准許檢視中繼資料,例如 Amazon FSx Lustre 同步位置的相關路徑資訊 | 閱讀 | |||
| DescribeLocationFsxOntap | 准許檢視中繼資料,例如 Amazon FSx for ONTAP 同步位置的相關路徑資訊 | 閱讀 | |||
| DescribeLocationFsxOpenZfs | 准許檢視中繼資料,例如 Amazon FSx OpenZFS 同步位置的相關路徑資訊 | 閱讀 | |||
| DescribeLocationFsxWindows | 准許檢視中繼資料,例如 Amazon FSx Windows 同步位置的相關路徑資訊 | 閱讀 | |||
| DescribeLocationHdfs | 准許檢視中繼資料,例如 Amazon HDFS 同步位置的路徑資訊 | 閱讀 | |||
| DescribeLocationNfs | 准許檢視 NFS 同步位置的中繼資料 (例如路徑資訊) | 讀取 | |||
| DescribeLocationObjectStorage | 准許檢視有關自我管理物件儲存伺服器位置的中繼資料 | 讀取 | |||
| DescribeLocationS3 | 准許檢視關於 Amazon S3 儲存貯體同步位置的中繼資料 (例如儲存貯體名稱) | 讀取 | |||
| DescribeLocationSmb | 准許檢視 SMB 同步位置的中繼資料 (例如路徑資訊) | 閱讀 | |||
| DescribeStorageSystem | 准許檢視有關儲存系統的中繼資料 | 閱讀 | |||
| DescribeStorageSystemResourceMetrics | 准許描述探索任務所收集之資源指標 | 清單 | |||
| DescribeStorageSystemResources | 准許描述探索任務所識別之資源 | 清單 | |||
| DescribeTask | 准許檢視有關同步任務的中繼資料 | 讀取 | |||
| DescribeTaskExecution | 准許檢視正在執行之同步任務的中繼資料 | 閱讀 | |||
| GenerateRecommendations | 准許對探索任務所識別之資源產生建議 | 寫入 | |||
| ListAgents | 准許列出請求中指定 AWS 帳戶 區域中 擁有的代理程式 | 清單 | |||
| ListDiscoveryJobs | 准許列出探索任務 | 清單 | |||
| ListLocations | 准許列出來源和目標同步位置 | 清單 | |||
| ListStorageSystems | 准許列出儲存系統 | 清單 | |||
| ListTagsForResource | 准許列出已新增至指定資源的標籤 | 讀取 | |||
| ListTaskExecutions | 准許列出已執行的同步任務 | 列出 | |||
| ListTasks | 准許列出所有同步任務 | 清單 | |||
| RemoveStorageSystem | 准許刪除儲存系統 | 寫入 | |||
| StartDiscoveryJob | 准許啟動儲存系統的探索任務 | 寫入 | |||
| StartTaskExecution | 准許啟動同步任務的特定叫用 | 寫入 | |||
| StopDiscoveryJob | 准許停止探索任務 | 寫入 | |||
| TagResource | 准許將鍵/值對套用至 AWS 資源 | 標記 | |||
| UntagResource | 准許從指定的資源移除一或多個標籤 | 標記 | |||
| UpdateAgent | 准許更新代理程式的名稱 | 寫入 | |||
| UpdateDiscoveryJob | 准許更新探索任務 | 寫入 | |||
| UpdateLocationAzureBlob | 准許更新 Azure Blob Storage 同步位置 | 寫入 | |||
| UpdateLocationEfs | 准許更新 EFS 同步位置 | 寫入 | |||
| UpdateLocationFsxLustre | 准許更新 FSx Lustre 同步位置 | 寫入 | |||
| UpdateLocationFsxOntap | 准許更新 FSx ONTAP 同步位置 | 寫入 | |||
| UpdateLocationFsxOpenZfs | 准許更新 FSx OpenZFS 同步位置 | 寫入 | |||
| UpdateLocationFsxWindows | 准許更新 FSx Windows 同步位置 | 寫入 | |||
| UpdateLocationHdfs | 准許更新 HDFS 同步位置 | 寫入 | |||
| UpdateLocationNfs | 准許更新 NFS 同步位置 | 寫入 | |||
| UpdateLocationObjectStorage | 准許更新自我管理物件儲存伺服器位置 | 寫入 | |||
| UpdateLocationS3 | 准許更新 S3 同步位置 | 寫入 | |||
| UpdateLocationSmb | 准許更新 SMB 同步位置 | 寫入 | |||
| UpdateStorageSystem | 准許更新儲存系統 | 寫入 | |||
| UpdateTask | 准許更新與同步任務相關聯的中繼資料 | 寫入 | |||
| UpdateTaskExecution | 准許更新同步任務的執行 | 寫入 | |||
AWS DataSync 定義的資源類型
此服務會定義下列資源類型,並可用在 IAM 許可政策陳述式的 Resource 元素中。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊,請參閱資源類型資料表。
| 資源類型 | ARN | 條件索引鍵 |
|---|---|---|
| agent |
arn:${Partition}:datasync:${Region}:${AccountId}:agent/${AgentId}
|
|
| location |
arn:${Partition}:datasync:${Region}:${AccountId}:location/${LocationId}
|
|
| task |
arn:${Partition}:datasync:${Region}:${AccountId}:task/${TaskId}
|
|
| taskexecution |
arn:${Partition}:datasync:${Region}:${AccountId}:task/${TaskId}/execution/${ExecutionId}
|
|
| storagesystem |
arn:${Partition}:datasync:${Region}:${AccountId}:system/${StorageSystemId}
|
|
| discoveryjob |
arn:${Partition}:datasync:${Region}:${AccountId}:system/${StorageSystemId}/job/${DiscoveryJobId}
|
AWS DataSync 的條件索引鍵
AWS DataSync 定義下列條件索引鍵,可用於 IAM 政策的 Condition元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊,請參閱條件索引鍵表。
若要檢視所有 服務可用的全域條件索引鍵,請參閱AWS 全域條件內容索引鍵。
| 條件索引鍵 | 描述 | 類型 |
|---|---|---|
| aws:RequestTag/${TagKey} | 依請求中的標籤鍵值組篩選存取權 | String |
| aws:ResourceTag/${TagKey} | 依與資源相關聯的標籤鍵值篩選存取權 | String |
| aws:TagKeys | 依請求中的標籤索引鍵篩選存取權 | ArrayOfString |