本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
StopServer
将启用文件传输协议的服务器的状态从更改ONLINE
为OFFLINE
。OFFLINE
服务器无法接受和处理文件传输作业。与服务器相关的信息,例如服务器和用户属性,不会因停止服务器而受到影响。
停止服务器不会减少或影响您的文件传输协议终端节点账单;您必须删除服务器才能停止计费。
的状态STOPPING
表示服务器处于中间状态,要么无法完全响应,要么未完全脱机。的值STOP_FAILED
可以表示错误情况。
此调用未返回任何响应。
请求语法
{
"ServerId": "string
"
}
请求参数
有关所有操作的Common Parameters (常用参数) 有关由所有操作共享的参数的详细信息。
请求接受采用 JSON 格式的以下数据。
- ServerId
-
服务器的系统分配的唯一标识符。
类型:字符串
长度限制:固定长度为 19。
模式:
^s-([0-9a-f]{17})$
必需:是
响应元素
如果此操作成功,则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。
错误
有关所有操作常见错误的信息,请参阅常见错误。
- InternalServiceError
-
当 Transfer Family 服务中发生错误时,会Amazon引发此异常。
HTTP 状态代码:500
- InvalidRequestException
-
当客户端提交格式错误的请求时,会引发此异常。
HTTP 状态代码:400
- ResourceNotFoundException
-
当 Transfer Family 服务找不到资源时,会Amazon引发此异常。
HTTP 状态代码:400
- ServiceUnavailableException
-
由于 Transfer FamAmazon ily 服务不可用,请求失败。
HTTP 状态代码:500
- ThrottlingException
-
由于请求限制而导致请求被拒绝。
HTTP 状态代码:400
示例
示例
以下示例停止服务器。
示例请求
{
"ServerId": "s-01234567890abcdef"
}
示例
这是此 API 调用的示例响应。
示例响应
{
"ServerId": "s-01234567890abcdef"
}
另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: