本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
CreateClusterSnapshot
创建弹性集群的快照。
请求语法
POST /cluster-snapshot HTTP/1.1
Content-type: application/json
{
"clusterArn": "string
",
"snapshotName": "string
",
"tags": {
"string
" : "string
"
}
}
URI 请求参数
该请求不使用任何 URI 参数。
请求体
请求接受采用 JSON 格式的以下数据。
- clusterArn
-
您想要创建其快照的弹性集群的 ARN 标识符。
类型:字符串
必需:是
- snapshotName
-
新的弹性集群快照的名称。
类型:字符串
长度限制:最小长度为 1。最大长度为 63。
必需:是
-
要分配给新的弹性集群快照的标签。
类型:字符串到字符串映射
密钥长度限制:最小长度为 1。长度上限为 128。
键模式:
^(?!aws:)[a-zA-Z+-=._:/]+$
值长度限制:最小长度为 0。最大长度为 256。
必需:否
响应语法
HTTP/1.1 200
Content-type: application/json
{
"snapshot": {
"adminUserName": "string",
"clusterArn": "string",
"clusterCreationTime": "string",
"kmsKeyId": "string",
"snapshotArn": "string",
"snapshotCreationTime": "string",
"snapshotName": "string",
"snapshotType": "string",
"status": "string",
"subnetIds": [ "string" ],
"vpcSecurityGroupIds": [ "string" ]
}
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
- snapshot
-
返回有关新的弹性集群快照的信息。
类型:ClusterSnapshot 对象
错误
有关所有操作的常见错误的信息,请参阅常见错误。
- AccessDeniedException
-
没有足够权限执行某操作时出现的异常。
HTTP 状态代码:403
- ConflictException
-
存在访问冲突。
HTTP 状态代码:409
- InternalServerException
-
出现内部服务器错误。
HTTP 状态代码:500
- ResourceNotFoundException
-
不能定位指定的资源。
HTTP 状态代码:404
- ServiceQuotaExceededException
-
已超过该操作的服务限额。
HTTP 状态代码:402
- ThrottlingException
-
因请求节流拒绝请求时,将抛出 throttlingException。
HTTP 状态代码:429
- ValidationException
-
定义验证异常的结构。
HTTP 状态代码:400
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: