调用CreateGlobalDistributeCache将一个存量的Redis实例转换为分布式实例中第一个子实例。
分布式实例不支持直接创建,您需要调用本接口指定一个已有的Redis实例转换为分布式实例中第一个子实例,转换完成后,子实例所属的分布式实例即被创建成功。
待转换的实例需满足下述要求:
- 待转换的实例为企业版(性能增强型)。
- 待转换的实例为标准架构或集群架构。
- 待转换的实例为集群架构时,需关闭直连模式,详情请参见释放直连地址。
说明 您也可以调用
CreateInstance新购一个Redis实例,该实例将作为分布式实例中的第一个子实例,子实例创建完成后,子实例所属的分布式实例即被创建成功。
CreateInstance新购一个Redis实例,该实例将作为分布式实例中的第一个子实例,子实例创建完成后,子实例所属的分布式实例即被创建成功。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateGlobalDistributeCache |
系统规定参数,取值:CreateGlobalDistributeCache。 |
SeedSubInstanceId | String | 是 | r-bp1zxszhcgatnx**** |
待转换的实例ID。 |
RegionId | String | 否 | cn-hangzhou |
待转换的实例所属的地域。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
GlobalInstanceId | String | gr-bp14rkqrhac**** |
分布式实例ID。 |
RequestId | String | E681E498-5A0D-44F2-B1A7-912DC3****** |
请求ID。 |
示例
请求示例
https://r-kvstore.aliyuncs.com/?Action=CreateGlobalDistributeCache
&SeedSubInstanceId=r-bp1zxszhcgatnx****
&<公共请求参数>
正常返回示例
XML
格式
<CreateGlobalDistributeCacheResponse>
<GlobalInstanceId>gr-bp14rkqrhac****</GlobalInstanceId>
<RequestId>E681E498-5A0D-44F2-B1A7-912DC3******</RequestId>
</CreateGlobalDistributeCacheResponse>
JSON
格式
{
"GlobalInstanceId":"gr-bp14rkqrhac****",
"RequestId": "E681E498-5A0D-44F2-B1A7-912DC3******"
}
错误码
访问错误中心查看更多错误码。