Retrieve all Network Security Groups

GET

https://nico-rest-api.nico.svc.cluster.local/v2/org/:org/nico/network-security-group

GET

/v2/org/:org/nico/network-security-group

$ curl https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/network-security-group \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

1 [
2   {
3     "id": "3f8a1b2e-7c4d-4f9a-9b2e-1a2b3c4d5e6f",
4     "name": "Corporate Data Center Firewall",
5     "description": "Network security group for corporate data center instances",
6     "siteId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
7     "tenantId": "123e4567-e89b-12d3-a456-426614174000",
8     "status": "Ready",
9     "statusHistory": [
10       {
11         "status": "Pending",
12         "message": "Request received, pending processing",
13         "created": "2024-01-10T08:00:00Z",
14         "updated": "2024-01-10T08:00:00Z"
15       },
16       {
17         "status": "Provisioning",
18         "message": "Provisioning network security group resources",
19         "created": "2024-01-11T10:15:00Z",
20         "updated": "2024-01-11T10:15:00Z"
21       },
22       {
23         "status": "Ready",
24         "message": "Network security group is active and ready",
25         "created": "2024-01-12T14:30:00Z",
26         "updated": "2024-01-12T14:30:00Z"
27       }
28     ],
29     "statefulEgress": true,
30     "rules": [
31       {
32         "direction": "INGRESS",
33         "protocol": "TCP",
34         "action": "PERMIT",
35         "sourcePrefix": "10.0.0.0/16",
36         "destinationPrefix": "10.0.1.0/24",
37         "name": "allow-https-from-internal",
38         "sourcePortRange": "443",
39         "destinationPortRange": "443",
40         "priority": 10
41       },
42       {
43         "direction": "EGRESS",
44         "protocol": "ANY",
45         "action": "DENY",
46         "sourcePrefix": "10.0.1.0/24",
47         "destinationPrefix": "0.0.0.0/0",
48         "name": "deny-all-egress",
49         "sourcePortRange": null,
50         "destinationPortRange": null,
51         "priority": 100
52       }
53     ],
54     "ruleCount": 2,
55     "attachmentStats": {
56       "inUse": true,
57       "directVpcAttachmentCount": 2,
58       "directInstanceAttachmentCount": 5,
59       "totalDirectAttachmentCount": 7
60     },
61     "labels": {
62       "environment": "production",
63       "department": "IT Security"
64     },
65     "created": "2024-01-10T07:45:00Z",
66     "updated": "2024-01-12T14:30:00Z"
67   }
68 ]

Get all Network Security Groups for Tenant

Org must have a Tenant entity. User must have authorization role with TENANT_ADMIN suffix.

Authentication

AuthorizationBearer

export JWT_BEARER_TOKEN="<jwt-bearer-token>"
# Example org name: "acme-inc
export ORG_NAME=<org-name>
# Use the JWT bearer token in your API request auth header:
curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current

``` export JWT_BEARER_TOKEN="<jwt-bearer-token>" # Example org name: "acme-inc export ORG_NAME=<org-name> # Use the JWT bearer token in your API request auth header: curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current ```

Path parameters

orgstringRequired

Name of the Org

Query parameters

siteIdstringOptionalformat: "uuid"

Filter By Site ID

statusstringOptional

Filter Network Security Groups by Status

querystringOptional

Search for matches across all Network Security Groups. Input will be matched against name, description, and status fields

includeRelationenumOptional

Related entity to expand

Allowed values:

pageNumberintegerOptional>=1Defaults to 1

Page number for pagination query

pageSizeintegerOptional1-100

Page size for pagination query

orderByenumOptional

Ordering for pagination query

includeAttachmentStatsbooleanOptional

Include counts for the number objects that have attached the Network Security Group

Response headers

Response

idstring

Unique UUID v4 identifier for the Network Security Group

namestring2-256 characters

Name of the Network Security Group

descriptionstring or null

Description of the Network Security Group

siteIdstringformat: "uuid"

ID of the Site

tenantIdstringformat: "uuid"

ID of the Tenant

statusenum

Status of the Network Security Group

statusHistorylist of objects

Chronological status history for the Network Security Group

statefulEgressboolean

StatefulEgress defines whether a Network Security Group's egress rules will be automatically stateful

ruleslist of objects

Rules that belong to the Network Security Group

ruleCountinteger

Number of rules in the Network Security Group

attachmentStatsobject

Attachment statistics for the Network Security Group. Returned when the includeAttachmentStats query parameter is set to true in retrieval endpoints.

labelsmap from strings to strings

Set of labels/tags for the Network Security Group

createddatetime

Date/time when the Network Security Group was created

updateddatetime

Date/time when the Network Security Group was last updated

Errors

400

Bad Request Error

403

Forbidden Error

412

Precondition Failed Error

500

Internal Server Error

501

Not Implemented Error