UpdateHypervisor
更新管理程序元数据,包括其主机、用户名和密码。指定要在请求中使用管理程序的 Amazon 资源名称 (ARN) 来更新哪个管理程序。
请求语法
{
"Host": "string
",
"HypervisorArn": "string
",
"LogGroupArn": "string
",
"Name": "string
",
"Password": "string
",
"Username": "string
"
}
请求参数
有关所有操作的通用参数的信息,请参阅常用参数。
请求接受采用 JSON 格式的以下数据。
- Host
-
更新后的管理程序的主机。这可以是 IP 地址或完全限定域名 (FQDN)。
类型:字符串
长度约束:最小长度为 3。最大长度为 128。
模式:
^.+$
必需:否
- HypervisorArn
-
要更新的管理程序的 Amazon 资源名称 (ARN)。
类型:字符串
长度约束:最小长度为 50。最大长度为 500。
模式:
^arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+$
必需:是
- LogGroupArn
-
请求日志中网关组的 Amazon 资源名称 (ARN)。
类型:字符串
长度约束:最小长度为 0。最大长度为 2048。
模式:
^$|^arn:(aws|aws-cn|aws-us-gov):logs:([a-zA-Z0-9-]+):([0-9]+):log-group:[a-zA-Z0-9_\-\/\.]+:\*$
必需:否
- Name
-
更新后的管理程序名称
类型:字符串
长度约束:最小长度为 1。最大长度为 100。
模式:
^[a-zA-Z0-9-]*$
必需:否
- Password
-
更新后的管理程序密码。
类型:字符串
长度约束:最小长度为 1。最大长度为 100。
模式:
^[ -~]+$
必需:否
- Username
-
更新后的管理程序用户名。
类型:字符串
长度约束:最小长度为 1。最大长度为 100。
模式:
^[ -\.0-\[\]-~]*[!-\.0-\[\]-~][ -\.0-\[\]-~]*$
必需:否
响应语法
{
"HypervisorArn": "string"
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
- HypervisorArn
-
您已更新的管理程序的 Amazon 资源名称 (ARN)。
类型:字符串
长度约束:最小长度为 50。最大长度为 500。
模式:
^arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+$
错误
有关所有操作返回的常见错误的信息,请参阅常见错误。
- AccessDeniedException
-
由于您的权限不足,操作无法继续。
HTTP 状态代码:400
- ConflictException
-
由于不支持该操作,因此无法继续操作。
HTTP 状态代码:400
- InternalServerException
-
由于出现内部错误,因此操作未成功。请稍后重试。
HTTP 状态代码:500
- ResourceNotFoundException
-
未找到该操作所需的资源。
HTTP 状态代码:400
- ThrottlingException
-
TPS 已被限制为防止故意或无意的高请求量。
HTTP 状态代码:400
- ValidationException
-
由于出现验证错误,因此操作未成功。
HTTP 状态代码:400
另请参阅
有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: