本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
TestConnection
测试您的 SFTP 连接器是否设置成功。我们强烈建议您调用此操作来测试您在本地 Amazon 存储和贸易伙伴的 SFTP 服务器之间传输文件的能力。
请求语法
{
"ConnectorId": "string"
}请求参数
有关所有操作的通用参数的信息，请参阅通用参数。
请求接受采用 JSON 格式的以下数据。
- ConnectorId
-
连接器的唯一标识符。
类型：字符串
长度限制：固定长度为 19。
模式：
c-([0-9a-f]{17})必需：是
响应语法
{
"ConnectorId": "string",
"Status": "string",
"StatusMessage": "string"
}响应元素
如果此操作成功，则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
- ConnectorId
-
返回您正在测试的连接器对象的标识符。
类型：字符串
长度限制：固定长度为 19。
模式：
c-([0-9a-f]{17}) - Status
-
如果测试成功，则会返回
OK，如果测试失败，则会返回ERROR。类型：字符串
- StatusMessage
-
如果测试成功，则返回
Connection succeeded。或者，如果测试失败，则返回描述性错误消息。以下列表根据您收到的错误消息提供了疑难解答的详细信息。-
确认您的密钥名称与传输角色权限中的密钥名称一致。
-
验证连接器配置中的服务器 URL，并验证登录凭据在连接器之外是否成功运行。
-
验证密钥是否存在且格式正确。
-
验证连接器配置中的可信主机密钥是否与
ssh-keyscan输出相匹配。
类型：字符串
-
错误
有关所有操作返回的常见错误的信息，请参阅 常见错误。
- InternalServiceError
-
当 Amazon Transfer Family 服务中发生错误时，会引发此异常。
HTTP 状态代码：500
- InvalidRequestException
-
当客户端提交格式错误的请求时，会引发此异常。
HTTP 状态代码：400
- ResourceNotFoundException
-
当 Transfer Family 服务找不到资源时，就会 Amazon引发此异常。
HTTP 状态代码：400
- ServiceUnavailableException
-
请求失败，因为 Trans Amazon fer Family 服务不可用。
HTTP 状态代码：500
示例
示例
以下示例测试与远程服务器的连接。
aws transfer test-connection --connector-id c-abcd1234567890fff
示例响应
如果成功，API 调用将返回以下详细信息。
{ "Status": "OK", "StatusMessage": "Connection succeeded" }
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息，请参阅以下内容：