AWS Transfer 系列的動作、資源和條件索引鍵

AWS Transfer Family (服務前置詞:transfer) 提供下列服務特定資源、動作和條件內容金鑰，以便在 IAM 權限政策中使用。

參考資料：

• 了解如何設定此服務。

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

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

AWS Transfer 系列定義的動作

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

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

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

注意

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

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

動作	描述	存取層級	資源類型 (*必填項目)	條件索引鍵	相依動作
CreateAccess	准許新增與伺服器關聯的存取權	寫入	server*		iam:PassRole
CreateAgreement	准許新增與伺服器關聯的協議	寫入	server*		iam:PassRole
				aws:TagKeys aws:RequestTag/${TagKey}
CreateConnector	准許建立連接器	寫入		aws:TagKeys aws:RequestTag/${TagKey}	iam:PassRole
CreateProfile	准許建立設定檔	寫入		aws:TagKeys aws:RequestTag/${TagKey}
CreateServer	准許建立伺服器	寫入		aws:TagKeys aws:RequestTag/${TagKey}	iam:PassRole
CreateUser	准許新增與伺服器關聯的使用者	寫入	server*		iam:PassRole
				aws:TagKeys aws:RequestTag/${TagKey}
CreateWorkflow	授予許可來建立工作流程	寫入		aws:TagKeys aws:RequestTag/${TagKey}
DeleteAccess	准許刪除存取權	寫入	server*
DeleteAgreement	准許刪除協議	寫入	agreement*
DeleteCertificate	准許刪除憑證	寫入	certificate*
DeleteConnector	准許刪除連接器	寫入	connector*
DeleteHostKey	准許刪除與伺服器關聯的主機金鑰	寫入	host-key*
DeleteProfile	准許刪除設定檔	寫入	profile*
DeleteServer	准許刪除伺服器	寫入	server*
DeleteSshPublicKey	准許刪除使用者的 SSH 公有金鑰	寫入	user*
DeleteUser	准許刪除與伺服器關聯的使用者	寫入	user*
DeleteWorkflow	授予許可來刪除工作流程	寫入	workflow*
DescribeAccess	准許描述指派給伺服器的存取權	讀取	server*
DescribeAgreement	准許描述指派給伺服器的協議	讀取	agreement*
DescribeCertificate	准許描述憑證	讀取	certificate*
DescribeConnector	准許描述連接器	讀取	connector*
DescribeExecution	准許描述與工作流程相關聯的執行	讀取	workflow*
DescribeHostKey	准許描述與伺服器關聯的主機金鑰	讀取	host-key*
DescribeProfile	准許描述設定檔	讀取	profile*
DescribeSecurityPolicy	准許描述安全政策	讀取
DescribeServer	准許描述伺服器	讀取	server*
DescribeUser	准許描述與伺服器關聯的使用者	讀取	user*
DescribeWorkflow	准許描述工作流程	讀取	workflow*
ImportCertificate	准許新增憑證	寫入		aws:TagKeys aws:RequestTag/${TagKey}
ImportHostKey	准許將主機金鑰新增至伺服器	寫入	server*
				aws:TagKeys aws:RequestTag/${TagKey}
ImportSshPublicKey	准許將 SSH 公有金鑰新增至使用者	寫入	user*
ListAccesses	准許列出存取權	讀取	server*
ListAgreements	准許列出協議	讀取	server*
ListCertificates	准許列出憑證	讀取
ListConnectors	准許列出連接器	讀取
ListExecutions	准許列出與工作流程相關聯的執行數	讀取	workflow*
ListHostKeys	准許列出與伺服器關聯的主機金鑰	讀取	server*
ListProfiles	准許列出設定檔	讀取
ListSecurityPolicies	准許列出安全政策	列出
ListServers	准許列出伺服器	清單
ListTagsForResource	授予列出 AWS Transfer Family 列資源標籤的權限	讀取	agreement
			certificate
			connector
			host-key
			profile
			server
			user
			workflow
ListUsers	准許列出與伺服器關聯的使用者	列出	server*
ListWorkflows	准許列出工作流程	列出
SendWorkflowStepState	許准傳送非同步自訂步驟回呼	寫入	workflow*
StartDirectoryListing	授與使用連接器在遠端伺服器上起始清單作業的權限	寫入	connector*
StartFileTransfer	准許初始化連接器檔案傳輸	寫入	connector*
StartServer	准許啟動伺服器	寫入	server*
StopServer	准許停止伺服器	寫入	server*
TagResource	授予標籤 AWS Transfer Family 資源的權限	標記	agreement
			certificate
			connector
			host-key
			profile
			server
			user
			workflow
				aws:TagKeys aws:RequestTag/${TagKey}
TestConnection	准許測試連接器與遠端伺服器的連線	寫入	connector*
TestIdentityProvider	准許測試伺服器的自訂身分提供者	讀取	user*
UntagResource	授予取消標記 AWS Transfer Family 資源的權限	標記	agreement
			certificate
			connector
			host-key
			profile
			server
			user
			workflow
				aws:TagKeys
UpdateAccess	准許更新存取權	寫入			iam:PassRole
UpdateAgreement	准許更新協議	寫入	agreement*		iam:PassRole
UpdateCertificate	准許更新憑證	寫入	certificate*
UpdateConnector	准許更新連接器	寫入	connector*		iam:PassRole
UpdateHostKey	准許更新主機金鑰	寫入	host-key*
UpdateProfile	准許更新設定檔	寫入	profile*
UpdateServer	准許更新伺服器的組態	寫入	server*		iam:PassRole
UpdateUser	准許更新使用者的組態	寫入	user*		iam:PassRole

AWS Transfer 系列定義的資源類型

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

資源類型	ARN	條件索引鍵
user	arn:${Partition}:transfer:${Region}:${Account}:user/${ServerId}/${UserName}	aws:ResourceTag/${TagKey}
server	arn:${Partition}:transfer:${Region}:${Account}:server/${ServerId}	aws:ResourceTag/${TagKey}
workflow	arn:${Partition}:transfer:${Region}:${Account}:workflow/${WorkflowId}	aws:ResourceTag/${TagKey}
certificate	arn:${Partition}:transfer:${Region}:${Account}:certificate/${CertificateId}	aws:ResourceTag/${TagKey}
connector	arn:${Partition}:transfer:${Region}:${Account}:connector/${ConnectorId}	aws:ResourceTag/${TagKey}
profile	arn:${Partition}:transfer:${Region}:${Account}:profile/${ProfileId}	aws:ResourceTag/${TagKey}
agreement	arn:${Partition}:transfer:${Region}:${Account}:agreement/${AgreementId}	aws:ResourceTag/${TagKey}
host-key	arn:${Partition}:transfer:${Region}:${Account}:host-key/${ServerId}/${HostKeyId}	aws:ResourceTag/${TagKey}

AWS Transfer 系列的條件索引鍵

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

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

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