DescribeEnsNetSaleDistrict - ENS - Alibaba Cloud Documentation Center

Queries the information about ISPs and number of ISPs in an area.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters


Parameter	Type	Required	Example	Description
Version	String	Yes	2017-11-10	The version number.
Action	String	Yes	DescribeEnsNetSaleDistrict	The operation that you want to perform. Set the value to DescribeEnsNetSaleDistrict.
NetLevelCode	String	Yes	Big	The area level. Valid values: Big: area Middle: province Small: city
NetDistrictCode	String	No	100105	The area code. If you do not specify this parameter, only nodes under the area level that is specified by NetLevelCode are queried. If you specify this parameter, only child nodes in the area that is specified by NetDistrictCode are queried.

Response parameters


Parameter	Type	Example	Description
Code	Integer	0	The returned service code. A value of 0 indicates that the operation was successful.
EnsNetDistricts	Array of EnsNetDistrict		The information about the ISPs in the area.
EnsNetDistrict
EnsRegionIdCount	String	{ "count":2, "name":"China Telecom", "code":"telecom", "country":"cn" }	The information about the ISP.
InstanceCount	String	{ "count":2, "code":"multiCarrier" }	The information about the instance.
NetDistrictCode	String	100101	The area code.
NetDistrictEnName	String	northEast	The name of the area.
NetDistrictFatherCode	String	100000	The parent code of the area.
NetDistrictLevel	String	Big	The area level. Valid values: Big: area Middle: province Small: city
NetDistrictName	String	Northeast China	The name of the area.
RequestId	String	1707B55C-A12F-43EF-BC66-14FFDB9253C3	The ID of the request.

Examples

Sample requests

http(s)://ens.aliyuncs.com/?Action=DescribeEnsNetSaleDistrict
&Version=2017-11-10
&NetLevelCode=Big
&NetDistrictCode=100105
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeEnsNetDistrictResponse>
<EnsNetDistricts>
    <EnsNetDistrict>
        <InstanceCount>
            <count>1</count>
            <code>cmcc</code>
        </InstanceCount>
        <InstanceCount>
            <count>3</count>
            <code>telecom</code>
        </InstanceCount>
        <InstanceCount>
            <count>2</count>
            <code>unicom</code>
        </InstanceCount>
        <InstanceCount>
            <count>2</count>
            <code>multiCarrier</code>
        </InstanceCount>
        <NetDistrictCode>100101</NetDistrictCode>
        <NetDistrictFatherCode>100000</NetDistrictFatherCode>
        <NetDistrictLevel>Big</NetDistrictLevel>
        <NetDistrictEnName>northEast</NetDistrictEnName>
        <EnsRegionIdCount>
            <count>2</count>
            <name>China Telecom</name>
            <code>telecom</code>
            <country>cn</country>
        </EnsRegionIdCount>
        <EnsRegionIdCount>
            <count>3</count>
            <name>China Unicom</name>
            <code>unicom</code>
            <country>cn</country>
        </EnsRegionIdCount>
        <EnsRegionIdCount>
            <count>1</count>
            <name>China Mobile</name>
            <code>cmcc</code>
            <country>cn</country>
        </EnsRegionIdCount>
        <NetDistrictName>Northeast China</NetDistrictName>
    </EnsNetDistrict>
    <EnsNetDistrict>
        <InstanceCount>
            <count>1</count>
            <code>cmcc</code>
        </InstanceCount>
        <InstanceCount>
            <count>1</count>
            <code>telecom</code>
        </InstanceCount>
        <InstanceCount>
            <count>2</count>
            <code>unicom</code>
        </InstanceCount>
        <NetDistrictCode>100107</NetDistrictCode>
        <NetDistrictFatherCode>100000</NetDistrictFatherCode>
        <NetDistrictLevel>Big</NetDistrictLevel>
        <NetDistrictEnName>northWest</NetDistrictEnName>
        <EnsRegionIdCount>
            <count>2</count>
            <name>China Telecom</name>
            <code>telecom</code>
            <country>cn</country>
        </EnsRegionIdCount>
        <EnsRegionIdCount>
            <count>2</count>
            <name>China Unicom</name>
            <code>unicom</code>
            <country>cn</country>
        </EnsRegionIdCount>
        <EnsRegionIdCount>
            <count>1</count>
            <name>China Mobile</name>
            <code>cmcc</code>
            <country>cn</country>
        </EnsRegionIdCount>
        <NetDistrictName>Northwest China</NetDistrictName>
    </EnsNetDistrict>
</EnsNetDistricts>
<RequestId>1707B55C-A12F-43EF-BC66-14FFDB9253C3</RequestId>
<Code>0</Code>
</DescribeEnsNetDistrictResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "EnsNetDistricts" : {
    "EnsNetDistrict" : [ {
      "InstanceCount" : [ {
        "count" : 1,
        "code" : "cmcc"
      }, {
        "count" : 3,
        "code" : "telecom"
      }, {
        "count" : 2,
        "code" : "unicom"
      }, {
        "count" : 2,
        "code" : "multiCarrier"
      } ],
      "NetDistrictCode" : "100101",
      "NetDistrictFatherCode" : "100000",
      "NetDistrictLevel" : "Big",
      "NetDistrictEnName" : "northEast",
      "EnsRegionIdCount" : [ {
        "count" : 2,
        "name": "China Telecom",
        "code" : "telecom",
        "country" : "cn"
      }, {
        "count" : 3,
        "name": "China Unicom",
        "code" : "unicom",
        "country" : "cn"
      }, {
        "count" : 1,
        "name": "China Mobile",
        "code" : "cmcc",
        "country" : "cn"
      } ],
      "NetDistrictName": "Northeast China"
    }, {
      "InstanceCount" : [ {
        "count" : 1,
        "code" : "cmcc"
      }, {
        "count" : 1,
        "code" : "telecom"
      }, {
        "count" : 2,
        "code" : "unicom"
      } ],
      "NetDistrictCode" : "100107",
      "NetDistrictFatherCode" : "100000",
      "NetDistrictLevel" : "Big",
      "NetDistrictEnName" : "northWest",
      "EnsRegionIdCount" : [ {
        "count" : 2,
        "name": "China Telecom",
        "code" : "telecom",
        "country" : "cn"
      }, {
        "count" : 2,
        "name": "China Unicom",
        "code" : "unicom",
        "country" : "cn"
      }, {
        "count" : 1,
        "name": "China Mobile",
        "code" : "cmcc",
        "country" : "cn"
      } ],
      "NetDistrictName": "Northwest China"
    } ]
  },
  "RequestId" : "1707B55C-A12F-43EF-BC66-14FFDB9253C3",
  "Code" : 0
}

Error codes


HTTP status code	Error code	Error message	Description
400	NoPermission	Permission denied.	The error message returned because you do not have the required permissions. Ask the administrator to grant you the permissions.
400	CallInterface	Call Inteface Happen Error.	The error message returned because an error occurred when you call the operation.

For a list of error codes, see Service error codes.