StopServer - Amazon Transfer Family
请求语法请求参数响应元素错误示例另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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 的更多信息，请参阅以下内容：