使用QueryNetList API查詢代播網段列表-DDoS防護-阿里雲

查詢代播的網段列表。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ddosdiversion:QueryNetList

get

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
SaleId	string	否	代播執行個體的 ID。	ddos_diversion_public_cn-xxxxxxxxxxxxx
Net	string	否	代播執行個體的網段。說明代播執行個體沒有擴充網段時，表示執行個體的網段。代播執行個體有擴充網段時，表示擴充的網段，與 MainNet 參數配合使用。	192.168.XX.XX/24
Mode	string	否	調度模式。取值： manual : 人工。 netflow-auto：netflow 自動調度。枚舉值： netflow-auto : netflow-auto manual : manual	netflow-auto
MainNet	string	否	具有擴充網段的代播執行個體的主網段。如果查詢的代播執行個體沒有擴充網段，此參數為空白。	192.168.XX.XX/22
Page	integer	否	頁碼。預設值：1。	1
Num	integer	否	數量。預設值：100。	100

返回參數

名稱	類型	描述	樣本值
	object
Code	integer	介面返回碼： 200：表示成功。其它：表示錯誤碼。	200
RequestId	string	本次調用請求的 ID，是由阿里雲為該請求產生的唯一識別碼，可用於排查和定位問題。	24B652B5-AEFF-3F03-9114-00D053C42277
Message	string	返回資訊。	successful
Data	object	網段列表。
Total	integer	網段總數量。	10
Page	integer	當前頁碼。	1
Num	integer	每頁展示的網段數量。取值範圍：1~100，預設值為 100。	100
Nets	array<object>	網段列表。
	array<object>
UserId	string	使用者識別碼。	57690941xxxxxxxx
SaleId	string	代播執行個體的 ID。	ddos_diversion_public_cn-xxxxxxxxxxxxx
UpstreamType	string	回注類型。枚舉值： aliyun_line：阿里雲專線。 pccw_line：合作專線（pccw）。 gre_line：GRE 專線。 private_line：私人專線。	aliyun_line
Net	string	代播執行個體的網段。	192.168.XX.XX/24
NetType	string	網段類型。	ipv4
Mode	string	代播啟動模式。枚舉值： netflow-auto：NetFlow 自動。 manual：手動。	manual
DeclaredState	integer	牽引狀態。枚舉值： 0：未牽引。 1：牽引中。	0
Declared	array<object>	地區牽引狀態。
	object
Region	string	牽引地區。枚舉值： oe26：香港。 us50：美東。 oe24：美西。 oe28：新加坡。 jp141：日本。 gb145：英國。 oi39：德國。	oe26
Declared	string	地區牽引狀態。枚舉值： 0：未牽引。 1：牽引中。	0
GmtCreate	string	添加時間。	2024-09-05 13:52:50
GmtModify	string	修改時間。	2024-09-05 13:59:55
NetExtend	string	是否需要擴充。枚舉值： 0：不擴充。 1：擴充。	0
DDoSDefense	object	防護配置。
DjPolicy	object	防護模板。
PolicyName	string	模板名稱。	gf_origin_xxxxx
CleanTh	object	清洗閾值。
Mbps	integer	每秒頻寬清洗閾值。單位：Mbps。	0
Pps	integer	每秒報文數清洗閾值。單位：Pps。	0
HoleTh	object	黑洞閾值。
ThreshMbps	integer	黑洞閾值。單位：Mbps。0 代表全力防護。	0
FwdEffect	integer	轉寄生效狀態。枚舉值： 0：未生效。 1：生效中。	1
NetMain	string	子網段展示，主網段預設為空白字串。	192.168.XX.XX/22
Permit	integer	審核狀態。枚舉值： 0：未審核。 1：已審核。 2：審核中。	2

樣本

正常返回樣本

JSON格式

{
  "Code": 200,
  "RequestId": "24B652B5-AEFF-3F03-9114-00D053C42277",
  "Message": "successful",
  "Data": {
    "Total": 10,
    "Page": 1,
    "Num": 100,
    "Nets": [
      {
        "UserId": "57690941xxxxxxxx",
        "SaleId": "ddos_diversion_public_cn-xxxxxxxxxxxxx",
        "UpstreamType": "aliyun_line",
        "Net": "192.168.XX.XX/24",
        "NetType": "ipv4",
        "Mode": "manual",
        "DeclaredState": 0,
        "Declared": [
          {
            "Region": "oe26",
            "Declared": "0"
          }
        ],
        "GmtCreate": "2024-09-05 13:52:50",
        "GmtModify": "2024-09-05 13:59:55",
        "NetExtend": "0",
        "DDoSDefense": {
          "DjPolicy": {
            "PolicyName": "gf_origin_xxxxx"
          },
          "CleanTh": {
            "Mbps": 0,
            "Pps": 0
          },
          "HoleTh": {
            "ThreshMbps": 0
          }
        },
        "FwdEffect": 1,
        "NetMain": "192.168.XX.XX/22",
        "Permit": 2
      }
    ]
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	AuthenticationFailed	User authentication failed.	使用者認證失敗。
400	AutoScheduleRuleExist	The auto schedule rule already exists.	調度規則已存在。
400	AutoScheduleRuleNotExist	The auto schedule rule dose not exist.	調度規則不存在。
400	BlackHoleConfigurationError	A black hole configuration error occurred.	黑洞配置錯誤。
400	CleanConfigurationError	A clean configuration error occurred.	清洗配置錯誤。
400	CoveredNet	The CIDR block is overwritten.	網段被其他網段覆蓋。
400	DatabaseError	A database error.	資料庫錯誤。
400	DeclaredNet	The CIDR block has been advertised.	網段處於宣告狀態。
400	DefenseConfigurationError	A defense configuration error occurred.	防護配置錯誤。
400	ForwardConfigurationNotExist	The CIDR block forwarding configuration is not found.	網段轉寄配置不存在。
400	ForwardNotExist	The CIDR block zone forwarding configuration is not found.	網段可用性區域轉寄配置不存在。
400	ForwardRuleNotExist	The CIDR block forwarding rule is not found.	網段轉寄規則不存在。
400	HttpFailed	HTTP request failed.	HTTP 要求失敗。
400	IDNSubnetsCountLimit	The maximum number of IDCs of the instance is exceeded.	執行個體的IDC數量達到上限
400	InstanceExist	The instance already exists.	執行個體已經存在。
400	InstanceNetConfigurationExist	The instance CIDR block configuration already exists.	執行個體網段配置已存在。
400	InstanceNotExist	The instance is not found.	執行個體不存在。
400	InstanceUpstreamLimit	The maximum number of reinjection configurations for the instance is exceeded.	執行個體的回注配置數量受限。
400	InternalError	An internal error occurred.	內部錯誤。
400	InvalidNet	Invalid CIDR block.	網段不合法。
400	InvalidParam	Invalid parameter value.	參數非法。
400	IPSubnetsCountLimit	The maximum number of CIDR blocks of the instance is exceeded.	執行個體的網段數量達到上限。
400	NetCannotExtend	The CIDR block cannot be extended.	網段不能被擴容。
400	NetConfigurationExist	The CIDR block configuration already exists.	網段配置已存在。
400	NetConfigurationNotExist	The CIDR block configuration is not found.	網段配置不存在。
400	NetForwardDelete	The CIDR block forwarding is being deleted.	網段轉寄刪除中。
400	NetMaskOutOfRange	The subnet mask of the CIDR block is invalid.	網段掩碼超出範圍。
400	NetNeedExtend	The CIDR block needs to be extended.	網段需要擴容。
400	NetStatusNotReady	The CIDR block reinjection configuration has not been completed.	網段回注配置未完成
400	NetworkDeclearedFailed	Failed to advertise the CIDR block.	網段宣告失敗。
400	NetWorkNotExist	The CIDR block is not found.	網段不存在。
400	NetworkUndeclearedFailed	Failed to cancel the advertisement of the CIDR block.	網段解除宣告失敗。
400	ParameterNotEnough	Required parameters are not specified.	必填參數缺失。
400	ParameterOutOfRange	Invalid parameter value.	參數超出指定取值範圍
400	RegionNotExist	The region does not exist.	可用性區域不存在。
400	RequestMethodError	An incorrect request method.	請求方式錯誤。
400	SubnetCountLimit	The maximum number of subnets is exceeded.	子網數量達到上限。
400	UnKnownError	An unknown error occurred.	未知錯誤。
400	UpsteamNotComplete	The reinjection configuration has not been completed.	網段回注配置未完成。
400	UpstreamConfigurationNotExist	The reinjection configuration is not found.	回注配置不存在。
400	JsonDecodeError	JSON string decoding failed.	JSON字串轉JSON對象失敗。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。