Note
We’ve renamed Microsoft Cloud App Security. It’s now called Microsoft Defender for Cloud Apps. In the coming weeks, we’ll update the screenshots and instructions here and in related pages. For more information about the change, see this announcement. To learn more about the recent renaming of Microsoft security services, see the Microsoft Ignite Security blog.
Run the GET or POST request to fetch a list of IP ranges matching the specified filters.
HTTP request
HTTP
GET /api/v1/subnet/
HTTP
POST /api/v1/subnet/
Request BODY parameters
| Parameter | Description |
|---|---|
| filters | Filter objects with all the search filters for the request, see IP range filters for more details |
| sortDirection | The sorting direction. Possible values are: asc and desc |
| sortField | Fields used to sort IP ranges. Possible values are: – category: The category of the IP range – tags: The tags of the IP range – name: The name of the IP range |
| skip | Skips the specified number of records |
| limit | Maximum number of records returned by the request |
Example
Request
Here is an example of the request.
HTTP
curl -XPOST -H "Authorization:Token <your_token_key>" "https://<tenant_id>.<tenant_region>.contoso.com/api/v1/subnet/" -d '{
"filters": {
// some filters
},
"skip": 5,
"limit": 10
// ...
}'
Response
Returns a list of IP ranges in JSON format. For information about the response fields, see Properties.
JSON
{
"total": 1 // total number of records
"hasNext": false // whether there is more data to show or not.
"data": [
{
// returned records
"_id": "5fd767259cd24bb563567d7c",
"name": "range name",
"subnets": [
{
"mask": 112,
"address": "0000:0000:0000:0000:0000:ffff:c5c6:0000",
"originalString": "197.198.192.20/16"
}
],
"location": {
"name": "United States",
"latitude": 39.5035514831543,
"longitude": -99.01830291748047,
"countryCode": "US",
"countryName": "United States"
},
"organization": "isp name",
"tags": [
{
"_id": "5ce2aaf42207ad108c76fa3a",
"id": "000000290000000000000000",
"target": 1,
"type": 2,
"name": "Contoso",
"nameTemplate": {
"template": "SAGE_BUILTIN_TAG_CONTOSO_NAME"
},
"description": "IP addresses used by Contoso",
"descriptionTemplate": {
"template": "SAGE_BUILTIN_TAG_CONTOSO_DESCRIPTION"
},
"visibility": 0,
"status": 0,
"_tid": 113348336
}
],
"category": 5,
"lastModified": 1607952165309.8032,
"_tid": 113348336
}
]
}
If you run into any problems, we’re here to help. To get assistance or support for your product issue, please open a support ticket.
Source : Official Microsoft Brand
Editor by : BEST Antivirus KBS Team
(Visited 13 times, 1 visits today)