本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
FailoverShard
用于对分片进行故障转移。此 API 旨在测试发生 MemoryDB 故障转移时您的应用程序的行为。它不是设计用作生产级工具用于启动故障转移以解决集群可能存在的问题。此外,在大型运营活动等特定情况下,Amazon 可能会阻止此 API。
请求语法
{
"ClusterName": "string
",
"ShardName": "string
"
}
请求参数
有关所有操作的通用参数的信息,请参阅通用参数。
请求接受采用 JSON 格式的以下数据。
- ClusterName
-
正在进行故障转移的集群
类型:字符串
必需:是
- ShardName
-
分片的名称
类型:字符串
必需:是
响应语法
{
"Cluster": {
"ACLName": "string",
"ARN": "string",
"AutoMinorVersionUpgrade": boolean,
"AvailabilityMode": "string",
"ClusterEndpoint": {
"Address": "string",
"Port": number
},
"DataTiering": "string",
"Description": "string",
"EnginePatchVersion": "string",
"EngineVersion": "string",
"KmsKeyId": "string",
"MaintenanceWindow": "string",
"Name": "string",
"NodeType": "string",
"NumberOfShards": number,
"ParameterGroupName": "string",
"ParameterGroupStatus": "string",
"PendingUpdates": {
"ACLs": {
"ACLToApply": "string"
},
"Resharding": {
"SlotMigration": {
"ProgressPercentage": number
}
},
"ServiceUpdates": [
{
"ServiceUpdateName": "string",
"Status": "string"
}
]
},
"SecurityGroups": [
{
"SecurityGroupId": "string",
"Status": "string"
}
],
"Shards": [
{
"Name": "string",
"Nodes": [
{
"AvailabilityZone": "string",
"CreateTime": number,
"Endpoint": {
"Address": "string",
"Port": number
},
"Name": "string",
"Status": "string"
}
],
"NumberOfNodes": number,
"Slots": "string",
"Status": "string"
}
],
"SnapshotRetentionLimit": number,
"SnapshotWindow": "string",
"SnsTopicArn": "string",
"SnsTopicStatus": "string",
"Status": "string",
"SubnetGroupName": "string",
"TLSEnabled": boolean
}
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
错误
有关所有操作的常见错误的信息,请参阅常见错误。
- APICallRateForCustomerExceededFault
-
HTTP 状态代码:400
- ClusterNotFoundFault
-
HTTP 状态代码:400
- InvalidClusterStateFault
-
HTTP 状态代码:400
- InvalidKMSKeyFault
-
HTTP 状态代码:400
- InvalidParameterCombinationException
-
HTTP 状态代码:400
- InvalidParameterValueException
-
HTTP 状态代码:400
- ShardNotFoundFault
-
HTTP 状态代码:400
- TestFailoverNotAvailableFault
-
HTTP 状态代码:400
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: