Getting a network by ID

Note

The pps_limit_percentage and bw_limit_percentage attributes are only present if the organisation has percentage thresholds enabled.

Note

SOC accounts must instead address an organisation explicitly through the /organisations/{organisation}/networks endpoint.

Sends a GET request to the endpoint /networks/{network}.

Description

The Get-Network request returns a single network for a specified ID.

Requirements

Values of the request: Network ID {network}

Objects: none

Request

To request a single network, add the Network ID {network} to the path of the request.

As a result, the user gets an object NetworkVO with the requested information.

The object provides the following information:

Attributes	Description	Values
`id`	The ID of the network.	`string`
`organisation`	The associated organisation.	`object`
`name`	The name of the network.	`string`
`cidr`	The CIDR range of the network.	`string`
`enabled`	Defines whether automatic mitigation is enabled.	`true` `false`
`mitigation_type`	The mitigation type of the network.	`ACTION_BLACKHOLE` `ACTION_MITIGATE_ONPREM` `ACTION_MITIGATE_CLOUD`
`auto_mitigation_strategy`	The automatic mitigation strategy of the network.	`string`
`duration`	The duration of the automatic mitigation.	`integer`
`pps_limit`	The configured PPS limit.	`integer`
`bw_limit`	The configured bandwidth limit.	`integer`
`autoStatus`	Defines whether an automatic mitigation is currently running for the network.	`true` `false`
`manualStatus`	Defines whether a manual mitigation is currently running for the network.	`true` `false`
`active_partial_manual_mitigations`	The active partial manual mitigations.	`array`
`active_partial_auto_mitigations`	The active partial automatic mitigations.	`array`
`allow_manual_mitigation`	Shows whether manual mitigations can be started for the network.	`true` `false`
`extra`	Additional custom fields of the organisation.	`object`

Example

Example response:

{
  "id": "xY9pQ5wR1",
  "organisation": {
    "id": "aB3cD4eF5",
    "name": "ACME GmbH"
  },
  "name": "Customer-A-Prod",
  "cidr": "192.0.2.0/24",
  "enabled": true,
  "mitigation_type": "ACTION_BLACKHOLE",
  "auto_mitigation_strategy": "IP",
  "duration": 0,
  "pps_limit": 0,
  "bw_limit": 0,
  "autoStatus": true,
  "manualStatus": true,
  "active_partial_manual_mitigations": [
    {}
  ],
  "active_partial_auto_mitigations": [
    {}
  ],
  "allow_manual_mitigation": true,
  "extra": {}
}

Responses

The following responses are available:

STATUS CODE	DESCRIPTION
200	The request has succeeded.
401	The request has not succeeded because the user authentication was incorrect.
403	The request has not succeeded because the user does not have the right permissions.