描述
用户可以调用这个接口购买数据同步实例,实例购买成功后,需要调用配置同步实例的接口进行实例配置。
如果同步实例为按量付费实例,那么只有调用配置接口,且成功启动实例后,才会开始计费。
请求参数
参数名称 | 数据类型 | 是否必须 | 参数说明 |
---|---|---|---|
Action | String | 是 | 系统默认参数,这个接口的接口定义,取值为:CreateSynchronizationJob |
SourceRegion | String | 是 | 同步源实例所在的地域,取值包括: cn-hangzhou : 公有云杭州 cn-shanghai: 公有云上海 cn-qingdao : 公有云青岛 cn-beijing : 公有云北京 cn-zhangbei: 公有云张北 cn-shenzhen:公有云深圳 cn-hongkong:公有云中国(香港) ap-southeat-1:公有云新加坡 us-west-1:公有云美西 us-east-1:公有云美东 me-east-1: 公有云迪拜 eu-central-1:公有云法兰克福 cn-hangzhou-finance: 金融云杭州 cn-qingdao-finance:金融云青岛 cn-shanghai-finance:金融云上海 cn-shenzhen-finance:金融云深圳 |
SourceEndpoint.InstanceType | String | 否 | 同步链路的源实例类型,取值: MySQL:MySQL数据库。 PolarDB:POLARDB for MySQL集群。 Redis:Redis数据库。 默认取值为MySQL。 |
Topology | String | 否 | 同步拓扑,取值包括:oneway、bidirectional,默认取值为:oneway,只有MySQL-> MySQL同步,此参数才能接收取值 bidirectional |
DestinationRegion | String | 是 | 同步目标实例所在的区域,取值包括: cn-hangzhou : 公有云杭州 cn-shanghai: 公有云上海 cn-qingdao : 公有云青岛 cn-beijing : 公有云北京 cn-zhangbei: 公有云张北 cn-shenzhen:公有云深圳 cn-hongkong:公有云中国(香港) ap-southeat-1:公有云新加坡 us-west-1:公有云美西 us-east-1:公有云美东 me-east-1: 公有云迪拜 eu-central-1:公有云法兰克福 cn-hangzhou-finance: 金融云杭州 cn-qingdao-finance:金融云青岛 cn-shanghai-finance:金融云上海 cn-shenzhen-finance:金融云深圳 |
DestinationEndpoint.InstanceType | String | 否 | 同步链路的目标实例类型,取值: MySQL:MySQL数据库。 PolarDB:POLARDB for MySQL集群。 Redis:Redis数据库。 MaxCompute:MaxCompute实例。 默认取值为MySQL。 |
NetworkType | String | 否 | 当进行跨地域同步时,使用的数据传输网络类型。取值包括:Internet、Intranet。默认取值为:Internet |
SynchronizationJobClass | String | 是 | 同步实例规格,取值包括:micro、small、medium、large,默认取值为:small |
PayType | String | 是 | 付费类型,取值包括: Postpaid : 后付费类型,Prepaid:预付费类型 |
Period | String | 否 | 如果付费类型为预付费,那么这个参数指定购买实例为包年实例还是包月实例,取值包括: Year : 包年, Month: 包月 |
UsedTime | String | 否 | 如果付费类型为预付费,那么这个参数为购买的时长(月数),可按需传入1,2,3 等参数 |
ClientToken | String | 否 | 任意字符串,用于保证请求幂等性 |
OwnerId | String | 否 | 非服务化虚商接入时,指定资源的owner |
返回参数
参数名称 | 数据类型 | 参数说明 |
---|---|---|
SynchronizationJobId | String | 同步实例ID,唯一识别这个同步实例 |
示例
下面简单演示通过JAVA SDK 购买同步实例的示例:
public class DataSyncTest {
public String createSyncJob(DefaultAcsClient client) {
CreateSynchronizationJobRequest request = new CreateSynchronizationJobRequest();
request.setSourceRegion("cn-hangzhou");
request.setDestRegion("cn-hangzhou");
request.setSynchronizationJobClass("micro");
request.setPayType("Postpaid");
request.setClientToken("createsyncjob_1");
CreateSynchronizationJobResponse response = new CreateSynchronizationJobResponse();
try {
response = client.getAcsResponse(request);
String DataSyncId = response.getSynchronizationJobId();
System.out.println("Create Synchronization Job Succeed! Synchronization Job Id is "+DataSyncId);
return DataSyncId;
} catch (Exception e) {
// TODO: handle exception
System.out.println("Create Synchronization Job Failed!");
return null;
}
}
原创文章,作者:网友投稿,如若转载,请注明出处:https://www.cloudads.cn/archives/33380.html