華為云計算 云知識 查詢配額接口ListQuotas
查詢配額接口ListQuotas

 

功能介紹

查詢單租戶在VPC服務(wù)下的網(wǎng)絡(luò)資源配額,包括vpc配額、子網(wǎng)配額、安全組配額、安全組規(guī)則配額、EIP配額, vpn 配額等。

EIP與VPC共用本接口,可在本接口中查詢EIP配額。

調(diào)試

您可以在API Explorer中調(diào)試該接口,支持自動認證鑒權(quán)。API Explorer可以自動生成SDK代碼示例,并提供SDK代碼示例調(diào)試功能。

URI

GET /v1/{project_id}/quotas

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項目ID,獲取項目ID請參見獲取項目ID

最小長度:0

最大長度:32

表2 Query參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

type

String

  • 功能說明:根據(jù)type過濾查詢指定類型的配額

  • 取值范圍:

    • vpc

    • subnet

    • securityGroup

    • securityGroupRule

    • publicIp

    • vpn

    • vpcPeer

    • loadbalancer

    • listener

    • physicalConnect

    • virtualInterface

    • firewall

    • shareBandwidthIP

    • shareBandwidth

    • address_group

    • flow_log

    • vpcContainRoutetable

    • routetableContainRoutes

最小長度:0

最大長度:64

請求參數(shù)

響應(yīng)參數(shù)

狀態(tài)碼: 200

表3 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

quotas

ResourceResp object

資源配額對象

表4 ResourceResp

參數(shù)

參數(shù)類型

描述

resources

Array of QuotaShowResp objects

資源配額對象

數(shù)組長度:0 - 999

表5 QuotaShowResp

參數(shù)

參數(shù)類型

描述

type

String

  • 功能說明:根據(jù)type過濾查詢指定類型的配額

  • 取值范圍:

    • vpc

    • subnet

    • securityGroup

    • securityGroupRule

    • publicIp

    • vpn

    • vpcPeer

    • loadbalancer

    • listener

    • physicalConnect

    • virtualInterface

    • firewall

    • shareBandwidthIP

    • shareBandwidth

    • address_group

    • flow_log

    • vpcContainRoutetable

    • routetableContainRoutes

最小長度:0

最大長度:36

used

Integer

  • 功能說明:已創(chuàng)建的資源個數(shù)

  • 取值范圍:0~quota數(shù)

最小值:0

最大值:999999

quota

Integer

  • 功能說明:資源的最大配額數(shù)

  • 取值范圍:各類型資源默認配額數(shù)~Integer最大值

  • 約束:資源的默認配額數(shù)可以修改,而且配額需要提前在底層配置 參考默認配置為:

    • vpc默認5

    • 子網(wǎng)默認400

    • 安全組默認100

    • 安全組規(guī)則默認5000

    • EIP默認10

    • vpn默認5

    • vpcPeer默認50

    • loadbalancer默認10

    • listener默認10

    • physicalConnect默認10

    • virtualInterface默認50

    • firewall默認200

    • shareBandwidth默認5

    • shareBandwidthIP默認10

    • address_group默認10

    • flow_log默認10

    • vpcContainRoutetable默認1

    • routetableContainRoutes默認200

最小值:-1

最大值:999999

min

Integer

  • 功能說明:允許修改的配額最小值

最小值:0

最大值:999999

請求示例

查詢EIP配額。

GET https://{Endpoint}/v1/{project_id}/quotas?type=publicIp

響應(yīng)示例

狀態(tài)碼: 200

GET和PUT操作正常返回

{
  "quotas" : {
    "resources" : [ {
      "type" : "vpc",
      "used" : 4,
      "quota" : 150,
      "min" : 0
    }, {
      "type" : "securityGroup",
      "used" : 1,
      "quota" : 400,
      "min" : 0
    }, {
      "type" : "securityGroupRule",
      "used" : 6,
      "quota" : 5000,
      "min" : 0
    }, {
      "type" : "publicIp",
      "used" : 2,
      "quota" : 10,
      "min" : 0
    } ]
  }
}

狀態(tài)碼

狀態(tài)碼

描述

200

GET和PUT操作正常返回

錯誤碼

請參見錯誤碼。