更新时间:2025-02-25 GMT+08:00

复制已有负载均衡器

功能介绍

复制已有的负载均衡器实例。

调用方法

请参见如何调用API

URI

POST /v3/{project_id}/elb/loadbalancers/{loadbalancer_id}/clone

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

负载均衡器所在的项目ID。

loadbalancer_id

String

负载均衡器ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:IAM鉴权Token。

表3 请求Body参数

参数

是否必选

参数类型

描述

count

Integer

参数解释:单次最大复制数量。

取值范围:1-10

默认取值:1

target_loadbalancer_param

TargetLoadbalancerParam object

新实例相关配置参数。

表4 TargetLoadbalancerParam

参数

是否必选

参数类型

描述

name

String

新实例名称。

可选,不选时使用源负载均衡器名称加copy-x的后缀作为新实例名称。

availability_zone_list

Array of strings

新实例所属可用区。

可选,不选时使用源负载均衡器的可用区。

只在独享型复制场景可配置。

vip_subnet_cidr_id

String

新实例所属子网的ipv4子网id。

可选,不选时使用源负载均衡器的ipv4子网。

所选子网需要与源负载均衡器在同一个vpc内。

vip_address

String

新实例的ipv4私网地址。

可选,不选时随机分配。

只在独享型复制场景、共享型复制为独享型场景可配。

ipv6_vip_virsubnet_id

String

新实例ipv6网络所属的子网网络id。

可选,不选时使用源负载均衡器的子网。

所选子网需要与源负载均衡器在同一个vpc内。

只在独享型复制场景可配。

ipv6_vip_address

String

新实例的ipv6地址。

可选,不选时随机分配。

只在独享型复制场景可配。

elb_virsubnet_ids

Array of strings

新实例后端子网的网络id。

可选,不选时使用源负载均衡器的后端子网。

所选子网需要与源负载均衡器在同一个vpc内。

只在独享型复制场景、共享型复制为独享型场景可配。

l4_flavor_id

String

新实例4层规格。

可选,不选时使用源负载均衡器的4层规格。

只在独享型复制场景、共享型复制为独享型场景可配。

l7_flavor_id

String

新实例7层规格。

可选,不选时使用源负载均衡器的7层规格。

只在独享型复制场景、共享型复制为独享型场景可配。

enterprise_project_id

String

新实例所属企业项目。

可选,不选时使用源负载均衡器的企业项目

reuse_pool

Boolean

新实例是否复用源ELB的后端服务器组和后端服务器标识。

可选,配置为true时需要开启后端服务器组多实例挂载功能。

不选时默认新创建后端服务器组。

enterprise_project_id选项配置使用其他企业项目时,该选项失效。

只在独享型复制场景、共享型复制为独享型场景可配。

guaranteed

Boolean

新实例类型。

可选配置。

独享型复制场景默认为true,若显式指定,只能配置为true。

共享型复制场景默认为false,若显式指定,配置为false表示新复制共享型实例,配置为true表示新复制独享型实例。

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

loadbalancer_list

Array of loadbalancer_list objects

新实例相关信息

request_id

String

请求id

job_id

String

实例复制任务id

表6 loadbalancer_list

参数

参数类型

描述

id

String

新实例id

请求示例

复制已有负载均衡器实例。

POST https://{ELB_Endpoint}/v3/{project_id}/elb/loadbalancers/{loadbalancer_id}/clone

{
  "target_loadbalancer_param" : {
    "availability_zone_list" : [ "az1", "az2" ],
    "vip_address" : "1.1.1.1",
    "guaranteed" : true
  }
}

响应示例

状态码:200

操作正常返回。

{
  "loadbalancer_list" : [ {
    "id" : "00ac869a-16f2-4335-b40a-15f277604f18"
  } ],
  "request_id" : "53013c36-751b-4687-9819-cc0bb609468c",
  "job_id" : "3ccae6c1-615c-48b4-82b5-abfcdcb82849"
}

SDK代码示例

SDK代码示例如下。

复制已有负载均衡器实例。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.elb.v3.region.ElbRegion;
import com.huaweicloud.sdk.elb.v3.*;
import com.huaweicloud.sdk.elb.v3.model.*;

import java.util.List;
import java.util.ArrayList;

public class CloneLoadbalancerSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        ElbClient client = ElbClient.newBuilder()
                .withCredential(auth)
                .withRegion(ElbRegion.valueOf("<YOUR REGION>"))
                .build();
        CloneLoadbalancerRequest request = new CloneLoadbalancerRequest();
        request.withLoadbalancerId("{loadbalancer_id}");
        CloneLoadbalancerRequestBody body = new CloneLoadbalancerRequestBody();
        List<String> listTargetLoadbalancerParamAvailabilityZoneList = new ArrayList<>();
        listTargetLoadbalancerParamAvailabilityZoneList.add("az1");
        listTargetLoadbalancerParamAvailabilityZoneList.add("az2");
        TargetLoadbalancerParam targetLoadbalancerParambody = new TargetLoadbalancerParam();
        targetLoadbalancerParambody.withAvailabilityZoneList(listTargetLoadbalancerParamAvailabilityZoneList)
            .withVipAddress("1.1.1.1")
            .withGuaranteed(true);
        body.withTargetLoadbalancerParam(targetLoadbalancerParambody);
        request.withBody(body);
        try {
            CloneLoadbalancerResponse response = client.cloneLoadbalancer(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

复制已有负载均衡器实例。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
# coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkelb.v3.region.elb_region import ElbRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkelb.v3 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = ElbClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(ElbRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = CloneLoadbalancerRequest()
        request.loadbalancer_id = "{loadbalancer_id}"
        listAvailabilityZoneListTargetLoadbalancerParam = [
            "az1",
            "az2"
        ]
        targetLoadbalancerParambody = TargetLoadbalancerParam(
            availability_zone_list=listAvailabilityZoneListTargetLoadbalancerParam,
            vip_address="1.1.1.1",
            guaranteed=True
        )
        request.body = CloneLoadbalancerRequestBody(
            target_loadbalancer_param=targetLoadbalancerParambody
        )
        response = client.clone_loadbalancer(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

复制已有负载均衡器实例。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    elb "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/elb/v3"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/elb/v3/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/elb/v3/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := elb.NewElbClient(
        elb.ElbClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.CloneLoadbalancerRequest{}
	request.LoadbalancerId = "{loadbalancer_id}"
	var listAvailabilityZoneListTargetLoadbalancerParam = []string{
        "az1",
	    "az2",
    }
	vipAddressTargetLoadbalancerParam:= "1.1.1.1"
	guaranteedTargetLoadbalancerParam:= true
	targetLoadbalancerParambody := &model.TargetLoadbalancerParam{
		AvailabilityZoneList: &listAvailabilityZoneListTargetLoadbalancerParam,
		VipAddress: &vipAddressTargetLoadbalancerParam,
		Guaranteed: &guaranteedTargetLoadbalancerParam,
	}
	request.Body = &model.CloneLoadbalancerRequestBody{
		TargetLoadbalancerParam: targetLoadbalancerParambody,
	}
	response, err := client.CloneLoadbalancer(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

更多编程语言的SDK代码示例,请参见API Explorer的代码示例页签,可生成自动对应的SDK代码示例。

状态码

状态码

描述

200

操作正常返回。

错误码

请参见错误码