文档首页/ 弹性公网IP EIP/ API参考/ API V3/ 带宽/ 查看租户带宽限制
更新时间:2024-04-17 GMT+08:00

查看租户带宽限制

功能介绍

获取弹性公网IP带宽限制列表

URI

GET /v3/{project_id}/eip/eip-bandwidth-limits

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

project_id

表2 Query参数

参数

是否必选

参数类型

描述

limit

Integer

每页条数

最小值:0

最大值:2000

offset

Integer

分页起始点

marker

String

分页起始点

page_reverse

Boolean

翻页方向

fields

Array

只显示指定的字段。使用ext-fields时在默认显示的字段基础上追加字段

枚举值:

  • id
  • charge_mode
  • min_size
  • max_size
  • ext_limit

charge_mode

String

根据charge_mode过滤

请求参数

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

eip_bandwidth_limits

Array of ShowTenantDict objects

带宽限制列表

数组长度:0 - 2000

page_info

PageInfoDict object

分页页码信息

request_id

String

本次请求编号

表4 ShowTenantDict

参数

参数类型

描述

id

String

  • 功能说明:弹性公网IP的唯一标识

最小长度:36

最大长度:36

charge_mode

String

带宽的计费模式

枚举值:

  • bandwidth
  • traffic

min_size

Integer

该类型带宽可购买的最小size

max_size

Integer

该类型带宽可购买的最大size

ext_limit

ExtLimitPojo object

额外限制信息

表5 ExtLimitPojo

参数

参数类型

描述

min_ingress_size

Integer

  • 最小入云限速

max_ingress_size

Integer

  • 最大入云限速

ratio_95peak

Integer

95计费保底率

表6 PageInfoDict

参数

参数类型

描述

previous_marker

String

翻页时,作为前一页的marker取值

next_marker

String

翻页时,作为后一页的marker取值

current_count

Integer

当前页的数据总数

请求示例

查询租户的限制列表,可根据query字段过滤

GET https://{Endpoint}/v3/{project_id}/eip/eip-bandwidth-limits

响应示例

状态码: 200

GET操作正常返回

{
  "request_id" : "4e5945ddd409f306b3cb4fd921a45390",
  "eip_bandwidth_limits" : [ {
    "id" : "08b4700e-cc3c-4aed-a35a-66022bcbd0f6",
    "charge_mode" : "bandwidth",
    "min_size" : 1,
    "max_size" : 500,
    "ext_limit" : null
  }, {
    "id" : "8a6990e6-638c-4a80-9da7-3c1a465ccf59",
    "charge_mode" : "traffic",
    "min_size" : 5,
    "max_size" : 2000,
    "ext_limit" : null
  } ],
  "page_info" : [ {
    "previous_marker" : "08b4700e-cc3c-4aed-a35a-66022bcbd0f6",
    "current_count" : 2
  } ]
}

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
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.eip.v3.region.EipRegion;
import com.huaweicloud.sdk.eip.v3.*;
import com.huaweicloud.sdk.eip.v3.model.*;

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

public class ListBandwidthsLimitSolution {

    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 BasicCredentials()
                .withAk(ak)
                .withSk(sk);

        EipClient client = EipClient.newBuilder()
                .withCredential(auth)
                .withRegion(EipRegion.valueOf("<YOUR REGION>"))
                .build();
        ListBandwidthsLimitRequest request = new ListBandwidthsLimitRequest();
        request.withLimit(<limit>);
        request.withOffset(<offset>);
        request.withMarker("<marker>");
        request.withPageReverse(<page_reverse>);
        request.withFields();
        request.withChargeMode("<charge_mode>");
        try {
            ListBandwidthsLimitResponse response = client.listBandwidthsLimit(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
# coding: utf-8

from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkeip.v3.region.eip_region import EipRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkeip.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 = BasicCredentials(ak, sk) \

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

    try:
        request = ListBandwidthsLimitRequest()
        request.limit = <limit>
        request.offset = <offset>
        request.marker = "<marker>"
        request.page_reverse = <PageReverse>
        request.fields = 
        request.charge_mode = "<charge_mode>"
        response = client.list_bandwidths_limit(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
package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    eip "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/eip/v3"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/eip/v3/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/eip/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 := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        Build()

    client := eip.NewEipClient(
        eip.EipClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ListBandwidthsLimitRequest{}
	limitRequest:= int32(<limit>)
	request.Limit = &limitRequest
	offsetRequest:= int32(<offset>)
	request.Offset = &offsetRequest
	markerRequest:= "<marker>"
	request.Marker = &markerRequest
	pageReverseRequest:= <page_reverse>
	request.PageReverse = &pageReverseRequest
	chargeModeRequest:= "<charge_mode>"
	request.ChargeMode = &chargeModeRequest
	response, err := client.ListBandwidthsLimit(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

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

状态码

状态码

描述

200

GET操作正常返回

错误码

请参见错误码