動向とお知らせ

製品アップデート情報

製品に関するお知らせ

製品の説明

製品概要

製品の優位性

ユースケース

技術原理

Product Comparison

使用上の制約

Service Regions and Service Providers

購入ガイド

課金概要

課金項目

購入方法

支払い延滞の説明

製品属性の選択

クイックスタート

ドメイン名型CLBクイックスタート

CLBクイックスタート

IPv6 CLBクイックスタート

CentOSにおけるNginxのデプロイ

CentOSにおけるJava Webのデプロイ

操作ガイド

CLBインスタンス

CLBリスナー

バックエンドサーバー

ヘルスチェック

証明書管理

ログ管理

監視アラート

Cloud Access Management

従来型CLB

プラクティスチュートリアル

証明書をCLBに配置（双方向認証）

CLBのGzip有効化設定およびチェック方法の説明

HTTPS転送設定スタートガイド

クライアントリアルIPの取得方法

ロードバランサーのモニタリングアラート設定のベストプラクティス

マルチアベイラビリティーゾーンの高可用性設定の説明

バランシングアルゴリズムの選択と重みの設定の例

CLBのリスニングドメイン名に対してWebセキュリティ保護を実行するようにWAFを設定する

メンテナンスガイド

クライアントのtimewaitが多すぎる場合の対処方法

CLBのHTTPSサービスパフォーマンステスト

ストレステストに関するよくあるご質問

CLB証明書の操作権限に関するご質問

障害処理

UDPヘルスチェックの異常

API リファレンス

History

Introduction

API Category

Instance APIs

Listener APIs

Backend Service APIs

Target Group APIs

Redirection APIs

Other APIs

Classic CLB APIs

Load Balancing APIs

Making API Requests

Data Types

Error Codes

CLB API 2017

よくあるご質問

課金関連

CLB設定関連

ヘルスチェック異常調査

HTTPS関連

WS/WSSプロトコルサポート関連

HTTP/2プロトコルサポート関連

連絡先

用語集

CreateLoadBalancer

PDF

フォーカスモード

フォントサイズ

最終更新日: 2025-11-20 15:22:17

API Description
This API is used to create a CLB instance. To use the CLB service, you first need to purchase one or more instances. After this API call succeeds, a unique instance ID will be returned. There are two types of instances: public network and private network instances. For more information, see the “network types” in CLB Attributes Selection.
Domain name for API calls: lb.api.qcloud.com
Request Parameters
The list below contains only the API request parameters. Common parameters should be added when you call the API. For more information, see Common Request Parameters. The Action field for this API is CreateLoadBalancer.
Parameter
Required
Type
Description
loadBalancerType
No
Int
Network type of the CLB instance.
2: public network; 3: private network.
forward
No
Int
CLB instance type. 1: CLB; 0: Cassic CLB. Default value: 0.
loadBalancerName
No
String
CLB instance name, which takes effect only when an instance is created. Rule: 1-50 letters, Chinese, digits, dashes (-), or underscores (_).
Note: If this name is the same as that of an existing CLB instance, the system will automatically generate a name for this newly created instance.
domainPrefix
No
String
Domain name prefix. The domain name of the CLB instance consists of the user-defined domain prefix and the domain suffix automatically generated by Tencent Cloud to ensure the uniqueness. This field is only applicable to Classic CLB instances.
 Rule: 1-20 lowercase letters, digits or dashes (-). This field is inapplicable to private network CLB.
Note: if this domain name prefix is the same as that of an existing CLB instance, the system will automatically generate a domain name prefix for this newly created instance. For example, you only need to enter the prefix "xxxxx" for xxxxx.region.appId.clb.myqcloud.com.
vpcId
No
String
Network ID of the CLB instance, which can be obtained via the DescribeVpcEx API. If no value or “0” is passed in, the network is Classic Network.
subnetId
No
Int
A subnet ID specified when you purchase a private network CLB instance in a VPC. The VIP of this instance will be generated in the subnet. This parameter can be left empty in other cases.
projectId
No
Int
ID of the project to which a CLB instance belongs, which can be obtained via the DescribeProjects API. If this parameter is not passed in, the default project will be used.
number
No
Int
Number of CLB instances to be created. Default value: 1.
Response Parameters
Parameter
Type
Description
code
Int
Common error code. 0: success; other values: failure. For more information, see Common Error Codes.
message
String
API-related module error message description.
codeDesc
String
Error code. For a successful operation, "Success" is returned. For a failed operation, a message describing the failure is returned.
unLoadBalancerIds
Array
Array of unique CLB instance IDs.
requestId
Int
Task ID.
dealIds
Array
Reserved field.
Example
Purchasing three public network CLB instances with static IPs
https://lb.api.qcloud.com/v2/index.php?Action=CreateLoadBalancer
&<Common request parameters>
&loadBalancerType=2
&number=3
Response
{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "requestId": 3901942,
    "dealIds": [
        "3901942"
    ],
    "unLoadBalancerIds": {
        "3901942": [
            "lb-cjcymkw9",
            "lb-fpk0oxhp",
            "lb-ikpzv02x"
        ]
    }
}
Where, lb-cjcymkw9 is the unique ID of the CLB instance you just purchased. Next, use the DescribeLoadBalancers API to query whether the CLB instance has been successfully created.

ヘルプとサポート

この記事はお役に立ちましたか？

営業担当者にお問い合わせいただくかチケットを提出してサポートを求めることができます。

フィードバック

tencent cloud

Cloud Load Balancer

CreateLoadBalancer

API Description

Request Parameters

Response Parameters

Example

ヘルプとサポート

Parameter	Required	Type	Description
loadBalancerType	No	Int	Network type of the CLB instance. 2: public network; 3: private network.
forward	No	Int	CLB instance type. 1: CLB; 0: Cassic CLB. Default value: 0.
loadBalancerName	No	String	CLB instance name, which takes effect only when an instance is created. Rule: 1-50 letters, Chinese, digits, dashes (-), or underscores (_). Note: If this name is the same as that of an existing CLB instance, the system will automatically generate a name for this newly created instance.
domainPrefix	No	String	Domain name prefix. The domain name of the CLB instance consists of the user-defined domain prefix and the domain suffix automatically generated by Tencent Cloud to ensure the uniqueness. This field is only applicable to Classic CLB instances. Rule: 1-20 lowercase letters, digits or dashes (-). This field is inapplicable to private network CLB. Note: if this domain name prefix is the same as that of an existing CLB instance, the system will automatically generate a domain name prefix for this newly created instance. For example, you only need to enter the prefix "xxxxx" for xxxxx.region.appId.clb.myqcloud.com.
vpcId	No	String	Network ID of the CLB instance, which can be obtained via the DescribeVpcEx API. If no value or “0” is passed in, the network is Classic Network.
subnetId	No	Int	A subnet ID specified when you purchase a private network CLB instance in a VPC. The VIP of this instance will be generated in the subnet. This parameter can be left empty in other cases.
projectId	No	Int	ID of the project to which a CLB instance belongs, which can be obtained via the DescribeProjects API. If this parameter is not passed in, the default project will be used.
number	No	Int	Number of CLB instances to be created. Default value: 1.