Get a network list
GET https://{{host}}/network-list/v2/network-lists/:networkListId
Gets a network list's most recent syncPoint version.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
extended | string | (Optional) When enabled, provides additional response data identifying who created and updated the list and when, and the network list's deployment status in both STAGING and PRODUCTION environments. This data takes longer to provide. | |
includeElements | string | (Optional) If enabled, the response list includes all items. For large network lists, this may slow responses and yield large response objects. The default true value includes the list's contents. | |
accountSwitchKey | string | (Optional) For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"contractId":"C-0N7RAC71","elementCount":13,"groupId":32145,"links":{"activateInProduction":{"href":"/network-list/v2/network-lists/1024_AMAZONELASTICCOMPUTECLOU/environments/PRODUCTION/activate","method":"POST"},"activateInStaging":{"href":"/network-list/v2/network-lists/1024_AMAZONELASTICCOMPUTECLOU/environments/STAGING/activate","method":"POST"},"appendItems":{"href":"/network-list/v2/network-lists/1024_AMAZONELASTICCOMPUTECLOU/append","method":"POST"},"retrieve":{"href":"/network-list/v2/network-lists/1024_AMAZONELASTICCOMPUTECLOU"},"statusInProduction":{"href":"/network-list/v2/network-lists/1024_AMAZONELASTICCOMPUTECLOU/environments/PRODUCTION/status"},"statusInStaging":{"href":"/network-list/v2/network-lists/1024_AMAZONELASTICCOMPUTECLOU/environments/STAGING/status"},"update":{"href":"/network-list/v2/network-lists/1024_AMAZONELASTICCOMPUTECLOU","method":"PUT"}},"list":["192.0.2.10/24","12.129.0.0/15","12.211.0.0/15","192.0.2.120/24","192.0.2.66/24","12.231.0.0/14","12.235.0.0/14","192.0.2.192/24","192.0.2.24/24","192.0.2.179/24","192.0.2.207/24","192.0.2.129/24","192.0.2.209/24"],"name":"My Network List","networkListType":"networkListResponse","readOnly":true,"shared":true,"syncPoint":65,"type":"IP","uniqueId":"1024_NETWORKLIST"}