文档首页> 云连接 CC> API参考> API> 全域互联带宽> 创建全域互联带宽

更新时间：2024-03-29 GMT+08:00

在线调试

CLI示例

查看PDF

创建全域互联带宽

功能介绍

创建全域互联带宽。

调用方法

请参见如何调用API。

URI

POST /v3/{domain_id}/gcb/gcbandwidths

表1 路径参数
参数	是否必选	参数类型	描述
domain_id	是	String	账户ID。最小长度：10 最大长度：32

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	否	String	用户Token。最小长度：0 最大长度：2000000

表3 请求Body参数
参数	是否必选	参数类型	描述
globalconnection_bandwidth	是	CreateGlobalConnectionBandwidth object	创建全域互联带宽实例的详细信息。

表4 CreateGlobalConnectionBandwidth
参数	是否必选	参数类型	描述
name	是	String	实例名字。
description	否	String	实例描述。不支持 <>。最小长度：0 最大长度：255
bordercross	是	Boolean	功能说明：全域互联带宽是否跨境，判断依据：带宽是否涉及从中国大陆到其他国家。取值范围：True：跨境；False：非跨境
type	是	String	功能说明：描述带宽类型，对应地理区间的城域、区域、大区、跨区四级： TrsArea: 跨区带宽 Area: 大区带宽 SubArea: 区域带宽 Region: 城域带宽
enterprise_project_id	否	String	实例所属企业项目ID。最小长度：1 最大长度：36
tags	否	Array of Tag objects	实例标签。数组长度：1 - 20
charge_mode	是	String	功能说明：描述计费类型，描述可选计费类型。默认开放按带宽计费，传统95计费租户白名单控制。取值范围： bwd: 按带宽计费 95: 按传统型95计费
size	是	Integer	功能说明：全域互联带宽实例中的带宽值大小，单位Mbit/s。取值范围：2-300Mbit/s 最小值：2 最大值：300
sla_level	否	String	功能说明：描述网络等级，从高到低分为铂金、金、银。默认金，其余租户白名单控制。 Pt: 铂金 Au: 金 Ag: 银缺省值：Au 最小长度：1 最大长度：36
local_area	否	String	功能说明：本端接入点，配合remote_area信息描述带宽实例应用的范围。取值范围：1-64个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点），站点编码通过接口获取，带宽类型为Region可不传，其他类型必传最小长度：1 最大长度：36
remote_area	否	String	功能说明：远端接入点，配合local_area信息描述带宽实例应用的范围。取值范围：1-64个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点），站点编码通过接口获取，带宽类型为Region可不传，其他类型必传最小长度：1 最大长度：36
spec_code_id	否	String	功能说明：线路规格编码UUID。最小长度：1 最大长度：36

表5 Tag
参数	是否必选	参数类型	描述
key	是	String	标签键，最大长度128个unicode字符，格式为大小写字母，数字，中划线“-”，下划线“_”，中文。
value	否	String	标签值，最大长度255个unicode字符，格式为大小写字母，数字，中划线“-”，下划线“_”，点“.”，中文。

响应参数

状态码： 201

表6 响应Body参数
参数	参数类型	描述
request_id	String	资源ID标识符。最小长度：32 最大长度：36
globalconnection_bandwidth	GlobalConnectionBandwidth object	全域互联带宽实例的详细信息。

表7 GlobalConnectionBandwidth
参数	参数类型	描述
id	String	资源ID标识符。
name	String	实例名字。
description	String	实例描述。不支持 <>。最小长度：0 最大长度：255
domain_id	String	实例所属账号ID。
bordercross	Boolean	功能说明：全域互联带宽是否跨境，判断依据：带宽是否涉及从中国大陆到其他国家。取值范围：True：跨境；False：非跨境
type	String	功能说明：描述带宽类型，对应地理区间的城域、区域、大区、跨区四级： TrsArea: 跨区带宽 Area: 大区带宽 SubArea: 区域带宽 Region: 城域带宽
binding_service	String	功能说明：绑定的服务类型。实例类型： CC: 云连接 GEIP: 全域弹性公网IP GCN: 中心网络 GSN: 分支网络 ALL: 所有实例类型
enterprise_project_id	String	实例所属企业项目ID。最小长度：1 最大长度：36
charge_mode	String	功能说明：描述计费类型，描述可选计费类型。默认开放按带宽计费，传统95计费租户白名单控制。取值范围： bwd: 按带宽计费 95: 按传统型95计费
size	Integer	功能说明：全域互联带宽实例中的带宽值大小，单位Mbit/s。取值范围：2-300Mbit/s 最小值：2 最大值：300
sla_level	String	功能说明：描述网络等级，从高到低分为铂金、金、银。默认金，其余租户白名单控制。 Pt: 铂金 Au: 金 Ag: 银缺省值：Au 最小长度：1 最大长度：36
local_area	String	功能说明：本端接入点的中英文名。通过HEADER里面的x-language控制，默认英文，zh-cn返回中文。最小长度：1 最大长度：36
remote_area	String	功能说明：远端接入点的中英文名。通过HEADER里面的x-language控制，默认英文，zh-cn返回中文。最小长度：1 最大长度：36
local_site_code	String	功能说明：本端接入点的编码。最小长度：1 最大长度：36
remote_site_code	String	功能说明：远端接入点的编码。最小长度：1 最大长度：36
admin_state	String	功能说明: 全域互联带宽状态。取值范围： NORMAL-正常 FREEZED-冻结状态
frozen	Boolean	功能说明: 全域互联带宽是否冻结。取值范围： true-冻结 false-非冻结
spec_code_id	String	功能说明：线路规格编码UUID。最小长度：1 最大长度：36
tags	Array of Tag objects	实例标签。数组长度：1 - 20
created_at	String	实例创建时间。UTC时间格式，yyyy-MM-ddTHH:mm:ss。
updated_at	String	实例更新时间。UTC时间格式，yyyy-MM-ddTHH:mm:ss。
enable_share	Boolean	功能说明: 全域互联带宽是否支持绑定多实例。取值范围： true-支持 false-不支持
instances	Array of GlobalConnectionBandwidthAssociatedInstance objects	功能说明: 全域互联带宽绑定实例列表。数组长度：0 - 200

表8 Tag
参数	参数类型	描述
key	String	标签键，最大长度128个unicode字符，格式为大小写字母，数字，中划线“-”，下划线“_”，中文。
value	String	标签值，最大长度255个unicode字符，格式为大小写字母，数字，中划线“-”，下划线“_”，点“.”，中文。

表9 GlobalConnectionBandwidthAssociatedInstance
参数	参数类型	描述
id	String	绑定实例ID。最小长度：0 最大长度：36
type	String	绑定实例类型。最小长度：0 最大长度：36
region_id	String	绑定实例的region信息，global服务默认取值"global"。最小长度：0 最大长度：36
project_id	String	绑定实例的project id信息。最小长度：0 最大长度：36

请求示例

创建城域带宽

POST https://{cc_endpoint}/v3/{domain_id}/gcb/gcbandwidths

{
  "globalconnection_bandwidth" : {
    "name" : "test_region",
    "description" : "Description",
    "bordercross" : false,
    "type" : "Region",
    "charge_mode" : "bwd",
    "size" : 5
  }
}

创建大区带宽

POST https://{cc_endpoint}/v3/{domain_id}/gcb/gcbandwidth

{
  "globalconnection_bandwidth" : {
    "name" : "test_area",
    "description" : "Description",
    "bordercross" : false,
    "type" : "Area",
    "charge_mode" : "bwd",
    "size" : 5,
    "local_area" : "cn-north-beijing4",
    "remote_area" : "cn-south-guangzhou"
  }
}

响应示例

状态码： 201

创建全域互联带宽成功。

{
  "request_id" : "1b90e4762e3090961a30ca3a712dc0ed",
  "globalconnection_bandwidth" : {
    "id" : "a3bad420-33b8-4e26-9e9b-bdf67aa8e72b",
    "name" : "name",
    "description" : "description",
    "domain_id" : "521bb3d98bed4c6c9ee8669bd0620f76",
    "bordercross" : false,
    "type" : "Region",
    "binding_service" : "CC",
    "enterprise_project_id" : "0c478f9e-73a4-4c45-b9bc-b2c3bfc0d4c0",
    "charge_mode" : "bwd",
    "size" : 100,
    "sla_level" : "Au",
    "local_site_code" : "cn-south-guangzhou",
    "remote_site_code" : "cn-north-beijing4",
    "frozen" : false,
    "spec_code_id" : "",
    "tags" : [ ],
    "created_at" : "2024-01-24T08:26:41.914Z",
    "updated_at" : "2024-01-24T08:26:41.914Z",
    "enable_share" : false,
    "instances" : [ ]
  }
}

SDK代码示例

SDK代码示例如下。

创建城域带宽

        
         
           
           
             package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.GlobalCredentials;
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.cc.v3.region.CcRegion;
import com.huaweicloud.sdk.cc.v3.*;
import com.huaweicloud.sdk.cc.v3.model.*;


public class CreateGlobalConnectionBandwidthSolution {

    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");

        ICredential auth = new GlobalCredentials()
                .withAk(ak)
                .withSk(sk);

        CcClient client = CcClient.newBuilder()
                .withCredential(auth)
                .withRegion(CcRegion.valueOf("<YOUR REGION>"))
                .build();
        CreateGlobalConnectionBandwidthRequest request = new CreateGlobalConnectionBandwidthRequest();
        CreateGlobalConnectionBandwidthRequestBody body = new CreateGlobalConnectionBandwidthRequestBody();
        CreateGlobalConnectionBandwidth globalconnectionBandwidthbody = new CreateGlobalConnectionBandwidth();
        globalconnectionBandwidthbody.withSize(5)
            .withName("test_region")
            .withDescription("Description")
            .withChargeMode(CreateGlobalConnectionBandwidth.ChargeModeEnum.fromValue("bwd"))
            .withType(CreateGlobalConnectionBandwidth.TypeEnum.fromValue("Region"))
            .withBordercross(false);
        body.withGlobalconnectionBandwidth(globalconnectionBandwidthbody);
        request.withBody(body);
        try {
            CreateGlobalConnectionBandwidthResponse response = client.createGlobalConnectionBandwidth(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());
        }
    }
}

            

          

        
       

创建大区带宽

        
         
           
           
             package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.GlobalCredentials;
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.cc.v3.region.CcRegion;
import com.huaweicloud.sdk.cc.v3.*;
import com.huaweicloud.sdk.cc.v3.model.*;


public class CreateGlobalConnectionBandwidthSolution {

    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");

        ICredential auth = new GlobalCredentials()
                .withAk(ak)
                .withSk(sk);

        CcClient client = CcClient.newBuilder()
                .withCredential(auth)
                .withRegion(CcRegion.valueOf("<YOUR REGION>"))
                .build();
        CreateGlobalConnectionBandwidthRequest request = new CreateGlobalConnectionBandwidthRequest();
        CreateGlobalConnectionBandwidthRequestBody body = new CreateGlobalConnectionBandwidthRequestBody();
        CreateGlobalConnectionBandwidth globalconnectionBandwidthbody = new CreateGlobalConnectionBandwidth();
        globalconnectionBandwidthbody.withSize(5)
            .withName("test_area")
            .withDescription("Description")
            .withChargeMode(CreateGlobalConnectionBandwidth.ChargeModeEnum.fromValue("bwd"))
            .withType(CreateGlobalConnectionBandwidth.TypeEnum.fromValue("Area"))
            .withBordercross(false)
            .withLocalArea("cn-north-beijing4")
            .withRemoteArea("cn-south-guangzhou");
        body.withGlobalconnectionBandwidth(globalconnectionBandwidthbody);
        request.withBody(body);
        try {
            CreateGlobalConnectionBandwidthResponse response = client.createGlobalConnectionBandwidth(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());
        }
    }
}

            

          

        
       

创建城域带宽

        
         
           
           
             # coding: utf-8

from huaweicloudsdkcore.auth.credentials import GlobalCredentials
from huaweicloudsdkcc.v3.region.cc_region import CcRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkcc.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 = __import__('os').getenv("CLOUD_SDK_AK")
    sk = __import__('os').getenv("CLOUD_SDK_SK")

    credentials = GlobalCredentials(ak, sk) \

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

    try:
        request = CreateGlobalConnectionBandwidthRequest()
        globalconnectionBandwidthbody = CreateGlobalConnectionBandwidth(
            size=5,
            name="test_region",
            description="Description",
            charge_mode="bwd",
            type="Region",
            bordercross=False
        )
        request.body = CreateGlobalConnectionBandwidthRequestBody(
            globalconnection_bandwidth=globalconnectionBandwidthbody
        )
        response = client.create_global_connection_bandwidth(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

            

          

        
       

创建大区带宽

        
         
           
           
             # coding: utf-8

from huaweicloudsdkcore.auth.credentials import GlobalCredentials
from huaweicloudsdkcc.v3.region.cc_region import CcRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkcc.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 = __import__('os').getenv("CLOUD_SDK_AK")
    sk = __import__('os').getenv("CLOUD_SDK_SK")

    credentials = GlobalCredentials(ak, sk) \

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

    try:
        request = CreateGlobalConnectionBandwidthRequest()
        globalconnectionBandwidthbody = CreateGlobalConnectionBandwidth(
            size=5,
            name="test_area",
            description="Description",
            charge_mode="bwd",
            type="Area",
            bordercross=False,
            local_area="cn-north-beijing4",
            remote_area="cn-south-guangzhou"
        )
        request.body = CreateGlobalConnectionBandwidthRequestBody(
            globalconnection_bandwidth=globalconnectionBandwidthbody
        )
        response = client.create_global_connection_bandwidth(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

            

          

        
       

创建城域带宽

        
         
           
           
             package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/global"
    cc "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cc/v3"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cc/v3/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cc/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")

    auth := global.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        Build()

    client := cc.NewCcClient(
        cc.CcClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.CreateGlobalConnectionBandwidthRequest{}
	descriptionGlobalconnectionBandwidth:= "Description"
	globalconnectionBandwidthbody := &model.CreateGlobalConnectionBandwidth{
		Size: int32(5),
		Name: "test_region",
		Description: &descriptionGlobalconnectionBandwidth,
		ChargeMode: model.GetCreateGlobalConnectionBandwidthChargeModeEnum().BWD,
		Type: model.GetCreateGlobalConnectionBandwidthTypeEnum().REGION,
		Bordercross: false,
	}
	request.Body = &model.CreateGlobalConnectionBandwidthRequestBody{
		GlobalconnectionBandwidth: globalconnectionBandwidthbody,
	}
	response, err := client.CreateGlobalConnectionBandwidth(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

            

          

        
       

创建大区带宽

        
         
           
           
             package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/global"
    cc "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cc/v3"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cc/v3/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cc/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")

    auth := global.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        Build()

    client := cc.NewCcClient(
        cc.CcClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.CreateGlobalConnectionBandwidthRequest{}
	descriptionGlobalconnectionBandwidth:= "Description"
	localAreaGlobalconnectionBandwidth:= "cn-north-beijing4"
	remoteAreaGlobalconnectionBandwidth:= "cn-south-guangzhou"
	globalconnectionBandwidthbody := &model.CreateGlobalConnectionBandwidth{
		Size: int32(5),
		Name: "test_area",
		Description: &descriptionGlobalconnectionBandwidth,
		ChargeMode: model.GetCreateGlobalConnectionBandwidthChargeModeEnum().BWD,
		Type: model.GetCreateGlobalConnectionBandwidthTypeEnum().AREA,
		Bordercross: false,
		LocalArea: &localAreaGlobalconnectionBandwidth,
		RemoteArea: &remoteAreaGlobalconnectionBandwidth,
	}
	request.Body = &model.CreateGlobalConnectionBandwidthRequestBody{
		GlobalconnectionBandwidth: globalconnectionBandwidthbody,
	}
	response, err := client.CreateGlobalConnectionBandwidth(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

            

          

        
       

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

状态码

状态码	描述
201	创建全域互联带宽成功。

错误码

请参见错误码。

父主题：全域互联带宽

上一篇：查询全域互联带宽列表

下一篇：查询全域互联带宽详情

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

创建全域互联带宽

功能介绍

调用方法

URI

请求参数

响应参数

请求示例

响应示例

SDK代码示例

状态码

错误码

相关文档

相关产品

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线