AWS DataSync 的動作、資源及條件索引鍵

AWS DataSync (服務字首：datasync) 提供下列服務特定型資源、動作和條件內容索引鍵，可用於 IAM 許可政策。

參考資料：

• 了解如何設定此服務。

• 檢視可供此服務使用的 API 操作清單。

• 了解如何使用 IAM 許可政策來保護此服務及其資源。

AWS DataSync 定義的動作

您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS 中執行操作的許可。在政策中使用動作時，通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。

「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果此欄包含資源類型，則您可以在包含該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，發起人必須具有將動作與這些資源搭配使用的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取，則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。

「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。

注意

資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。

如需下表各欄的詳細資訊，請參閱動作表。

動作	描述	存取層級	資源類型 (*必填項目)	條件索引鍵	相依動作
AddStorageSystem	准許建立儲存系統	寫入	agent*
				aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey} aws:TagKeys
CancelTaskExecution	准許取消執行同步處理任務	寫入	taskexecution*
				aws:ResourceTag/${TagKey}
CreateAgent	准許啟動您在主機上部署的代理程式	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateLocationAzureBlob	准許建立 Microsoft Azure Blob 儲存容器的端點	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateLocationEfs	准許為 Amazon EFS 檔案系統建立端點	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateLocationFsxLustre	准許為 Amazon FSx Lustre 建立端點	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateLocationFsxOntap	准許為 Amazon FSx for ONTAP 建立端點	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateLocationFsxOpenZfs	准許為 Amazon FSx for OpenZFS 建立端點	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateLocationFsxWindows	准許為 Amazon FSx Windows 檔案伺服器檔案系統建立端點	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateLocationHdfs	准許為 Amazon Hdfs 建立端點	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateLocationNfs	准許為 NFS 檔案系統建立端點	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateLocationObjectStorage	准許為自我管理物件儲存貯體建立端點	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateLocationS3	准許為 Amazon S3 儲存貯體建立端點	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateLocationSmb	准許建立 SMB 檔案系統的端點	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateTask	准許建立同步任務	寫入	location*
			agent
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteAgent	准許刪除代理程式	寫入	agent*
DeleteLocation	准許刪除 AWS DataSync 所使用的位置	寫入	location*
DeleteTask	准許刪除同步任務	寫入	task*
DescribeAgent	准許檢視中繼資料，例如名稱、網路界面和同步代理程式的相關狀態 (也就是說，無論代理程式是否在執行中)	讀取	agent*
DescribeDiscoveryJob	准許描述有關探索任務的中繼資料	讀取	discoveryjob*
DescribeLocationAzureBlob	准許檢視 Azure Blob Storage 同步位置的中繼資料 (例如路徑資訊)	讀取	location*
DescribeLocationEfs	准許檢視中繼資料，例如 Amazon EFS 同步位置的路徑資訊	讀取	location*
DescribeLocationFsxLustre	准許檢視中繼資料，例如 Amazon FSx Lustre 同步位置的相關路徑資訊	讀取	location*
DescribeLocationFsxOntap	准許檢視中繼資料，例如 Amazon FSx for ONTAP 同步位置的相關路徑資訊	讀取	location*
DescribeLocationFsxOpenZfs	准許檢視中繼資料，例如 Amazon FSx OpenZFS 同步位置的相關路徑資訊	讀取	location*
DescribeLocationFsxWindows	准許檢視中繼資料，例如 Amazon FSx Windows 同步位置的相關路徑資訊	讀取	location*
DescribeLocationHdfs	准許檢視中繼資料，例如 Amazon HDFS 同步位置的路徑資訊	讀取	location*
DescribeLocationNfs	准許檢視 NFS 同步位置的中繼資料 (例如路徑資訊)	讀取	location*
DescribeLocationObjectStorage	准許檢視有關自我管理物件儲存伺服器位置的中繼資料	讀取	location*
DescribeLocationS3	准許檢視關於 Amazon S3 儲存貯體同步位置的中繼資料 (例如儲存貯體名稱)	讀取	location*
DescribeLocationSmb	准許檢視 SMB 同步位置的中繼資料 (例如路徑資訊)	讀取	location*
DescribeStorageSystem	准許檢視有關儲存系統的中繼資料	讀取	storagesystem*
DescribeStorageSystemResourceMetrics	准許描述探索任務所收集之資源指標	列出	discoveryjob*
DescribeStorageSystemResources	准許描述探索任務所識別之資源	列出	discoveryjob*
DescribeTask	准許檢視有關同步任務的中繼資料	讀取	task*
DescribeTaskExecution	准許檢視正在執行之同步任務的中繼資料	讀取	taskexecution*
				aws:ResourceTag/${TagKey}
GenerateRecommendations	准許對探索任務所識別之資源產生建議	寫入	discoveryjob*
ListAgents	准許列出請求所指定區域中 AWS 帳戶 擁有的代理程式	列出
ListDiscoveryJobs	准許列出探索任務	列出
ListLocations	准許列出來源和目標同步位置	列出
ListStorageSystems	准許列出儲存系統	列出
ListTagsForResource	准許列出已新增至指定資源的標籤	讀取	agent
			discoveryjob
			location
			storagesystem
			task
			taskexecution
ListTaskExecutions	准許列出已執行的同步任務	列出		aws:ResourceTag/${TagKey}
ListTasks	准許列出所有同步任務	列出
RemoveStorageSystem	准許刪除儲存系統	寫入	storagesystem*
StartDiscoveryJob	准許啟動儲存系統的探索任務	寫入	storagesystem*
StartTaskExecution	准許啟動同步任務的特定叫用	寫入	task*
				aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey} aws:TagKeys
StopDiscoveryJob	准許停止探索任務	寫入	discoveryjob*
TagResource	准許將索引鍵值組套用至 AWS 資源	標記	agent
			discoveryjob
			location
			storagesystem
			task
			taskexecution
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	准許從指定的資源移除一或多個標籤	標記	agent
			discoveryjob
			location
			storagesystem
			task
			taskexecution
				aws:TagKeys
UpdateAgent	准許更新代理程式的名稱	寫入	agent*
UpdateDiscoveryJob	准許更新探索任務	寫入	discoveryjob*
UpdateLocationAzureBlob	准許更新 Azure Blob Storage 同步位置	寫入	location*
UpdateLocationHdfs	准許更新 HDFS 同步位置	寫入	location*
UpdateLocationNfs	准許更新 NFS 同步位置	寫入	location*
UpdateLocationObjectStorage	准許更新自我管理物件儲存伺服器位置	寫入	location*
UpdateLocationSmb	准許更新 SMB 同步位置	寫入	location*
UpdateStorageSystem	准許更新儲存系統	寫入	storagesystem*
UpdateTask	准許更新與同步任務相關聯的中繼資料	寫入	task*
UpdateTaskExecution	准許更新同步任務的執行	寫入	taskexecution*
				aws:ResourceTag/${TagKey}

AWS DataSync 定義的資源類型

此服務會定義下列資源類型，並可用在 IAM 許可政策陳述式的 Resource 元素中。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型表。

資源類型	ARN	條件索引鍵
agent	arn:${Partition}:datasync:${Region}:${AccountId}:agent/${AgentId}	aws:ResourceTag/${TagKey}
location	arn:${Partition}:datasync:${Region}:${AccountId}:location/${LocationId}	aws:ResourceTag/${TagKey}
task	arn:${Partition}:datasync:${Region}:${AccountId}:task/${TaskId}	aws:ResourceTag/${TagKey}
taskexecution	arn:${Partition}:datasync:${Region}:${AccountId}:task/${TaskId}/execution/${ExecutionId}	aws:ResourceTag/${TagKey}
storagesystem	arn:${Partition}:datasync:${Region}:${AccountId}:system/${StorageSystemId}	aws:ResourceTag/${TagKey}
discoveryjob	arn:${Partition}:datasync:${Region}:${AccountId}:system/${StorageSystemId}/job/${DiscoveryJobId}	aws:ResourceTag/${TagKey}

AWS DataSync 的條件索引鍵

AWS DataSync 定義了下列條件索引鍵，可用於 IAM 政策的 Condition 元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。

若要檢視所有服務都可使用的全域條件索引鍵，請參閱可用的全域條件索引鍵。

條件索引鍵	描述	類型
aws:RequestTag/${TagKey}	依請求中的標籤鍵值組篩選存取權	字串
aws:ResourceTag/${TagKey}	依與資源相關聯的標籤鍵值篩選存取權	字串
aws:TagKeys	依請求中的標籤索引鍵篩選存取權	ArrayOfString