本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
AWS Transfer 系列的動作、資源和條件索引鍵
AWS Transfer Family （服務字首：transfer) 提供下列服務特定的資源、動作和條件內容索引鍵，可用於 IAM 許可政策。
參考資料：
-
了解如何設定此服務。
-
檢視可供此服務使用的 API 操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
AWS Transfer 系列定義的動作
您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。在政策中使用動作時，通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。
動作資料表的存取層級欄說明動作的分類方式 （列出、讀取、許可管理或標記）。此分類可協助您了解在政策中使用某動作時，該動作授予您的存取層級。如需存取層級的詳細資訊，請參閱政策摘要中的存取層級。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型，則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取，則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。
動作資料表的相依動作欄會顯示成功呼叫動作所需的其他許可。除了 動作本身的許可之外，還可能需要這些許可。當動作指定相依動作時，這些相依性可能適用於針對該動作定義的其他資源，而不只是資料表中列出的第一個資源。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊，請參閱動作資料表。
| 動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
|---|---|---|---|---|---|
| CreateAccess | 准許新增與伺服器關聯的存取權 | 寫入 |
iam:PassRole |
||
| CreateAgreement | 准許新增與伺服器關聯的協議 | 寫入 |
iam:PassRole |
||
| CreateConnector | 准許建立連接器 | 寫入 |
iam:PassRole |
||
| CreateProfile | 准許建立設定檔 | 寫入 | |||
| CreateServer | 准許建立伺服器 | 寫入 |
iam:PassRole |
||
| CreateUser | 准許新增與伺服器關聯的使用者 | 寫入 |
iam:PassRole |
||
| CreateWebApp | 准許建立 Web 應用程式 | 寫入 |
iam:PassRole |
||
| CreateWorkflow | 授予許可來建立工作流程 | 寫入 | |||
| DeleteAccess | 准許刪除存取權 | 寫入 | |||
| DeleteAgreement | 准許刪除協議 | 寫入 | |||
| DeleteCertificate | 准許刪除憑證 | 寫入 | |||
| DeleteConnector | 准許刪除連接器 | 寫入 | |||
| DeleteHostKey | 准許刪除與伺服器關聯的主機金鑰 | 寫入 | |||
| DeleteProfile | 准許刪除設定檔 | 寫入 | |||
| DeleteServer | 准許刪除伺服器 | 寫入 | |||
| DeleteSshPublicKey | 准許刪除使用者的 SSH 公有金鑰 | 寫入 | |||
| DeleteUser | 准許刪除與伺服器關聯的使用者 | 寫入 | |||
| DeleteWebApp | 准許刪除 Webapp | 寫入 | |||
| DeleteWebAppCustomization | 准許刪除 webapp 自訂 | 寫入 | |||
| DeleteWorkflow | 授予許可來刪除工作流程 | 寫入 | |||
| DescribeAccess | 准許描述指派給伺服器的存取權 | 閱讀 | |||
| DescribeAgreement | 准許描述指派給伺服器的協議 | 閱讀 | |||
| DescribeCertificate | 准許描述憑證 | 閱讀 | |||
| DescribeConnector | 准許描述連接器 | 閱讀 | |||
| DescribeExecution | 准許描述與工作流程相關聯的執行 | 閱讀 | |||
| DescribeHostKey | 准許描述與伺服器關聯的主機金鑰 | 閱讀 | |||
| DescribeProfile | 准許描述設定檔 | 閱讀 | |||
| DescribeSecurityPolicy | 准許描述安全政策 | 讀取 | |||
| DescribeServer | 准許描述伺服器 | 讀取 | |||
| DescribeUser | 准許描述與伺服器關聯的使用者 | 閱讀 | |||
| DescribeWebApp | 准許描述 Web 應用程式 | 閱讀 | |||
| DescribeWebAppCustomization | 准許描述 webapp 自訂 | 閱讀 | |||
| DescribeWorkflow | 准許描述工作流程 | 閱讀 | |||
| ImportCertificate | 准許新增憑證 | 寫入 | |||
| ImportHostKey | 准許將主機金鑰新增至伺服器 | 寫入 | |||
| ImportSshPublicKey | 准許將 SSH 公有金鑰新增至使用者 | 寫入 | |||
| ListAccesses | 准許列出存取權 | 閱讀 | |||
| ListAgreements | 准許列出協議 | 閱讀 | |||
| ListCertificates | 准許列出憑證 | 閱讀 | |||
| ListConnectors | 准許列出連接器 | 閱讀 | |||
| ListExecutions | 准許列出與工作流程相關聯的執行數 | 閱讀 | |||
| ListFileTransferResults | 准許列出連接器的檔案傳輸狀態 | 閱讀 | |||
| ListHostKeys | 准許列出與伺服器關聯的主機金鑰 | 閱讀 | |||
| ListProfiles | 准許列出設定檔 | 閱讀 | |||
| ListSecurityPolicies | 准許列出安全政策 | 列出 | |||
| ListServers | 准許列出伺服器 | 清單 | |||
| ListTagsForResource | 准許列出 AWS Transfer Family 資源的標籤 | 閱讀 | |||
| ListUsers | 准許列出與伺服器關聯的使用者 | 清單 | |||
| ListWebApps | 准許列出 Web 應用程式 | 清單 | |||
| ListWorkflows | 准許列出工作流程 | 列出 | |||
| SendWorkflowStepState | 許准傳送非同步自訂步驟回呼 | 寫入 | |||
| StartDirectoryListing | 准許使用連接器在遠端伺服器上啟動清單操作 | 寫入 | |||
| StartFileTransfer | 准許初始化連接器檔案傳輸 | 寫入 | |||
| StartRemoteDelete | 准許在遠端伺服器上啟動連接器刪除操作 | 寫入 | |||
| StartRemoteMove | 准許在遠端伺服器上啟動連接器移動操作 | 寫入 | |||
| StartServer | 准許啟動伺服器 | 寫入 | |||
| StopServer | 准許停止伺服器 | 寫入 | |||
| TagResource | 准許標記 AWS Transfer Family 資源 | 標記 | |||
| TestConnection | 准許測試連接器與遠端伺服器的連線 | 寫入 | |||
| TestIdentityProvider | 准許測試伺服器的自訂身分提供者 | 閱讀 | |||
| UntagResource | 准許取消標記 AWS Transfer Family 資源 | 標記 | |||
| UpdateAccess | 准許更新存取權 | 寫入 |
iam:PassRole |
||
| UpdateAgreement | 准許更新協議 | 寫入 |
iam:PassRole |
||
| UpdateCertificate | 准許更新憑證 | 寫入 | |||
| UpdateConnector | 准許更新連接器 | 寫入 |
iam:PassRole |
||
| UpdateHostKey | 准許更新主機金鑰 | 寫入 | |||
| UpdateProfile | 准許更新設定檔 | 寫入 | |||
| UpdateServer | 准許更新伺服器的組態 | 寫入 |
iam:PassRole |
||
| UpdateUser | 准許更新使用者的組態 | 寫入 |
iam:PassRole |
||
| UpdateWebApp | 准許更新 webapp 的組態 | 寫入 |
iam:PassRole |
||
| UpdateWebAppCustomization | 准許更新 webapp 縮減的組態 | 寫入 |
iam:PassRole |
AWS Transfer 系列定義的資源類型
此服務會定義下列資源類型，並可用在 IAM 許可政策陳述式的 Resource 元素中。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型資料表。
| 資源類型 | ARN | 條件索引鍵 |
|---|---|---|
| user |
arn:${Partition}:transfer:${Region}:${Account}:user/${ServerId}/${UserName}
|
|
| server |
arn:${Partition}:transfer:${Region}:${Account}:server/${ServerId}
|
|
| workflow |
arn:${Partition}:transfer:${Region}:${Account}:workflow/${WorkflowId}
|
|
| certificate |
arn:${Partition}:transfer:${Region}:${Account}:certificate/${CertificateId}
|
|
| connector |
arn:${Partition}:transfer:${Region}:${Account}:connector/${ConnectorId}
|
|
| profile |
arn:${Partition}:transfer:${Region}:${Account}:profile/${ProfileId}
|
|
| agreement |
arn:${Partition}:transfer:${Region}:${Account}:agreement/${ServerId}/${AgreementId}
|
|
| host-key |
arn:${Partition}:transfer:${Region}:${Account}:host-key/${ServerId}/${HostKeyId}
|
|
| webapp |
arn:${Partition}:transfer:${Region}:${Account}:webapp/${WebAppId}
|
AWS Transfer 系列的條件索引鍵
AWS Transfer Family 定義了下列條件索引鍵，可用於 IAM 政策的 Condition元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。
若要檢視所有 服務可用的全域條件索引鍵，請參閱AWS 全域條件內容索引鍵。
| 條件索引鍵 | 描述 | 類型 |
|---|---|---|
| aws:RequestTag/${TagKey} | 依要求中傳遞的標籤來篩選存取權 | 字串 |
| aws:ResourceTag/${TagKey} | 依與資源關聯的標籤來篩選存取權 | 字串 |
| aws:TagKeys | 依要求中傳遞的標籤索引鍵來篩選存取權 | ArrayOfString |
| transfer:RequestConnectorProtocol | 依請求中傳遞的連接器通訊協定篩選存取權 | String |
| transfer:RequestServerDomain | 依請求中傳遞的儲存網域篩選存取權 | String |
| transfer:RequestServerEndpointType | 依請求中傳遞的端點類型篩選存取權 | String |
| transfer:RequestServerProtocols | 依請求中傳遞的伺服器通訊協定篩選存取權 | ArrayOfString |
