Introduction

Welcome! This is the API reference for the NetFoundry Network Management Service (v2), a lexicon of all possible API operations and their parameters. More conceptually and procedurally oriented guides and code samples may be found by visiting the Developer Portal.

Overview

HTTP verbs

NetFoundry adheres closely to standard HTTP and REST conventions in its use of HTTP verbs.

Verb Usage

GET

Used to retrieve a resource

POST

Used to create a new resource

PUT

Used to update an existing resource, full updates only

PATCH

Used to update an existing resource, partial updates

DELETE

Used to delete an existing resource

HTTP status codes

NetFoundry adheres closely to standard HTTP and REST conventions in its use of HTTP status codes.

Status code Usage

200 OK

The actual response will depend on the request method used. In a GET request, the response will contain an entity corresponding to the requested resource. In a POST request, the response will contain an entity describing or containing the result of the action.

201 Created

The request has been fulfilled and resulted in a new resource being created.

202 Accepted

The request has been accepted and is being processed asynchronously Standard response for successful HTTP requests which invoke back-end services.

204 No Content

The server successfully processed the request, but is not returning any content.

400 Bad Request

The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing).

401 Unauthorized

The request lacks valid authentication credentials for the target resource.

403 Forbidden

The request is authenticated with valid credentials however that set of credentials is not authorized to access this resource.

404 Not Found

The requested resource could not be found but may be available again in the future. Subsequent requests by the client are permissible.

Pagination

Paginated services will accept the following optional request parameters:

Table 1. Request parameters
Path Type Optional Description

page

Integer

true

Page you want to retrieve, 0 indexed and defaults to 0.

size

Integer

true

Size of the page you want to retrieve, defaults to 1000.

sort

String

true

Properties that should be sorted by in the format property,property(,ASC|DESC). Default sort direction is ascending. Use multiple sort parameters if you want to switch directions, e.g. ?sort=firstname&sort=lastname,asc.

Pagination response has following structure:

Table 2. Response structure
Path Type Optional Description

content

Array[Object]

false

Actual items.

totalElements

Integer

false

Total count.

totalPages

Integer

false

Total pages with current page size.

last

Boolean

false

If this page is the last one.

numberOfElements

Integer

false

Actual size of content array (number of items).

first

Boolean

false

If this page is the first one.

sort

Object

true

Sort information object.

size

Integer

false

Requested size of the page.

number

Integer

false

Page number.

empty

booloean

false

If this page is empty.

Authentication

Authentication is delegated to an identity provider e.g. Cognito, Auth0, Okta. Use your API account credential to obtain an access token. Know more by reading the Authentication Guide.

Cognito

Follow this example if your authentication URL is for Amazon Cognito.

NETFOUNDRY_API_TOKEN=$( \ (1)
  curl --user ${NETFOUNDRY_CLIENT_ID}:${NETFOUNDRY_PASSWORD} \ (2)
    --request POST ${NETFOUNDRY_OAUTH_URL} \ (3)
    --header 'content-type: application/x-www-form-urlencoded' \
    --data 'grant_type=client_credentials&scope=https%3A%2F%2Fgateway.production.netfoundry.io%2F%2Fignore-scope' | \
      jq -r .access_token (4)
)
1 creates an environment variable NETFOUNDRY_API_TOKEN to hold the token after successful request. The contents of this variable will be used in all subsequent requests
2 substitute the client ID and password for your API account
3 substitute the authentication URL for your API account
4 extract the access token with jq (command-line JSON processor)

Auth0

Follow this example if your authentication URL is for Auth0.

NETFOUNDRY_API_TOKEN=$( \(1)
  curl \(2)
    --request POST \
    --silent \
    --show-error \
    --header 'content-type: application/json' \
    --data '{
        "client_id":"---redacted----",       (3)
        "client_secret": "---redacted----",  (4)
        "audience":"https://gateway.production.netfoundry.io/",
        "grant_type":"client_credentials"
    }' \
    https://netfoundry-production.auth0.com/oauth/token |\
    jq -r .access_token \(5)
) && echo $NETFOUNDRY_API_TOKEN (6)
1 creates an environment variable NETFOUNDRY_API_TOKEN to hold the token after successful request. The contents of this variable will be used in all subsequent requests
2 this example uses the cURL command to perform the request
3 you will need to insert your actual client ID
4 you will need to insert your actual secret
5 this example uses jq to parse the response from Auth0 and extract the token
6 this line prints the extracted token; it is included for convenience / debugging purposes only

API request using access token

Execute an http request per the example below (e.g. fetch networks). The access token is presented to the API via the Authorization header, which in turn leverages the NETFOUNDRY_API_TOKEN variable used in the previous example to store the extracted access token.

# get networks
curl https://gateway.production.netfoundry.io/core/v2/networks \ (1)
    --header "Authorization: Bearer ${NETFOUNDRY_API_TOKEN}"     (2)
1 the URL used to fetch networks (see also [Listing networks])
2 the Authorization header transmits the Bearer token

Resources

Data Centers

Find Data Centers

GET /data-centers

Authorization

This endpoint requires read action on the data-center resource type.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

hostType

String

true

Must be one of [NC, ER].

productVersion

String

true

provider

String

true

Must be one of [AWS, AZURE, GCP, ALICLOUD, NetFoundry, OCP].

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

id

String

true

address

String

true

city

String

true

stateCode

String

true

stateName

String

true

continentName

String

true

continentCode

String

true

countryName

String

true

countryCode

String

true

isp

String

true

lat

Decimal

true

lng

Decimal

true

locationCode

String

true

locationName

String

true

provider

String

true

Must be one of [AWS, AZURE, GCP, ALICLOUD, NetFoundry, OCP].

Path Optional Description

self

false

network

false

Embedded resources

Path Type Optional Description

id

String

true

address

String

true

city

String

true

stateCode

String

true

stateName

String

true

continentName

String

true

continentCode

String

true

countryName

String

true

countryCode

String

true

isp

String

true

lat

Decimal

true

lng

Decimal

true

locationCode

String

true

locationName

String

true

provider

String

true

Must be one of [AWS, AZURE, GCP, ALICLOUD, NetFoundry, OCP].

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/data-centers' -i -X GET \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJRZHpncDhBQVpzUXpaYkszcGp6SzJRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjRlYTU0NjE3LTNiZjktNDRlMS05YjhiLTA4MGZiZGM5ZWM5ZCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgxMywiZXhwIjoxNjA2ODMzNDEzLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjAwYzM0MDExLTg3NTMtNDgzNC1iYmMwLTA1NjVhMmYyZmExYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgxM31dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.S_4dxuoKPFDceWk4-2y6q3a61FLVlgPYe95sEKt3Vj5rJrVtbUmlQYGzq8QznSXsux8S5VSMeoYesA6p0jinxHKhULUc2hlYFg5A8uiOp5PTPwnDzc8AE3-6SIVaU7onPicXVAnMTjafFR0XZNjn7cdR4cfhbmS75b8JGqCKNY7OOaqmjJ-tAAeyxDNWWxgchEpm9dDmegAH725aw15_a0YQdvYZ4fVhKrqoyIahK-cHiUOqbhGW-PcRjtXMiu7zlscK8aOuYgvmWJoypTi5ncOcMCZmZImRDMITe2itSyzHHMBG9_3lha0F4tiAcpujhgyWVHpcK6FogWCKcD9vwQ'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 872

{
  "_embedded" : {
    "dataCenters" : [ {
      "id" : "1141280d-9f88-4a3e-834d-5d345564ac6d",
      "address" : null,
      "city" : null,
      "stateCode" : null,
      "stateName" : null,
      "continentName" : null,
      "continentCode" : null,
      "countryName" : null,
      "countryCode" : null,
      "isp" : null,
      "lat" : null,
      "lng" : null,
      "locationCode" : "us-east4-a",
      "locationName" : null,
      "provider" : "GCP",
      "_links" : {
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/data-centers/1141280d-9f88-4a3e-834d-5d345564ac6d"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/data-centers"
    }
  },
  "page" : {
    "size" : 2000,
    "totalElements" : 1,
    "totalPages" : 1,
    "number" : 0
  }
}

Network Configurations

Find Network Config Metadata

GET /network-configs

Authorization

This endpoint requires read action on the data-center resource type.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

name

String

true

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

id

String

true

name

String

true

awsNetworkControllerSize

String

true

awsGatewaySize

String

true

awsTransferNodeSize

String

true

azureTransferNodeSize

String

true

alicloudTransferNodeSize

String

true

gcpTransferNodeSize

String

true

networkControllerVolumeSize

Integer

true

transferNodeVolumeSize

Integer

true

gatewayVolumeSize

Integer

true

Path Optional Description

self

false

network

false

Embedded resources

Path Type Optional Description

id

String

true

address

String

true

city

String

true

stateCode

String

true

stateName

String

true

continentName

String

true

continentCode

String

true

countryName

String

true

countryCode

String

true

isp

String

true

lat

Decimal

true

lng

Decimal

true

locationCode

String

true

locationName

String

true

provider

String

true

Must be one of [AWS, AZURE, GCP, ALICLOUD, NetFoundry, OCP].

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/network-configs' -i -X GET \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJBMWluSURwWEl3U01qbnpJS1BaYUlRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImE0NjUxYzBiLTFjNjItNDRmZi04NzEyLTUyMTJjNjVjZTM3MiIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgxMywiZXhwIjoxNjA2ODMzNDEzLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcImQxNmYwM2U2LTcyNDEtNDAwMy1hZjU2LWJjNWE2MTMyNmEzNFwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgxM31dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.RSE8LlFZ6sCigwNKwBaeBOmIEGkAlth53jU3gS3H27TgWS6rnEOzU2PCtxpHb4kt6ZIpcENwkTOlAF1BnxIWhB9E0F0Si-IkbrHmamfoyxPc0jnCg_BcsXLNgzR2Otxe7uAVIPSYWSNiOvtPYgXRLx9OObZ9qrMxVQTTmNSzV9VP0ZJJVel4g5JnW5xFyIxzQZUYYSk5m8EGmmJw0nQVwkihAlMQcy_IzlbFwNa1htt8eR3MgFJb1BU0o6sEewxYK4B0NFpRvPWE-r7WC9b0cah87X2rwI4d-W7yAFnCfTFHs1hJ7_yVQU-ummhk8U_9JUQaOjDOwkqY6VBnj5znpA'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 1479

{
  "_embedded" : {
    "networkConfigMetadataList" : [ {
      "id" : "f0caf822-0a24-44e3-b66e-fe2539ff4dfb",
      "name" : "small",
      "awsNetworkControllerSize" : null,
      "awsGatewaySize" : null,
      "awsTransferNodeSize" : null,
      "azureTransferNodeSize" : null,
      "alicloudTransferNodeSize" : null,
      "gcpTransferNodeSize" : null,
      "networkControllerVolumeSize" : 0,
      "transferNodeVolumeSize" : 0,
      "gatewayVolumeSize" : 0,
      "_links" : {
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/network-configs/f0caf822-0a24-44e3-b66e-fe2539ff4dfb"
        }
      }
    }, {
      "id" : "3b5aca5a-c983-4686-ac1b-802322105dbe",
      "name" : "medium",
      "awsNetworkControllerSize" : null,
      "awsGatewaySize" : null,
      "awsTransferNodeSize" : null,
      "azureTransferNodeSize" : null,
      "alicloudTransferNodeSize" : null,
      "gcpTransferNodeSize" : null,
      "networkControllerVolumeSize" : 0,
      "transferNodeVolumeSize" : 0,
      "gatewayVolumeSize" : 0,
      "_links" : {
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/network-configs/3b5aca5a-c983-4686-ac1b-802322105dbe"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/network-configs"
    }
  },
  "page" : {
    "size" : 2000,
    "totalElements" : 2,
    "totalPages" : 1,
    "number" : 0
  }
}

Networks

Find Networks

GET /networks

Authorization

This endpoint requires read action on the network resource type.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

findByName

String

true

findByNetworkGroupId

Object

true

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

id

String

false

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

false

updatedAt

String

false

deletedBy

String

true

deletedAt

String

true

name

String

false

Size must be between 5 and 255 inclusive.

networkGroupId

String

false

networkConfigMetadataId

String

false

productVersion

String

false

locationCode

String

false

status

String

false

Must be one of [NEW, PROVISIONING, PROVISIONED, ERROR, UPDATING, REPLACING, DELETING, DELETED].

sdsPassword

String

false

o365BreakoutCategory

String

false

Must be one of [OPTIMIZE, OPTIMIZE_ALLOW, OPTIMIZE_ALLOW_DEFAULT, NONE].

networkController

Object

true

networkController.id

String

false

networkController.name

String

true

networkController.networkId

String

false

networkController.ipAddress

String

true

networkController.provider

String

true

Must be one of [AWS, AZURE, GCP, ALICLOUD, NetFoundry, OCP].

networkController.providerId

String

true

networkController.locationMetadataId

String

true

networkController.userData

String

true

networkController.zitiUserId

String

true

networkController.zitiPassword

String

true

networkController.status

String

true

Must be one of [NEW, PROVISIONING, PROVISIONED, ERROR, UPDATING, REPLACING, DELETING, DELETED].

networkController.createdAt

String

false

networkController.updatedAt

String

false

networkController.deletedAt

String

true

Path Optional Description

self

false

edgeRouters

false

edgeRouterPolicies

false

endpoints

false

services

false

appWans

false

certificateAuthorities

false

Embedded resources

Path Type Optional Description

id

String

false

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

false

updatedAt

String

false

deletedBy

String

true

deletedAt

String

true

name

String

false

Size must be between 5 and 255 inclusive.

networkGroupId

String

false

networkConfigMetadataId

String

false

productVersion

String

false

locationCode

String

false

status

String

false

Must be one of [NEW, PROVISIONING, PROVISIONED, ERROR, UPDATING, REPLACING, DELETING, DELETED].

sdsPassword

String

false

o365BreakoutCategory

String

false

Must be one of [OPTIMIZE, OPTIMIZE_ALLOW, OPTIMIZE_ALLOW_DEFAULT, NONE].

networkController

Object

true

networkController.id

String

false

networkController.name

String

true

networkController.networkId

String

false

networkController.ipAddress

String

true

networkController.provider

String

true

Must be one of [AWS, AZURE, GCP, ALICLOUD, NetFoundry, OCP].

networkController.providerId

String

true

networkController.locationMetadataId

String

true

networkController.userData

String

true

networkController.zitiUserId

String

true

networkController.zitiPassword

String

true

networkController.status

String

true

Must be one of [NEW, PROVISIONING, PROVISIONED, ERROR, UPDATING, REPLACING, DELETING, DELETED].

networkController.createdAt

String

false

networkController.updatedAt

String

false

networkController.deletedAt

String

true

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/networks' -i -X GET \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJqTFBCblh1U0pJNW1KcTVlOHBHWml3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjE3NGY4MzliLTgzOTEtNGU3MC1hYmJiLWZiYTQyYTAzNDY3NSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTc4OCwiZXhwIjoxNjA2ODMzMzg4LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcImMxMjM4MTAxLWI4OTMtNGQwYy1hODYyLWM2MjdkNzFiNmFlOFwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTc4OH1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.ryreS6oyht965w3RUaqu6Zp1tv_bHsCrwSUtOXwf_iWXDC2R_FW0X1uV9e1cFeHZvgNw7y_Hw-TftTUUPrXRnoTUf86EprfSt8DaH3Ty49qezXcYwjCOei36vV464frpC8z5ivR5mzufUPpTVLf4cHPrrY_iJTXXBc-Wk3LXHZlji0sYeAXhiRaih_Dqc1JTI7hdpLLKWFkhpzEEf5AMhWiTpa-6z4gu0-wCpaBd6TQpa-gC6QSPCVVJRpZHWaCCwRw3CKPTUe1AaKIMMgPvBIzBJ5zrZgMWP2xsN9ur-t4tY461TgFMHw_DwuZbGtnYvO_gUSXuHrXpf7qUo11Y5w'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 19570

{
  "_embedded" : {
    "networkList" : [ {
      "id" : "887bbfcd-14c4-41c1-837c-53e5a936d1dc",
      "ownerIdentityId" : "1f282720-ffa3-4daa-8a2f-073d45fd19a9",
      "createdBy" : "1f282720-ffa3-4daa-8a2f-073d45fd19a9",
      "createdAt" : "2020-12-01T13:36:28.477432Z",
      "updatedAt" : "2020-12-01T13:36:28.478415Z",
      "deletedBy" : null,
      "deletedAt" : null,
      "name" : "ACME Network2020-12-01T13:36:28.476637Z",
      "networkGroupId" : "85ddaa05-dd37-47bd-98f5-9f1d4a567b98",
      "networkConfigMetadataId" : "1a13c367-e631-4883-bb51-37157db9a18f",
      "productVersion" : "7.2.1",
      "status" : "PROVISIONED",
      "o365BreakoutCategory" : "NONE",
      "_links" : {
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/887bbfcd-14c4-41c1-837c-53e5a936d1dc"
        },
        "networks" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks"
        },
        "edge-routers" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers?networkId=887bbfcd-14c4-41c1-837c-53e5a936d1dc"
        },
        "edge-router-policies" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-router-policies?networkId=887bbfcd-14c4-41c1-837c-53e5a936d1dc"
        },
        "endpoints" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/endpoints?networkId=887bbfcd-14c4-41c1-837c-53e5a936d1dc"
        },
        "services" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services?networkId=887bbfcd-14c4-41c1-837c-53e5a936d1dc"
        },
        "app-wans" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans?networkId=887bbfcd-14c4-41c1-837c-53e5a936d1dc"
        },
        "posture-checks" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/posture-checks?networkId=887bbfcd-14c4-41c1-837c-53e5a936d1dc"
        },
        "certificate-authorities" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities?networkId=887bbfcd-14c4-41c1-837c-53e5a936d1dc"
        }
      }
    }, {
      "id" : "80f16014-4ebf-45c2-8e0e-fead0f46b589",
      "ownerIdentityId" : "1f282720-ffa3-4daa-8a2f-073d45fd19a9",
      "createdBy" : "1f282720-ffa3-4daa-8a2f-073d45fd19a9",
      "createdAt" : "2020-12-01T13:36:28.478914Z",
      "updatedAt" : "2020-12-01T13:36:28.478914Z",
      "deletedBy" : null,
      "deletedAt" : null,
      "name" : "ACME Network Unprovisioned 2020-12-01T13:36:28.478723Z",
      "networkGroupId" : "85ddaa05-dd37-47bd-98f5-9f1d4a567b98",
      "networkConfigMetadataId" : "b9da4b3e-8e10-4a70-a65d-4bbdd2d2b0fa",
      "productVersion" : "7.0.0",
      "status" : "PROVISIONING",
      "o365BreakoutCategory" : "NONE",
      "_links" : {
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/80f16014-4ebf-45c2-8e0e-fead0f46b589"
        },
        "networks" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks"
        },
        "edge-routers" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers?networkId=80f16014-4ebf-45c2-8e0e-fead0f46b589"
        },
        "edge-router-policies" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-router-policies?networkId=80f16014-4ebf-45c2-8e0e-fead0f46b589"
        },
        "endpoints" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/endpoints?networkId=80f16014-4ebf-45c2-8e0e-fead0f46b589"
        },
        "services" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services?networkId=80f16014-4ebf-45c2-8e0e-fead0f46b589"
        },
        "app-wans" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans?networkId=80f16014-4ebf-45c2-8e0e-fead0f46b589"
        },
        "posture-checks" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/posture-checks?networkId=80f16014-4ebf-45c2-8e0e-fead0f46b589"
        },
        "certificate-authorities" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities?networkId=80f16014-4ebf-45c2-8e0e-fead0f46b589"
        }
      }
    }, {
      "id" : "f8c8bfe1-7025-4765-b0e8-8d883d73ba63",
      "ownerIdentityId" : "1f282720-ffa3-4daa-8a2f-073d45fd19a9",
      "createdBy" : "1f282720-ffa3-4daa-8a2f-073d45fd19a9",
      "createdAt" : "2020-12-01T13:36:28.479362Z",
      "updatedAt" : "2020-12-01T13:36:28.479771Z",
      "deletedBy" : null,
      "deletedAt" : null,
      "name" : "ACME Network With Breakout2020-12-01T13:36:28.479194Z",
      "networkGroupId" : "85ddaa05-dd37-47bd-98f5-9f1d4a567b98",
      "networkConfigMetadataId" : "4761898d-43af-4840-93e6-bb8dc6ff5e37",
      "productVersion" : "7.0.0",
      "status" : "PROVISIONED",
      "o365BreakoutCategory" : "OPTIMIZE_ALLOW",
      "_links" : {
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/f8c8bfe1-7025-4765-b0e8-8d883d73ba63"
        },
        "networks" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks"
        },
        "edge-routers" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers?networkId=f8c8bfe1-7025-4765-b0e8-8d883d73ba63"
        },
        "edge-router-policies" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-router-policies?networkId=f8c8bfe1-7025-4765-b0e8-8d883d73ba63"
        },
        "endpoints" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/endpoints?networkId=f8c8bfe1-7025-4765-b0e8-8d883d73ba63"
        },
        "services" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services?networkId=f8c8bfe1-7025-4765-b0e8-8d883d73ba63"
        },
        "app-wans" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans?networkId=f8c8bfe1-7025-4765-b0e8-8d883d73ba63"
        },
        "posture-checks" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/posture-checks?networkId=f8c8bfe1-7025-4765-b0e8-8d883d73ba63"
        },
        "certificate-authorities" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities?networkId=f8c8bfe1-7025-4765-b0e8-8d883d73ba63"
        }
      }
    }, {
      "id" : "a3e1b095-8c09-4f22-a99c-2d388bdffe7b",
      "ownerIdentityId" : "16b8ef03-0670-4d5f-a431-bb324d50056d",
      "createdBy" : "16b8ef03-0670-4d5f-a431-bb324d50056d",
      "createdAt" : "2020-12-01T13:36:28.628482Z",
      "updatedAt" : "2020-12-01T13:36:28.629228Z",
      "deletedBy" : null,
      "deletedAt" : null,
      "name" : "ACME Network2020-12-01T13:36:28.628108Z",
      "networkGroupId" : "85ddaa05-dd37-47bd-98f5-9f1d4a567b98",
      "networkConfigMetadataId" : "8095192e-f484-4634-9494-e926867460f7",
      "productVersion" : "7.2.1",
      "status" : "PROVISIONED",
      "o365BreakoutCategory" : "NONE",
      "_links" : {
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/a3e1b095-8c09-4f22-a99c-2d388bdffe7b"
        },
        "networks" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks"
        },
        "edge-routers" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers?networkId=a3e1b095-8c09-4f22-a99c-2d388bdffe7b"
        },
        "edge-router-policies" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-router-policies?networkId=a3e1b095-8c09-4f22-a99c-2d388bdffe7b"
        },
        "endpoints" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/endpoints?networkId=a3e1b095-8c09-4f22-a99c-2d388bdffe7b"
        },
        "services" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services?networkId=a3e1b095-8c09-4f22-a99c-2d388bdffe7b"
        },
        "app-wans" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans?networkId=a3e1b095-8c09-4f22-a99c-2d388bdffe7b"
        },
        "posture-checks" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/posture-checks?networkId=a3e1b095-8c09-4f22-a99c-2d388bdffe7b"
        },
        "certificate-authorities" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities?networkId=a3e1b095-8c09-4f22-a99c-2d388bdffe7b"
        }
      }
    }, {
      "id" : "47260555-bd81-4c49-809b-53c9bed2f833",
      "ownerIdentityId" : "16b8ef03-0670-4d5f-a431-bb324d50056d",
      "createdBy" : "16b8ef03-0670-4d5f-a431-bb324d50056d",
      "createdAt" : "2020-12-01T13:36:28.629756Z",
      "updatedAt" : "2020-12-01T13:36:28.629756Z",
      "deletedBy" : null,
      "deletedAt" : null,
      "name" : "ACME Network Unprovisioned 2020-12-01T13:36:28.629551Z",
      "networkGroupId" : "85ddaa05-dd37-47bd-98f5-9f1d4a567b98",
      "networkConfigMetadataId" : "156928b8-4bc2-48df-9927-22cbcc40138e",
      "productVersion" : "7.0.0",
      "status" : "PROVISIONING",
      "o365BreakoutCategory" : "NONE",
      "_links" : {
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/47260555-bd81-4c49-809b-53c9bed2f833"
        },
        "networks" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks"
        },
        "edge-routers" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers?networkId=47260555-bd81-4c49-809b-53c9bed2f833"
        },
        "edge-router-policies" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-router-policies?networkId=47260555-bd81-4c49-809b-53c9bed2f833"
        },
        "endpoints" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/endpoints?networkId=47260555-bd81-4c49-809b-53c9bed2f833"
        },
        "services" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services?networkId=47260555-bd81-4c49-809b-53c9bed2f833"
        },
        "app-wans" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans?networkId=47260555-bd81-4c49-809b-53c9bed2f833"
        },
        "posture-checks" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/posture-checks?networkId=47260555-bd81-4c49-809b-53c9bed2f833"
        },
        "certificate-authorities" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities?networkId=47260555-bd81-4c49-809b-53c9bed2f833"
        }
      }
    }, {
      "id" : "15a73406-eb4e-4a39-8551-af48ccf67ad8",
      "ownerIdentityId" : "16b8ef03-0670-4d5f-a431-bb324d50056d",
      "createdBy" : "16b8ef03-0670-4d5f-a431-bb324d50056d",
      "createdAt" : "2020-12-01T13:36:28.630205Z",
      "updatedAt" : "2020-12-01T13:36:28.630640Z",
      "deletedBy" : null,
      "deletedAt" : null,
      "name" : "ACME Network With Breakout2020-12-01T13:36:28.630026Z",
      "networkGroupId" : "85ddaa05-dd37-47bd-98f5-9f1d4a567b98",
      "networkConfigMetadataId" : "8af921e2-eaae-486b-97b6-7df8147a9ba0",
      "productVersion" : "7.0.0",
      "status" : "PROVISIONED",
      "o365BreakoutCategory" : "OPTIMIZE_ALLOW",
      "_links" : {
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/15a73406-eb4e-4a39-8551-af48ccf67ad8"
        },
        "networks" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks"
        },
        "edge-routers" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers?networkId=15a73406-eb4e-4a39-8551-af48ccf67ad8"
        },
        "edge-router-policies" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-router-policies?networkId=15a73406-eb4e-4a39-8551-af48ccf67ad8"
        },
        "endpoints" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/endpoints?networkId=15a73406-eb4e-4a39-8551-af48ccf67ad8"
        },
        "services" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services?networkId=15a73406-eb4e-4a39-8551-af48ccf67ad8"
        },
        "app-wans" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans?networkId=15a73406-eb4e-4a39-8551-af48ccf67ad8"
        },
        "posture-checks" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/posture-checks?networkId=15a73406-eb4e-4a39-8551-af48ccf67ad8"
        },
        "certificate-authorities" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities?networkId=15a73406-eb4e-4a39-8551-af48ccf67ad8"
        }
      }
    }, {
      "id" : "4448dce8-a02e-47c5-a732-c9da1c5fcd51",
      "ownerIdentityId" : "a772891c-0dbf-4c26-91de-3620847fbd9a",
      "createdBy" : "a772891c-0dbf-4c26-91de-3620847fbd9a",
      "createdAt" : "2020-12-01T13:36:28.685753Z",
      "updatedAt" : "2020-12-01T13:36:28.686454Z",
      "deletedBy" : null,
      "deletedAt" : null,
      "name" : "ACME Network2020-12-01T13:36:28.685419Z",
      "networkGroupId" : "85ddaa05-dd37-47bd-98f5-9f1d4a567b98",
      "networkConfigMetadataId" : "79ccbaf0-81a1-4be9-a005-ff2a332a62d2",
      "productVersion" : "7.2.1",
      "status" : "PROVISIONED",
      "o365BreakoutCategory" : "NONE",
      "_links" : {
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/4448dce8-a02e-47c5-a732-c9da1c5fcd51"
        },
        "networks" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks"
        },
        "edge-routers" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers?networkId=4448dce8-a02e-47c5-a732-c9da1c5fcd51"
        },
        "edge-router-policies" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-router-policies?networkId=4448dce8-a02e-47c5-a732-c9da1c5fcd51"
        },
        "endpoints" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/endpoints?networkId=4448dce8-a02e-47c5-a732-c9da1c5fcd51"
        },
        "services" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services?networkId=4448dce8-a02e-47c5-a732-c9da1c5fcd51"
        },
        "app-wans" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans?networkId=4448dce8-a02e-47c5-a732-c9da1c5fcd51"
        },
        "posture-checks" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/posture-checks?networkId=4448dce8-a02e-47c5-a732-c9da1c5fcd51"
        },
        "certificate-authorities" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities?networkId=4448dce8-a02e-47c5-a732-c9da1c5fcd51"
        }
      }
    }, {
      "id" : "33133a4d-e7a7-40ef-b814-95d4b4cb42c5",
      "ownerIdentityId" : "a772891c-0dbf-4c26-91de-3620847fbd9a",
      "createdBy" : "a772891c-0dbf-4c26-91de-3620847fbd9a",
      "createdAt" : "2020-12-01T13:36:28.686933Z",
      "updatedAt" : "2020-12-01T13:36:28.686933Z",
      "deletedBy" : null,
      "deletedAt" : null,
      "name" : "ACME Network Unprovisioned 2020-12-01T13:36:28.686755Z",
      "networkGroupId" : "85ddaa05-dd37-47bd-98f5-9f1d4a567b98",
      "networkConfigMetadataId" : "6d6c7af4-8725-4c0e-9d96-6c7048384bfd",
      "productVersion" : "7.0.0",
      "status" : "PROVISIONING",
      "o365BreakoutCategory" : "NONE",
      "_links" : {
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/33133a4d-e7a7-40ef-b814-95d4b4cb42c5"
        },
        "networks" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks"
        },
        "edge-routers" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers?networkId=33133a4d-e7a7-40ef-b814-95d4b4cb42c5"
        },
        "edge-router-policies" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-router-policies?networkId=33133a4d-e7a7-40ef-b814-95d4b4cb42c5"
        },
        "endpoints" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/endpoints?networkId=33133a4d-e7a7-40ef-b814-95d4b4cb42c5"
        },
        "services" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services?networkId=33133a4d-e7a7-40ef-b814-95d4b4cb42c5"
        },
        "app-wans" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans?networkId=33133a4d-e7a7-40ef-b814-95d4b4cb42c5"
        },
        "posture-checks" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/posture-checks?networkId=33133a4d-e7a7-40ef-b814-95d4b4cb42c5"
        },
        "certificate-authorities" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities?networkId=33133a4d-e7a7-40ef-b814-95d4b4cb42c5"
        }
      }
    }, {
      "id" : "184418b4-acd7-4687-ada9-e7324b5b5580",
      "ownerIdentityId" : "a772891c-0dbf-4c26-91de-3620847fbd9a",
      "createdBy" : "a772891c-0dbf-4c26-91de-3620847fbd9a",
      "createdAt" : "2020-12-01T13:36:28.687349Z",
      "updatedAt" : "2020-12-01T13:36:28.687782Z",
      "deletedBy" : null,
      "deletedAt" : null,
      "name" : "ACME Network With Breakout2020-12-01T13:36:28.687187Z",
      "networkGroupId" : "85ddaa05-dd37-47bd-98f5-9f1d4a567b98",
      "networkConfigMetadataId" : "8ea58425-5b0e-49e8-96de-38bbf5696474",
      "productVersion" : "7.0.0",
      "status" : "PROVISIONED",
      "o365BreakoutCategory" : "OPTIMIZE_ALLOW",
      "_links" : {
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/184418b4-acd7-4687-ada9-e7324b5b5580"
        },
        "networks" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks"
        },
        "edge-routers" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers?networkId=184418b4-acd7-4687-ada9-e7324b5b5580"
        },
        "edge-router-policies" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-router-policies?networkId=184418b4-acd7-4687-ada9-e7324b5b5580"
        },
        "endpoints" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/endpoints?networkId=184418b4-acd7-4687-ada9-e7324b5b5580"
        },
        "services" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services?networkId=184418b4-acd7-4687-ada9-e7324b5b5580"
        },
        "app-wans" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans?networkId=184418b4-acd7-4687-ada9-e7324b5b5580"
        },
        "posture-checks" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/posture-checks?networkId=184418b4-acd7-4687-ada9-e7324b5b5580"
        },
        "certificate-authorities" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities?networkId=184418b4-acd7-4687-ada9-e7324b5b5580"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks{?findByName,findByNetworkGroupId}",
      "templated" : true
    }
  },
  "page" : {
    "size" : 2000,
    "totalElements" : 9,
    "totalPages" : 1,
    "number" : 0
  }
}

Get Network

GET /networks/{id}

Authorization

This endpoint requires read action on the network resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

false

updatedAt

String

false

deletedBy

String

true

deletedAt

String

true

name

String

false

Size must be between 5 and 255 inclusive.

networkGroupId

String

false

networkConfigMetadataId

String

false

productVersion

String

false

locationCode

String

false

status

String

false

Must be one of [NEW, PROVISIONING, PROVISIONED, ERROR, UPDATING, REPLACING, DELETING, DELETED].

sdsPassword

String

false

o365BreakoutCategory

String

false

Must be one of [OPTIMIZE, OPTIMIZE_ALLOW, OPTIMIZE_ALLOW_DEFAULT, NONE].

networkController

Object

true

networkController.id

String

false

networkController.name

String

true

networkController.networkId

String

false

networkController.ipAddress

String

true

networkController.provider

String

true

Must be one of [AWS, AZURE, GCP, ALICLOUD, NetFoundry, OCP].

networkController.providerId

String

true

networkController.locationMetadataId

String

true

networkController.userData

String

true

networkController.zitiUserId

String

true

networkController.zitiPassword

String

true

networkController.status

String

true

Must be one of [NEW, PROVISIONING, PROVISIONED, ERROR, UPDATING, REPLACING, DELETING, DELETED].

networkController.createdAt

String

false

networkController.updatedAt

String

false

networkController.deletedAt

String

true

Path Optional Description

self

false

edgeRouters

false

edgeRouterPolicies

false

endpoints

false

services

false

appWans

false

certificateAuthorities

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/networks/a3e1b095-8c09-4f22-a99c-2d388bdffe7b' -i -X GET \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJfY19UTV9CNWtNbWdQb3B5UHFpZWt3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImU2MWM0NWZkLWQ0OTQtNGEzZC04ZmY0LThhNGZmYmU4NWIwOCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTc4OCwiZXhwIjoxNjA2ODMzMzg4LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcImQwMmQ4N2VhLWVjNmYtNDZhZi04NGUyLWFiNWUzZGYxOTBmNVwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTc4OH1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.ndAfUKBbHezsrJdiiECtT2jSgX6IsCtl8HEmleBTUX5tbOvGuN-utob2x9tNvAc_fORIuWSQ-d6oGORCtwgjfKM51Mgv8RyoT-8WH1ysUOx-dQKZrwTAfNOWnODcpWdMg8V5itHVIHywChH4K2pB8V8LCBHFsULVDow5GGt7d1PPrX8xRrXlNHMRdDXBNDoUZuQjgAEcbMvEBhQnsf6TXiN55JFKCWRIO-0Ok9ow_0D0EGpbpAxpA64AhcJYglV9_Nu0uwmF9sF3qaY7XLFnZIVZxuEwIEzWJfBKG2h_lSS8YiQR-DSg0l79dgX1MZg8Ewvp_C7i2ATk25t3d3dTIw'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 1951

{
  "id" : "a3e1b095-8c09-4f22-a99c-2d388bdffe7b",
  "ownerIdentityId" : "16b8ef03-0670-4d5f-a431-bb324d50056d",
  "createdBy" : "16b8ef03-0670-4d5f-a431-bb324d50056d",
  "createdAt" : "2020-12-01T13:36:28.628482Z",
  "updatedAt" : "2020-12-01T13:36:28.629228Z",
  "deletedBy" : null,
  "deletedAt" : null,
  "name" : "ACME Network2020-12-01T13:36:28.628108Z",
  "networkGroupId" : "85ddaa05-dd37-47bd-98f5-9f1d4a567b98",
  "networkConfigMetadataId" : "8095192e-f484-4634-9494-e926867460f7",
  "productVersion" : "7.2.1",
  "status" : "PROVISIONED",
  "o365BreakoutCategory" : "NONE",
  "_links" : {
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/a3e1b095-8c09-4f22-a99c-2d388bdffe7b"
    },
    "networks" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks"
    },
    "edge-routers" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers?networkId=a3e1b095-8c09-4f22-a99c-2d388bdffe7b"
    },
    "edge-router-policies" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/edge-router-policies?networkId=a3e1b095-8c09-4f22-a99c-2d388bdffe7b"
    },
    "endpoints" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/endpoints?networkId=a3e1b095-8c09-4f22-a99c-2d388bdffe7b"
    },
    "services" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/services?networkId=a3e1b095-8c09-4f22-a99c-2d388bdffe7b"
    },
    "app-wans" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans?networkId=a3e1b095-8c09-4f22-a99c-2d388bdffe7b"
    },
    "posture-checks" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/posture-checks?networkId=a3e1b095-8c09-4f22-a99c-2d388bdffe7b"
    },
    "certificate-authorities" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities?networkId=a3e1b095-8c09-4f22-a99c-2d388bdffe7b"
    }
  }
}

Create Network

POST /networks

Authorization

This endpoint requires create action on the network resource type.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

networkGroupId

String

false

Client must have create action under the annotated resource.

networkConfigMetadataId

String

false

name

String

false

productVersion

String

true

o365BreakoutCategory

String

true

Must be one of [OPTIMIZE, OPTIMIZE_ALLOW, OPTIMIZE_ALLOW_DEFAULT, NONE].

locationCode

String

false

Response fields

Path Type Optional Description

id

String

false

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

false

updatedAt

String

false

deletedBy

String

true

deletedAt

String

true

name

String

false

Size must be between 5 and 255 inclusive.

networkGroupId

String

false

networkConfigMetadataId

String

false

productVersion

String

false

locationCode

String

false

status

String

false

Must be one of [NEW, PROVISIONING, PROVISIONED, ERROR, UPDATING, REPLACING, DELETING, DELETED].

sdsPassword

String

false

o365BreakoutCategory

String

false

Must be one of [OPTIMIZE, OPTIMIZE_ALLOW, OPTIMIZE_ALLOW_DEFAULT, NONE].

networkController

Object

true

networkController.id

String

false

networkController.name

String

true

networkController.networkId

String

false

networkController.ipAddress

String

true

networkController.provider

String

true

Must be one of [AWS, AZURE, GCP, ALICLOUD, NetFoundry, OCP].

networkController.providerId

String

true

networkController.locationMetadataId

String

true

networkController.userData

String

true

networkController.zitiUserId

String

true

networkController.zitiPassword

String

true

networkController.status

String

true

Must be one of [NEW, PROVISIONING, PROVISIONED, ERROR, UPDATING, REPLACING, DELETING, DELETED].

networkController.createdAt

String

false

networkController.updatedAt

String

false

networkController.deletedAt

String

true

Path Optional Description

self

false

edgeRouters

false

edgeRouterPolicies

false

endpoints

false

services

false

appWans

false

certificateAuthorities

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/networks' -i -X POST \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIwN2JkQkFDdUNZVk41X3JUQ1NZNU1BIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjNlMjY1MjQ4LTVmN2ItNDMwZi1iNzQ0LWYzYmMzMjA5NzAwMSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTc4OCwiZXhwIjoxNjA2ODMzMzg4LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjIwNmNjYTYwLWI3YTMtNDlmNC05NWEzLTgyMTFiYTgyOWZkZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTc4OH1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.pI9OBF-z4J1ZrvrUASQUGz9UoI6Jq-VqbFg80O_2shLgY1qtEpqZl3d79uD-WwUyWffX_B32E1V7v4ynxhsi-O24HTlQLvTl5NYex_A9UmOXxI2zkOrL9jBGgxnoH22Xtg8JHQHHP1iJeU8Hpx1l8lGt3_ExXMx-vaaOK-m8HlNd48lPmHk39hJ-_mIDWBM5HezczuQaguK0bMmdGLCmWh1o8LXJGz0AZKh3JCWW_Mr31PFamurji2bZIUorstdchWQ1VJmWTKxBw9hJ6gTF3PTRl9l3B7OQzONrhJhNTa5Q56ccBT0cNzrARnFCkCHvd-Y_2KxclY9HSGi-VUAmdw' \
    -d '{"networkGroupId":"85ddaa05-dd37-47bd-98f5-9f1d4a567b98","networkConfigMetadataId":"d1db609c-4e75-490c-bf7d-fd54ae068d70","name":"SecOps Test Network","productVersion":null,"o365BreakoutCategory":"NONE","locationCode":"us-east-1"}'

Example response

HTTP/1.1 202 Accepted
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 1941

{
  "id" : "b2f43646-eb35-46d3-8beb-d9acb7de50d4",
  "ownerIdentityId" : "3e265248-5f7b-430f-b744-f3bc32097001",
  "createdBy" : "3e265248-5f7b-430f-b744-f3bc32097001",
  "createdAt" : "2020-12-01T13:36:28.828494Z",
  "updatedAt" : "2020-12-01T13:36:28.828494Z",
  "deletedBy" : null,
  "deletedAt" : null,
  "name" : "SecOps Test Network",
  "networkGroupId" : "85ddaa05-dd37-47bd-98f5-9f1d4a567b98",
  "networkConfigMetadataId" : "d1db609c-4e75-490c-bf7d-fd54ae068d70",
  "productVersion" : "7.1.0-59578434",
  "status" : "PROVISIONING",
  "o365BreakoutCategory" : "NONE",
  "_links" : {
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/b2f43646-eb35-46d3-8beb-d9acb7de50d4"
    },
    "networks" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks"
    },
    "edge-routers" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers?networkId=b2f43646-eb35-46d3-8beb-d9acb7de50d4"
    },
    "edge-router-policies" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/edge-router-policies?networkId=b2f43646-eb35-46d3-8beb-d9acb7de50d4"
    },
    "endpoints" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/endpoints?networkId=b2f43646-eb35-46d3-8beb-d9acb7de50d4"
    },
    "services" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/services?networkId=b2f43646-eb35-46d3-8beb-d9acb7de50d4"
    },
    "app-wans" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans?networkId=b2f43646-eb35-46d3-8beb-d9acb7de50d4"
    },
    "posture-checks" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/posture-checks?networkId=b2f43646-eb35-46d3-8beb-d9acb7de50d4"
    },
    "certificate-authorities" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities?networkId=b2f43646-eb35-46d3-8beb-d9acb7de50d4"
    }
  }
}

Delete Network

DELETE /networks/{id}

Authorization

This endpoint requires delete action on the network resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have delete action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

No links.

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/networks/f8a2f8d3-50b8-44b9-b59b-d5029bf94534' -i -X DELETE \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJ2VUZtb1QxbEV2ZFBidVVwbWJCUVJRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjBlYmFlMzE2LTA5ZDQtNDMwMi05YjBlLTNjYWE5NjFlZTEwMCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTc4OSwiZXhwIjoxNjA2ODMzMzg5LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjk0ZTg0Y2U2LWFkYmEtNGZjYS05NzVmLTQ1YzBkMzhkNWEwYlwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTc4OX1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.gKNCGkJYzLLJgjj_EAan0dWk5EL64EQtrlePn0EgwsJG0Z-WiZ55qlSXvH2rNIOVR7hwApz9AX5Q9WJwF1nWLGafzQxUa4iDsDJ8UqxSKRVAxb1c-c7RhNXbkjmrt03t42CZQY2Q2RyzENb9ageQbKHzDjWds4v6slynGx0d53Ep4l-A3z_eaeTvCItgvLVePIaMXz1Ra-r1h0V23So6efX21d9Me_1aHyYevD73e-RsQREBX-l7i3yQ9rPC_INptK4zPq0I0FjJH_9AL0-o2fzyV01Pcb5b2sFiWUPSKjQVzDlmgw-eDkdE5UtunmZj1wIDPu_8-LRbPFD3gmC3cg'

Example response

HTTP/1.1 202 Accepted

Endpoints

Find Endpoints

GET /endpoints

Authorization

This endpoint requires read action on the endpoint resource type.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

networkId

Object

true

name

String

true

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

sessionActive

Boolean

true

version

String

true

osVersion

String

true

networkId

String

false

zitiId

String

true

revision

String

true

sessionIdentityId

String

true

deletedAt

String

true

jwt

String

true

enrollmentMethod

Object

true

enrollmentMethod.ott

Object

true

enrollmentMethod.ott.token

String

true

enrollmentMethod.ott.jwt

String

true

enrollmentMethod.ott.expiresAt

String

true

enrollmentMethod.ott.issuedAt

String

true

enrollmentMethod.ottca

Object

true

enrollmentMethod.ottca.certificateAuthorityId

String

true

enrollmentMethod.ottca.token

String

true

enrollmentMethod.ottca.jwt

String

true

enrollmentMethod.ottca.expiresAt

String

true

enrollmentMethod.ottca.issuedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

arch

String

true

os

String

true

osRelease

String

true

syncId

String

true

syncResourceId

String

true

branch

String

true

name

String

false

id

String

true

type

String

true

attributes

Array[String]

true

Path Optional Description

self

false

network

false

Embedded resources

Path Type Optional Description

sessionActive

Boolean

true

version

String

true

osVersion

String

true

networkId

String

false

zitiId

String

true

revision

String

true

sessionIdentityId

String

true

deletedAt

String

true

jwt

String

true

enrollmentMethod

Object

true

enrollmentMethod.ott

Object

true

enrollmentMethod.ott.token

String

true

enrollmentMethod.ott.jwt

String

true

enrollmentMethod.ott.expiresAt

String

true

enrollmentMethod.ott.issuedAt

String

true

enrollmentMethod.ottca

Object

true

enrollmentMethod.ottca.certificateAuthorityId

String

true

enrollmentMethod.ottca.token

String

true

enrollmentMethod.ottca.jwt

String

true

enrollmentMethod.ottca.expiresAt

String

true

enrollmentMethod.ottca.issuedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

arch

String

true

os

String

true

osRelease

String

true

syncId

String

true

syncResourceId

String

true

branch

String

true

name

String

false

id

String

true

type

String

true

attributes

Array[String]

true

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/endpoints' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJpVHJ1czlwS2ZCTWFyWWNSUW1rMlhnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjcyNTZhY2E4LTg5ZjgtNDMyYi1hYTA0LWQyMTVkNWE5ODM3MyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgwOCwiZXhwIjoxNjA2ODMzNDA4LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcImUwMTk5YjExLWYxYjQtNGMxYy1hN2ViLTdkYmRjMmVlYjIyNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgwOH1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.m8Uz_JlhF97zU6IS8xOeBkF-B1GHXnGRYtA5RFKgObu2lYSY8XnbZMDWIBmQaDhHKkSvEr3rB80tIzzeqlQAXrNKtb458jtuog-vfWXuCZA-8Uysf_lCiYRpFhU8n2CR1KnS7DL7uetX0tHMhkNeF2au0nB8mig4iKTE42fNbUruSY8-rxn1kOYOEFO-FTH2A6CFmmQ--0JeGLDGs_Iwhlq3vlpj0IAIGqcWY7xQXBSmWnwQY0yvFJtpmvzeebQK9WEkUi93ikCxo7mu9AzO1XPVdjoDkRRi8SUZaUYruRULbxpa0ge4cFHaf27PoeDbo4LyPldJUJnKMP2syNdQKQ'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 1935

{
  "_embedded" : {
    "endpointList" : [ {
      "sessionActive" : true,
      "version" : null,
      "osVersion" : null,
      "networkId" : "f519dc5a-996a-4a3b-aafc-9378db01b25e",
      "zitiId" : "f19cae9a-a4c4-4e96-a0b8-3e1815dd2382",
      "revision" : null,
      "sessionIdentityId" : null,
      "deletedAt" : null,
      "jwt" : "jwthere",
      "enrollmentMethod" : {
        "ott" : {
          "token" : "newtoken",
          "jwt" : "jwthere",
          "expiresAt" : "2020-12-01T13:36:48.120Z",
          "issuedAt" : "2020-12-01T13:36:48.120Z"
        },
        "ottca" : {
          "certificateAuthorityId" : null,
          "token" : "newtokenupdb",
          "jwt" : "jwthereupdb",
          "expiresAt" : "2020-12-01T13:36:48.120Z",
          "issuedAt" : "2020-12-01T13:36:48.120Z"
        }
      },
      "ownerIdentityId" : "32dfd046-4c3a-4a8f-80bb-1f4f0d049a07",
      "createdBy" : "32dfd046-4c3a-4a8f-80bb-1f4f0d049a07",
      "createdAt" : "2020-12-01T13:36:48.119233Z",
      "updatedAt" : "2020-12-01T13:36:48.119233Z",
      "deletedBy" : null,
      "arch" : null,
      "os" : null,
      "osRelease" : null,
      "syncId" : null,
      "syncResourceId" : null,
      "branch" : null,
      "name" : "Test_endpoint2020-12-01T13:36:48.118996Z",
      "id" : "45ebd1b5-fcc6-420f-839c-c2e19e80c932",
      "type" : null,
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/f519dc5a-996a-4a3b-aafc-9378db01b25e"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/endpoints/45ebd1b5-fcc6-420f-839c-c2e19e80c932"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/endpoints"
    }
  },
  "page" : {
    "size" : 2000,
    "totalElements" : 1,
    "totalPages" : 1,
    "number" : 0
  }
}

Get Endpoint

GET /endpoints/{id}

Authorization

This endpoint requires read action on the endpoint resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

sessionActive

Boolean

true

version

String

true

osVersion

String

true

networkId

String

false

zitiId

String

true

revision

String

true

sessionIdentityId

String

true

deletedAt

String

true

jwt

String

true

enrollmentMethod

Object

true

enrollmentMethod.ott

Object

true

enrollmentMethod.ott.token

String

true

enrollmentMethod.ott.jwt

String

true

enrollmentMethod.ott.expiresAt

String

true

enrollmentMethod.ott.issuedAt

String

true

enrollmentMethod.ottca

Object

true

enrollmentMethod.ottca.certificateAuthorityId

String

true

enrollmentMethod.ottca.token

String

true

enrollmentMethod.ottca.jwt

String

true

enrollmentMethod.ottca.expiresAt

String

true

enrollmentMethod.ottca.issuedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

arch

String

true

os

String

true

osRelease

String

true

syncId

String

true

syncResourceId

String

true

branch

String

true

name

String

false

id

String

true

type

String

true

attributes

Array[String]

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/endpoints/7da71bf4-413c-4f8e-b86d-d2e82185e5f7' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJ0dGYyeW8yYWlpbzFRM25mdWcxWlVnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjliNjdmODY3LThkMzYtNDZiNC04OWViLWI2ZWM4ZWI0YTNhZSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgwOCwiZXhwIjoxNjA2ODMzNDA4LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjVlOWEwNjJhLTkxYTEtNDk1Yi1iYjBmLWEzZjg3Y2JiZDgwOFwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgwOH1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.ltrORGJ08b32h1CcRwAUOm4FYHr_HyCDASOJcUAvxMKIPVHmunIVj1gOSQa9mfCwB61CUZBquqMnuj6VaEpKG37f_76fxyHLtSck-0mDaFuD598H7zyUona3lHMBqF7IpbnjmwmX0xLoLfkkuKY9rLfEbf3OcjGefvDddyUTPKaKDFBoUBlyn9ci0-qiTfNbsn_L84WY_utgrqATUnkJjQm0jikP8FNSjgsC26dUY92KUPHk2TcK07bGbE6FpbVTtCSxovUlVq8yhW-Nq4CfPByvX9KPpCI87AGULQoCLxLV0a0CCq83b1dSZYaNXTwk0GSqpLaP5ihjl6bEvPr2zg'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 1474

{
  "sessionActive" : true,
  "version" : null,
  "osVersion" : null,
  "networkId" : "2889bbab-c377-47f3-9abd-5de680ba7286",
  "zitiId" : "7f524143-e4a2-4e24-972a-679c26ac9e34",
  "revision" : null,
  "sessionIdentityId" : null,
  "deletedAt" : null,
  "jwt" : "jwthere",
  "enrollmentMethod" : {
    "ott" : {
      "token" : "newtoken",
      "jwt" : "jwthere",
      "expiresAt" : "2020-12-01T13:36:48.863Z",
      "issuedAt" : "2020-12-01T13:36:48.863Z"
    },
    "ottca" : {
      "certificateAuthorityId" : null,
      "token" : "newtokenupdb",
      "jwt" : "jwthereupdb",
      "expiresAt" : "2020-12-01T13:36:48.863Z",
      "issuedAt" : "2020-12-01T13:36:48.863Z"
    }
  },
  "ownerIdentityId" : "16752c20-b818-4317-ba9a-eaf52ef87133",
  "createdBy" : "16752c20-b818-4317-ba9a-eaf52ef87133",
  "createdAt" : "2020-12-01T13:36:48.862516Z",
  "updatedAt" : "2020-12-01T13:36:48.862516Z",
  "deletedBy" : null,
  "arch" : null,
  "os" : null,
  "osRelease" : null,
  "syncId" : null,
  "syncResourceId" : null,
  "branch" : null,
  "name" : "Test_endpoint2020-12-01T13:36:48.862346Z",
  "id" : "7da71bf4-413c-4f8e-b86d-d2e82185e5f7",
  "type" : null,
  "attributes" : [ ],
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/2889bbab-c377-47f3-9abd-5de680ba7286"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/endpoints/7da71bf4-413c-4f8e-b86d-d2e82185e5f7"
    }
  }
}

Get Endpoint Policy Advice

GET /endpoints/{id}/policy-advice/{serviceId}

Authorization

This endpoint requires read action on the endpoint resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

serviceId

Object

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

commonRouters

Array[Object]

true

commonRouters[].provider

String

true

commonRouters[].networkId

String

false

commonRouters[].status

String

true

commonRouters[].dataCenterId

String

true

commonRouters[].zitiId

String

true

commonRouters[].deletedAt

String

true

commonRouters[].jwt

String

true

commonRouters[].ipAddress

String

true

commonRouters[].locationMetadataId

String

true

commonRouters[].ownerIdentityId

String

true

commonRouters[].createdBy

String

true

commonRouters[].createdAt

String

true

commonRouters[].updatedAt

String

true

commonRouters[].deletedBy

String

true

commonRouters[].linkListener

Boolean

true

commonRouters[].online

Boolean

true

commonRouters[].verified

Boolean

true

commonRouters[].name

String

false

commonRouters[].id

String

true

commonRouters[].attributes

Array[String]

true

networkId

String

false

endpointId

String

true

serviceName

String

true

serviceId

String

true

serviceRouterCount

Integer

true

endpointName

String

true

endpointRouterCount

Integer

true

dialAllowed

Boolean

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/endpoints/0f6eabfd-c328-485f-866e-76310e5b2678/policy-advice/b2af0e85-4dce-44df-9f03-5b1221e9eca2' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJKU1gxR1hlZlhXeHNzbS1LZ0FIYk1RIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjI3Y2U2MGQ1LTk1NmEtNDZkMS1iZDg5LTEwZjk5ZThiODA2OCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgwOCwiZXhwIjoxNjA2ODMzNDA4LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjI1MWRlYzliLWEzM2MtNDliMi1hNGZmLWIzZWFmZDMxZGRlZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgwOH1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.OOeQHX4nBmLz7Web4IhbIkzXXHMT4B-B1-qP1lP6K7Y94C-uo8PRsMkid8nzJtgIN264NdfNW3UB8-Tr8nIk_kq65CnQqpMtzIKnGRWOhpS9rbXohc2VOmQBi2UqmXDEq7f469xb5fNahRIyhxa0IoZpzCV9wkSs0RC5ZFUmULcBat9uG_LBdUN-6q2XMwoCcWUCe6hcEdfqINlNqCOew18TV5phRwnwC_y0-8VFEs4kGJuxHaWoopy8e4G8LWdsdDdG_rbRjZT-viYb8__YzZLML0Kr8liwl7UnIdprOUTIz5zgUumg20843IMEjfYxnagOnXkx9Ollta6CLH11gw'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 1563

{
  "commonRouters" : [ {
    "provider" : "AWS",
    "networkId" : "a460a462-670d-4fb5-93c3-00c090c902a9",
    "status" : "PROVISIONING",
    "dataCenterId" : "5d14df63-45eb-4d21-975b-a17ecda3625e",
    "zitiId" : "zitiEdgeRouterId01",
    "deletedAt" : null,
    "jwt" : null,
    "ipAddress" : "1.2.3.4",
    "locationMetadataId" : "ef3da6c6-1576-4437-9eca-a15267b0d00e",
    "ownerIdentityId" : "3fb54bd0-a36e-420b-97ed-1fac4dacb96d",
    "createdBy" : "3fb54bd0-a36e-420b-97ed-1fac4dacb96d",
    "createdAt" : "2020-12-01T13:36:48.645886Z",
    "updatedAt" : "2020-12-01T13:36:48.645886Z",
    "deletedBy" : null,
    "linkListener" : true,
    "online" : false,
    "verified" : true,
    "name" : "ACME_edge_router_2020-12-01T13:36:48.645711Z",
    "id" : "cb313126-d0ab-4827-ac4a-d47b5e449b5b",
    "attributes" : [ ]
  } ],
  "networkId" : "a460a462-670d-4fb5-93c3-00c090c902a9",
  "endpointId" : "0f6eabfd-c328-485f-866e-76310e5b2678",
  "serviceName" : "ACME_Service01_2020-12-01T13:36:48.647078Z",
  "serviceId" : "b2af0e85-4dce-44df-9f03-5b1221e9eca2",
  "serviceRouterCount" : 1,
  "endpointName" : "Test_endpoint2020-12-01T13:36:48.643895Z",
  "endpointRouterCount" : 1,
  "dialAllowed" : true,
  "_links" : {
    "policy-advice" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/endpoints/0f6eabfd-c328-485f-866e-76310e5b2678/policy-advice/b2af0e85-4dce-44df-9f03-5b1221e9eca2"
    },
    "endpoint" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/endpoints/0f6eabfd-c328-485f-866e-76310e5b2678"
    }
  }
}

Create Endpoint

POST /endpoints

Authorization

This endpoint requires create action on the endpoint resource type.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

networkId

String

true

Client must have create action under the annotated resource.

name

String

true

enrollmentMethod

Object

true

enrollmentMethod.ott

Boolean

true

enrollmentMethod.updb

String

true

enrollmentMethod.ottca

String

true

attributes

Array[String]

true

sessionIdentityId

String

true

syncId

String

true

syncResourceId

String

true

Response fields

Path Type Optional Description

sessionActive

Boolean

true

version

String

true

osVersion

String

true

networkId

String

false

zitiId

String

true

revision

String

true

sessionIdentityId

String

true

deletedAt

String

true

jwt

String

true

enrollmentMethod

Object

true

enrollmentMethod.ott

Object

true

enrollmentMethod.ott.token

String

true

enrollmentMethod.ott.jwt

String

true

enrollmentMethod.ott.expiresAt

String

true

enrollmentMethod.ott.issuedAt

String

true

enrollmentMethod.ottca

Object

true

enrollmentMethod.ottca.certificateAuthorityId

String

true

enrollmentMethod.ottca.token

String

true

enrollmentMethod.ottca.jwt

String

true

enrollmentMethod.ottca.expiresAt

String

true

enrollmentMethod.ottca.issuedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

arch

String

true

os

String

true

osRelease

String

true

syncId

String

true

syncResourceId

String

true

branch

String

true

name

String

false

id

String

true

type

String

true

attributes

Array[String]

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/endpoints' -i -X POST \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJuSzlady1oOTlmV3ZQc0F1UmhBODhBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImI4MzkzZjMwLTZlNmEtNGM1ZC1iODY2LTA0MjdjMjMxMzI0MyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgwOCwiZXhwIjoxNjA2ODMzNDA4LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjQ0OWEwMGMwLWM2NjMtNDFhNi1hMjAyLTk3Yzc3MTk4YTg3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgwOH1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.F09aibTGehMSCrkIwtf54K_udsq-qvYiVpbGWNYxuWCXSAHEhAWGU19JMZSBzX0Be4y-68pxXQ4buzTPo0TbB1k-YiYWO9uwlpy3abfjdFAq5bnoXKMzwGC0dFN9Wke2TQXz0RHwuJXZWzsdEGm9t0nj1N_NwjnpcQvvBc6RszcdzCD61SOuh2Os8ifyWUz8-ShziH1kztQTlzbuqy9ajFXrs5h7Us8tXGuzHTnpJq4OATg42s8pIIBcBomLezUrdrMFHaQutJmba4ZiqoXJrNIj3zg8RhVrjhpZV2pvkrHCsAIJzQrfYtA4YcJ7J70JAVZZM4NlyeV-kr6o9TbrXg' \
    -d '{"networkId":"b021dca3-f372-4c92-aad8-e18a2c66e160","name":"Test endpoint 02","enrollmentMethod":{"ott":true,"updb":null,"ottca":null},"attributes":["#clients"],"sessionIdentityId":null,"syncId":null,"syncResourceId":null}'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 1479

{
  "sessionActive" : true,
  "version" : "version100",
  "osVersion" : "ver01",
  "networkId" : "b021dca3-f372-4c92-aad8-e18a2c66e160",
  "zitiId" : "9c8985e1-6c33-4c16-b763-9e0fc750e705",
  "revision" : "rev01",
  "sessionIdentityId" : null,
  "deletedAt" : null,
  "jwt" : "jwthere",
  "enrollmentMethod" : {
    "ott" : {
      "token" : "token",
      "jwt" : "jwthere",
      "expiresAt" : "2020-12-01T13:36:48.280Z",
      "issuedAt" : "2020-12-01T13:36:48.280Z"
    },
    "ottca" : {
      "certificateAuthorityId" : null,
      "token" : "token",
      "jwt" : "jwthere",
      "expiresAt" : "2020-12-01T13:36:48.280Z",
      "issuedAt" : "2020-12-01T13:36:48.280Z"
    }
  },
  "ownerIdentityId" : "b8393f30-6e6a-4c5d-b866-0427c2313243",
  "createdBy" : "b8393f30-6e6a-4c5d-b866-0427c2313243",
  "createdAt" : "2020-12-01T13:36:48.287273Z",
  "updatedAt" : "2020-12-01T13:36:48.288540Z",
  "deletedBy" : null,
  "arch" : "arch",
  "os" : "osd01",
  "osRelease" : "osrev01",
  "syncId" : null,
  "syncResourceId" : null,
  "branch" : "branch",
  "name" : "Test endpoint 02",
  "id" : "32b15f87-65aa-4743-8afd-bfeb009a8ab5",
  "type" : "device",
  "attributes" : [ "#clients" ],
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/b021dca3-f372-4c92-aad8-e18a2c66e160"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/endpoints/32b15f87-65aa-4743-8afd-bfeb009a8ab5"
    }
  }
}

Patch Endpoint

PATCH /endpoints/{id}

Authorization

This endpoint requires update action on the endpoint resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have update action on the annotated resource.

Query parameters

No parameters.

Request fields

Path Type Optional Description

name

String

true

attributes

Array[String]

true

sessionIdentityId

Object

true

Response fields

Path Type Optional Description

sessionActive

Boolean

true

version

String

true

osVersion

String

true

networkId

String

false

zitiId

String

true

revision

String

true

sessionIdentityId

String

true

deletedAt

String

true

jwt

String

true

enrollmentMethod

Object

true

enrollmentMethod.ott

Object

true

enrollmentMethod.ott.token

String

true

enrollmentMethod.ott.jwt

String

true

enrollmentMethod.ott.expiresAt

String

true

enrollmentMethod.ott.issuedAt

String

true

enrollmentMethod.ottca

Object

true

enrollmentMethod.ottca.certificateAuthorityId

String

true

enrollmentMethod.ottca.token

String

true

enrollmentMethod.ottca.jwt

String

true

enrollmentMethod.ottca.expiresAt

String

true

enrollmentMethod.ottca.issuedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

arch

String

true

os

String

true

osRelease

String

true

syncId

String

true

syncResourceId

String

true

branch

String

true

name

String

false

id

String

true

type

String

true

attributes

Array[String]

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/endpoints/b7fd1309-1730-4e1e-9afa-29aa8f461264' -i -X PATCH \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIzWm1qenEzUEp2VmE3U2FHRmVOMWR3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjI4YWEyYjZjLTIzMDYtNDQ5Yi1hZDcwLWViYmU4ZWZiYmNlOSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgwOCwiZXhwIjoxNjA2ODMzNDA4LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjFiYzNlZTE3LTkxODQtNDk0Ni1hY2FjLThjYzFjMmY1MTQxMVwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgwOH1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.Q1uLW20qYfFmiS2IMz8WkES86JhQWbqzNbHtQ7CjrsAxRzOX3aADuZLwA3NzYfKT0cMxVE2sKGInGKc0lCpbHzLmLTAPWlt0DnoXjizW4EF3NSEVRGBmy3eDi_hQdaV6MgV1S5uo0URrQ1rMre9MCyLWj97jWuqhg23e3bUNDcG5O6UM2VtSyex4EoH2bZM50lI7c5TfxLkWm3NRC8QeAK9b7Y08rmuRq3hbzG2DB2SjsX39oLms7ZLoLRcFvi28APKVoFu4Jg4yDmx6kIw3_lBFOOViOYcWTVluoag0fKH8ZIo3zyoQQ2PrgP0qY7-SptbxyDEJyXH2VuIb-mLCPg' \
    -d '{"name":"Test endpoint 02 updated","attributes":null,"sessionIdentityId":null}'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 1492

{
  "sessionActive" : true,
  "version" : null,
  "osVersion" : null,
  "networkId" : "2c7064e1-1e87-41ce-a558-05c46d5c3ca4",
  "zitiId" : "b0a8fb1b-ce0a-4b93-b46f-f22fee5d9aa9",
  "revision" : null,
  "sessionIdentityId" : null,
  "deletedAt" : null,
  "jwt" : "jwthereupdb",
  "enrollmentMethod" : {
    "ott" : {
      "token" : "newtoken",
      "jwt" : "jwthere",
      "expiresAt" : "2020-12-01T13:36:48.800Z",
      "issuedAt" : "2020-12-01T13:36:48.800Z"
    },
    "ottca" : {
      "certificateAuthorityId" : "98a3c2be-4014-42ae-8366-ce48b188d375",
      "token" : "newtokenca",
      "jwt" : "jwthereca",
      "expiresAt" : "2020-12-01T13:36:48.800Z",
      "issuedAt" : "2020-12-01T13:36:48.800Z"
    }
  },
  "ownerIdentityId" : "3c0679e7-8cda-436d-92b5-dedc471d5286",
  "createdBy" : "3c0679e7-8cda-436d-92b5-dedc471d5286",
  "createdAt" : "2020-12-01T13:36:48.799474Z",
  "updatedAt" : "2020-12-01T13:36:48.821637Z",
  "deletedBy" : null,
  "arch" : null,
  "os" : null,
  "osRelease" : null,
  "syncId" : null,
  "syncResourceId" : null,
  "branch" : null,
  "name" : "Test endpoint 02 updated",
  "id" : "b7fd1309-1730-4e1e-9afa-29aa8f461264",
  "type" : null,
  "attributes" : [ ],
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/2c7064e1-1e87-41ce-a558-05c46d5c3ca4"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/endpoints/b7fd1309-1730-4e1e-9afa-29aa8f461264"
    }
  }
}

Delete Endpoint

DELETE /endpoints/{id}

Authorization

This endpoint requires delete action on the endpoint resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have delete action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

No links.

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/endpoints/c6e03e0b-4c3f-4beb-ad0a-4f14fd57edd3' -i -X DELETE \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJRdmsyd3VJcERjYkdFT2RfQ2FOMm5BIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjY0M2Y2NGVmLWJjMmMtNDE4Ni1iMTFjLTRiODU2M2ZmMDlmZSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgwOCwiZXhwIjoxNjA2ODMzNDA4LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjcwODdhNWQ2LTUwZTYtNGFmOS1hODUyLWZiNWZlYzc3YmE0MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgwOH1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.V2F4ZqHAKCmCPcOqF8QOgLxYlhQs58W_XULTJ7eBYHhvo1cHY7cDiHvGrRMHladrg7EcFHhcVYUhQ7tFZ_QSExxD3w6JncSVpGLPV1Fn_Pc7dQmjfm4BzgdMPWBi69zfidlcITYWemopwKcXBfpP6yUs1PwJuHAChTZ_71QYz1JDWJm6HqlRw4PrroxiMCgNeLiVpRNMypwi5CjllcPaVF7dFhA9LiR5WEUnZI2QugAzSz8n0jfh8TvIzqI5zLGtYNmf4Z7W28jMuXAwNep8qinRi0U5Qdm8MiUFwMHPmwyTUZQW6qN4UbhXuYhfkOUvo6xS7AW0plo2agNgTrq62A'

Example response

HTTP/1.1 200 OK

Edge Routers

Find Edge Routers

GET /edge-routers

Authorization

This endpoint requires read action on the edge-router resource type.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

networkId

Object

true

name

String

true

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

provider

String

true

networkId

String

false

status

String

true

dataCenterId

String

true

zitiId

String

true

deletedAt

String

true

jwt

String

true

ipAddress

String

true

locationMetadataId

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

linkListener

Boolean

true

online

Boolean

true

verified

Boolean

true

name

String

false

id

String

true

attributes

Array[String]

true

Path Optional Description

self

false

network

false

Embedded resources

Path Type Optional Description

provider

String

true

networkId

String

false

status

String

true

dataCenterId

String

true

zitiId

String

true

deletedAt

String

true

jwt

String

true

ipAddress

String

true

locationMetadataId

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

linkListener

Boolean

true

online

Boolean

true

verified

Boolean

true

name

String

false

id

String

true

attributes

Array[String]

true

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/edge-routers' -i -X GET \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJuN1hvUFdPemtsWjNvOEtnRWtJSjZnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjcyOTkzMzY2LTBjNzItNDI5Ni05MjE0LTFmNWJlMTQwODE5NCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgyNywiZXhwIjoxNjA2ODMzNDI3LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcImViN2E3YzdlLWZlMTEtNDcwNi1hOGUwLTJlMTZhYjVjZWQ2MlwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgyN31dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.cXUj00y_EyNOK_zpzYZfRI782m_mX21haNeUrGtjroNBclXCw3yvKW2KN24mP_70MU6KScebnXi1xL1CMU6CzXzWhtg720HWvj8wfSDkVn_E6qt1lKJe5NzUjI2e3TLhJLtlhDX-n68dInOvmNEW-5NKRm-rDjEvp7Qsl3ggBelG2DF3V5dK0P5juqqqPa8P5qF564ZC9j2a1BwMsV4oLjOAnED4sdw_9ygNKdy8fzoAzSnUzMRyFprU_wdqMr3NlvyJdFNcQVuVAeHcMzyfA1BeAjMrV-RUtTA5KXtwbXTElL8t0I1j_ZopefR-1RP_9zgsw-h5pyiD1A6LWM4cHg'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 59070

{
  "_embedded" : {
    "edgeRouterList" : [ {
      "provider" : "AWS",
      "networkId" : "09e72943-fa9b-46fc-8ad0-0477e7ab9f19",
      "status" : "PROVISIONING",
      "dataCenterId" : "a4ecfcfc-f9ad-4527-9e52-2fa8cdfaafe0",
      "zitiId" : "zitiEdgeRouterId01",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "ea32947a-38b8-4dab-8ede-be9de8532606",
      "ownerIdentityId" : "3a3ad260-c712-4909-bea9-2f3ec5eef277",
      "createdBy" : "3a3ad260-c712-4909-bea9-2f3ec5eef277",
      "createdAt" : "2020-12-01T13:37:06.506812Z",
      "updatedAt" : "2020-12-01T13:37:06.506812Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME_edge_router_2020-12-01T13:37:06.506589Z",
      "id" : "579b02a7-85f1-430b-a4ad-9b2ac053d73c",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/09e72943-fa9b-46fc-8ad0-0477e7ab9f19"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/579b02a7-85f1-430b-a4ad-9b2ac053d73c"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "09e72943-fa9b-46fc-8ad0-0477e7ab9f19",
      "status" : "PROVISIONING",
      "dataCenterId" : "6ddae9cc-7498-459c-aec7-bb52956523d6",
      "zitiId" : "zitiEdgeRouterId02",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "cafe8aca-4d82-4690-9b23-0459de4a1845",
      "ownerIdentityId" : "3a3ad260-c712-4909-bea9-2f3ec5eef277",
      "createdBy" : "3a3ad260-c712-4909-bea9-2f3ec5eef277",
      "createdAt" : "2020-12-01T13:37:06.507358Z",
      "updatedAt" : "2020-12-01T13:37:06.507358Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 02 2020-12-01T13:37:06.507177Z",
      "id" : "70cf6f6c-bbdb-4f09-a8fe-275d396aa7bd",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/09e72943-fa9b-46fc-8ad0-0477e7ab9f19"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/70cf6f6c-bbdb-4f09-a8fe-275d396aa7bd"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "09e72943-fa9b-46fc-8ad0-0477e7ab9f19",
      "status" : "PROVISIONING",
      "dataCenterId" : "c3e650e9-e92a-420b-b6ea-08ce0154f14f",
      "zitiId" : "zitiEdgeRouterId03",
      "deletedAt" : null,
      "jwt" : "jwtdata",
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "04255b63-da11-47a0-b104-f18ca8e9ac20",
      "ownerIdentityId" : "3a3ad260-c712-4909-bea9-2f3ec5eef277",
      "createdBy" : "3a3ad260-c712-4909-bea9-2f3ec5eef277",
      "createdAt" : "2020-12-01T13:37:06.507686Z",
      "updatedAt" : "2020-12-01T13:37:06.507686Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 03 2020-12-01T13:37:06.507519Z",
      "id" : "51a58b38-88b1-483d-b584-d3e2f964108d",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/09e72943-fa9b-46fc-8ad0-0477e7ab9f19"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/51a58b38-88b1-483d-b584-d3e2f964108d"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "92bb6fdb-e910-45aa-a3e7-56d492f987de",
      "status" : "PROVISIONING",
      "dataCenterId" : "1323b22b-1166-4f68-bd53-8a8e616b7d9f",
      "zitiId" : "zitiEdgeRouterId01",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "6e71888e-daaf-4ded-a315-8512a315dc6e",
      "ownerIdentityId" : "011edd34-f36e-4cc1-a122-6dccd7877ec6",
      "createdBy" : "011edd34-f36e-4cc1-a122-6dccd7877ec6",
      "createdAt" : "2020-12-01T13:37:06.553510Z",
      "updatedAt" : "2020-12-01T13:37:06.553510Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME_edge_router_2020-12-01T13:37:06.553340Z",
      "id" : "872a70ee-273d-48e7-b4ef-9ecf5a697e84",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/92bb6fdb-e910-45aa-a3e7-56d492f987de"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/872a70ee-273d-48e7-b4ef-9ecf5a697e84"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "92bb6fdb-e910-45aa-a3e7-56d492f987de",
      "status" : "PROVISIONING",
      "dataCenterId" : "c795a5c0-2a6c-4a43-920b-3b781a08f1f8",
      "zitiId" : "zitiEdgeRouterId02",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "001ded27-7189-4885-bd80-b6ba307c8417",
      "ownerIdentityId" : "011edd34-f36e-4cc1-a122-6dccd7877ec6",
      "createdBy" : "011edd34-f36e-4cc1-a122-6dccd7877ec6",
      "createdAt" : "2020-12-01T13:37:06.553851Z",
      "updatedAt" : "2020-12-01T13:37:06.553851Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 02 2020-12-01T13:37:06.553683Z",
      "id" : "5d63c32c-4026-4bb3-bd86-3c71418ec9b6",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/92bb6fdb-e910-45aa-a3e7-56d492f987de"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/5d63c32c-4026-4bb3-bd86-3c71418ec9b6"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "92bb6fdb-e910-45aa-a3e7-56d492f987de",
      "status" : "PROVISIONING",
      "dataCenterId" : "521a4586-7b18-44f8-9dc6-5e3a05520b88",
      "zitiId" : "zitiEdgeRouterId03",
      "deletedAt" : null,
      "jwt" : "jwtdata",
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "9c1f18d6-515c-4583-91df-2dba66fa4e10",
      "ownerIdentityId" : "011edd34-f36e-4cc1-a122-6dccd7877ec6",
      "createdBy" : "011edd34-f36e-4cc1-a122-6dccd7877ec6",
      "createdAt" : "2020-12-01T13:37:06.554182Z",
      "updatedAt" : "2020-12-01T13:37:06.554182Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 03 2020-12-01T13:37:06.554013Z",
      "id" : "7af9ef80-a247-474d-9886-8cffb3c527fa",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/92bb6fdb-e910-45aa-a3e7-56d492f987de"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/7af9ef80-a247-474d-9886-8cffb3c527fa"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "e909bc06-f14b-4397-b462-8651f3302961",
      "status" : "PROVISIONING",
      "dataCenterId" : "3834021c-3aec-4954-a008-59c43daab697",
      "zitiId" : "zitiEdgeRouterId01",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "651ec953-f273-4d24-a85e-49169e261025",
      "ownerIdentityId" : "b0b0c645-fed4-4d78-9b07-39c992037aff",
      "createdBy" : "b0b0c645-fed4-4d78-9b07-39c992037aff",
      "createdAt" : "2020-12-01T13:37:06.592642Z",
      "updatedAt" : "2020-12-01T13:37:06.592642Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME_edge_router_2020-12-01T13:37:06.592448Z",
      "id" : "7666ee7f-1958-416b-805a-b28e690a5f68",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/e909bc06-f14b-4397-b462-8651f3302961"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/7666ee7f-1958-416b-805a-b28e690a5f68"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "e909bc06-f14b-4397-b462-8651f3302961",
      "status" : "PROVISIONING",
      "dataCenterId" : "bc44304e-956f-43f7-9563-c01158809668",
      "zitiId" : "zitiEdgeRouterId02",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "039cfa80-c6f5-4750-abae-e9c843f4ce5d",
      "ownerIdentityId" : "b0b0c645-fed4-4d78-9b07-39c992037aff",
      "createdBy" : "b0b0c645-fed4-4d78-9b07-39c992037aff",
      "createdAt" : "2020-12-01T13:37:06.592991Z",
      "updatedAt" : "2020-12-01T13:37:06.592991Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 02 2020-12-01T13:37:06.592816Z",
      "id" : "730668fb-c412-4f68-9e8c-b1a3e3744894",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/e909bc06-f14b-4397-b462-8651f3302961"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/730668fb-c412-4f68-9e8c-b1a3e3744894"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "e909bc06-f14b-4397-b462-8651f3302961",
      "status" : "PROVISIONING",
      "dataCenterId" : "14bd8ca2-9dc7-4211-b3a8-11987d754e9d",
      "zitiId" : "zitiEdgeRouterId03",
      "deletedAt" : null,
      "jwt" : "jwtdata",
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "38aadbbf-e58e-4130-9e21-d6ca4b6fcbfa",
      "ownerIdentityId" : "b0b0c645-fed4-4d78-9b07-39c992037aff",
      "createdBy" : "b0b0c645-fed4-4d78-9b07-39c992037aff",
      "createdAt" : "2020-12-01T13:37:06.593344Z",
      "updatedAt" : "2020-12-01T13:37:06.593344Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 03 2020-12-01T13:37:06.593175Z",
      "id" : "f27f106e-f4ee-4a90-9309-668853c017a5",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/e909bc06-f14b-4397-b462-8651f3302961"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/f27f106e-f4ee-4a90-9309-668853c017a5"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "976baefc-b59c-495b-8483-f1a71f0bf839",
      "status" : "PROVISIONING",
      "dataCenterId" : "e9200309-58ac-40d0-a3d4-cf898d1cc5fe",
      "zitiId" : "zitiEdgeRouterId01",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "bb96ef5e-d588-4a47-82ea-8703b69a8432",
      "ownerIdentityId" : "01ea6d94-6fb3-4436-bf40-17c1ef62ab7a",
      "createdBy" : "01ea6d94-6fb3-4436-bf40-17c1ef62ab7a",
      "createdAt" : "2020-12-01T13:37:06.625108Z",
      "updatedAt" : "2020-12-01T13:37:06.625108Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME_edge_router_2020-12-01T13:37:06.624929Z",
      "id" : "84e2270e-7c6a-4646-8afc-e8c4656b359b",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/976baefc-b59c-495b-8483-f1a71f0bf839"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/84e2270e-7c6a-4646-8afc-e8c4656b359b"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "976baefc-b59c-495b-8483-f1a71f0bf839",
      "status" : "PROVISIONING",
      "dataCenterId" : "6ba9e540-826a-4b5e-bc36-30640d85136f",
      "zitiId" : "zitiEdgeRouterId02",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "7716b64c-44fc-4410-8f0c-1eb9462f3d48",
      "ownerIdentityId" : "01ea6d94-6fb3-4436-bf40-17c1ef62ab7a",
      "createdBy" : "01ea6d94-6fb3-4436-bf40-17c1ef62ab7a",
      "createdAt" : "2020-12-01T13:37:06.625463Z",
      "updatedAt" : "2020-12-01T13:37:06.625463Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 02 2020-12-01T13:37:06.625289Z",
      "id" : "686ae4eb-736e-42ab-abb6-84d2c5571448",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/976baefc-b59c-495b-8483-f1a71f0bf839"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/686ae4eb-736e-42ab-abb6-84d2c5571448"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "976baefc-b59c-495b-8483-f1a71f0bf839",
      "status" : "PROVISIONING",
      "dataCenterId" : "a09908b3-ed42-4f9c-a7f8-a29bfcf849f5",
      "zitiId" : "zitiEdgeRouterId03",
      "deletedAt" : null,
      "jwt" : "jwtdata",
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "6641a47d-f4cf-49fc-8d56-b5c07e3a7eb0",
      "ownerIdentityId" : "01ea6d94-6fb3-4436-bf40-17c1ef62ab7a",
      "createdBy" : "01ea6d94-6fb3-4436-bf40-17c1ef62ab7a",
      "createdAt" : "2020-12-01T13:37:06.625799Z",
      "updatedAt" : "2020-12-01T13:37:06.625799Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 03 2020-12-01T13:37:06.625628Z",
      "id" : "e7f4f50a-293a-47f5-bc79-2106b27d4ec3",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/976baefc-b59c-495b-8483-f1a71f0bf839"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/e7f4f50a-293a-47f5-bc79-2106b27d4ec3"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "b878aa62-1f5f-421d-8d76-2ba017e8f84d",
      "status" : "PROVISIONING",
      "dataCenterId" : "c03fe278-e10c-49dc-81d1-39868cb366ab",
      "zitiId" : "zitiEdgeRouterId01",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "18dd97f3-26fe-47ef-a083-ccbafb679e8f",
      "ownerIdentityId" : "3146fb8c-8729-4de5-9c9a-65b2cc1bfcc3",
      "createdBy" : "3146fb8c-8729-4de5-9c9a-65b2cc1bfcc3",
      "createdAt" : "2020-12-01T13:37:06.701334Z",
      "updatedAt" : "2020-12-01T13:37:06.701334Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME_edge_router_2020-12-01T13:37:06.701162Z",
      "id" : "b8520f5e-4446-4820-8ceb-12d6d19e64d8",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/b878aa62-1f5f-421d-8d76-2ba017e8f84d"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/b8520f5e-4446-4820-8ceb-12d6d19e64d8"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "b878aa62-1f5f-421d-8d76-2ba017e8f84d",
      "status" : "PROVISIONING",
      "dataCenterId" : "e515432a-b1c3-4634-881a-8b88b183d850",
      "zitiId" : "zitiEdgeRouterId02",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "0df34e91-3c59-4e37-9b17-874b584450d9",
      "ownerIdentityId" : "3146fb8c-8729-4de5-9c9a-65b2cc1bfcc3",
      "createdBy" : "3146fb8c-8729-4de5-9c9a-65b2cc1bfcc3",
      "createdAt" : "2020-12-01T13:37:06.701680Z",
      "updatedAt" : "2020-12-01T13:37:06.701680Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 02 2020-12-01T13:37:06.701510Z",
      "id" : "7617abc6-514e-44d1-a5cc-f3cf4f3b141c",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/b878aa62-1f5f-421d-8d76-2ba017e8f84d"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/7617abc6-514e-44d1-a5cc-f3cf4f3b141c"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "b878aa62-1f5f-421d-8d76-2ba017e8f84d",
      "status" : "PROVISIONING",
      "dataCenterId" : "e05d6a8f-1d29-4c23-bfb1-519e93119681",
      "zitiId" : "zitiEdgeRouterId03",
      "deletedAt" : null,
      "jwt" : "jwtdata",
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "75e3a10d-6369-48fa-a969-8fe2bc055957",
      "ownerIdentityId" : "3146fb8c-8729-4de5-9c9a-65b2cc1bfcc3",
      "createdBy" : "3146fb8c-8729-4de5-9c9a-65b2cc1bfcc3",
      "createdAt" : "2020-12-01T13:37:06.702013Z",
      "updatedAt" : "2020-12-01T13:37:06.702013Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 03 2020-12-01T13:37:06.701845Z",
      "id" : "38619a40-1a66-4e4c-b49c-d8dc49940073",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/b878aa62-1f5f-421d-8d76-2ba017e8f84d"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/38619a40-1a66-4e4c-b49c-d8dc49940073"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "ef5e32d0-13d3-43a9-a58f-710443724147",
      "status" : "PROVISIONING",
      "dataCenterId" : "1ac1f421-df56-43ba-a0fd-1f226ddf2f5d",
      "zitiId" : "zitiEdgeRouterId01",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "a1acbcf1-5bc0-4bce-bbf3-93abd65231b4",
      "ownerIdentityId" : "da678a35-27cc-484a-815d-a9d835bf043c",
      "createdBy" : "da678a35-27cc-484a-815d-a9d835bf043c",
      "createdAt" : "2020-12-01T13:37:06.740976Z",
      "updatedAt" : "2020-12-01T13:37:06.740976Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME_edge_router_2020-12-01T13:37:06.740796Z",
      "id" : "eb82b2eb-4f99-4242-88e7-4517b3944150",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/ef5e32d0-13d3-43a9-a58f-710443724147"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/eb82b2eb-4f99-4242-88e7-4517b3944150"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "ef5e32d0-13d3-43a9-a58f-710443724147",
      "status" : "PROVISIONING",
      "dataCenterId" : "3eac5775-d3a2-46a4-a247-1f31edc4ae86",
      "zitiId" : "zitiEdgeRouterId02",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "a12d9d8c-de68-4537-9192-985666cf7c08",
      "ownerIdentityId" : "da678a35-27cc-484a-815d-a9d835bf043c",
      "createdBy" : "da678a35-27cc-484a-815d-a9d835bf043c",
      "createdAt" : "2020-12-01T13:37:06.741330Z",
      "updatedAt" : "2020-12-01T13:37:06.741330Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 02 2020-12-01T13:37:06.741160Z",
      "id" : "35d5c53f-34d8-450b-a33f-3d55e891ff72",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/ef5e32d0-13d3-43a9-a58f-710443724147"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/35d5c53f-34d8-450b-a33f-3d55e891ff72"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "ef5e32d0-13d3-43a9-a58f-710443724147",
      "status" : "PROVISIONING",
      "dataCenterId" : "d1b2ed25-05ca-4058-a611-6fe35a8befd4",
      "zitiId" : "zitiEdgeRouterId03",
      "deletedAt" : null,
      "jwt" : "jwtdata",
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "bef086fa-0f21-4182-8be2-3c3250e97267",
      "ownerIdentityId" : "da678a35-27cc-484a-815d-a9d835bf043c",
      "createdBy" : "da678a35-27cc-484a-815d-a9d835bf043c",
      "createdAt" : "2020-12-01T13:37:06.741654Z",
      "updatedAt" : "2020-12-01T13:37:06.741654Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 03 2020-12-01T13:37:06.741493Z",
      "id" : "9bc1dd68-dab0-4473-8454-c3a97a519957",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/ef5e32d0-13d3-43a9-a58f-710443724147"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/9bc1dd68-dab0-4473-8454-c3a97a519957"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "60fbec3b-b7a0-43dd-8c8c-d011dfe873a2",
      "status" : "PROVISIONING",
      "dataCenterId" : "28958707-c129-427d-a3cd-16e2c939766d",
      "zitiId" : "zitiEdgeRouterId01",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "66c0f1b8-4945-4bc6-a3cc-2d5966d24822",
      "ownerIdentityId" : "a8aae9ef-1d1b-4a2e-aeb7-c290cf506649",
      "createdBy" : "a8aae9ef-1d1b-4a2e-aeb7-c290cf506649",
      "createdAt" : "2020-12-01T13:37:06.779017Z",
      "updatedAt" : "2020-12-01T13:37:06.779017Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME_edge_router_2020-12-01T13:37:06.778846Z",
      "id" : "68f5e53a-136f-4402-80f2-cfc1a5743566",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/60fbec3b-b7a0-43dd-8c8c-d011dfe873a2"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/68f5e53a-136f-4402-80f2-cfc1a5743566"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "60fbec3b-b7a0-43dd-8c8c-d011dfe873a2",
      "status" : "PROVISIONING",
      "dataCenterId" : "d9cba866-3460-4b85-a880-736f8b2ec828",
      "zitiId" : "zitiEdgeRouterId02",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "657bca95-4ade-4be3-9b52-455856a14bd3",
      "ownerIdentityId" : "a8aae9ef-1d1b-4a2e-aeb7-c290cf506649",
      "createdBy" : "a8aae9ef-1d1b-4a2e-aeb7-c290cf506649",
      "createdAt" : "2020-12-01T13:37:06.779372Z",
      "updatedAt" : "2020-12-01T13:37:06.779372Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 02 2020-12-01T13:37:06.779203Z",
      "id" : "6597c9f0-07e6-4a89-896e-df7684bee825",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/60fbec3b-b7a0-43dd-8c8c-d011dfe873a2"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/6597c9f0-07e6-4a89-896e-df7684bee825"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "60fbec3b-b7a0-43dd-8c8c-d011dfe873a2",
      "status" : "PROVISIONING",
      "dataCenterId" : "a7579e14-2311-4edf-983f-92fe041abeaf",
      "zitiId" : "zitiEdgeRouterId03",
      "deletedAt" : null,
      "jwt" : "jwtdata",
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "e7c42bc7-5593-4d62-8c0e-9a0d447f420c",
      "ownerIdentityId" : "a8aae9ef-1d1b-4a2e-aeb7-c290cf506649",
      "createdBy" : "a8aae9ef-1d1b-4a2e-aeb7-c290cf506649",
      "createdAt" : "2020-12-01T13:37:06.779700Z",
      "updatedAt" : "2020-12-01T13:37:06.779700Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 03 2020-12-01T13:37:06.779537Z",
      "id" : "bb4f4576-96db-41f7-b7eb-72c46790d4a6",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/60fbec3b-b7a0-43dd-8c8c-d011dfe873a2"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/bb4f4576-96db-41f7-b7eb-72c46790d4a6"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "fc9016ef-08bb-42cd-b22f-84f2ea824d5d",
      "status" : "PROVISIONING",
      "dataCenterId" : "11e82837-a94b-45e4-98e0-e1a9977f734d",
      "zitiId" : "zitiEdgeRouterId01",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "ebb36416-00f9-4fa0-bd96-7a53de3f81de",
      "ownerIdentityId" : "d5740702-2b6f-415e-a39b-4e2bce09023f",
      "createdBy" : "d5740702-2b6f-415e-a39b-4e2bce09023f",
      "createdAt" : "2020-12-01T13:37:06.827830Z",
      "updatedAt" : "2020-12-01T13:37:06.827830Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME_edge_router_2020-12-01T13:37:06.827654Z",
      "id" : "e1305f70-488f-49d3-9ba8-192a2081aee9",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/fc9016ef-08bb-42cd-b22f-84f2ea824d5d"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/e1305f70-488f-49d3-9ba8-192a2081aee9"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "fc9016ef-08bb-42cd-b22f-84f2ea824d5d",
      "status" : "PROVISIONING",
      "dataCenterId" : "cb394bff-3cd5-44d9-8c3b-ff5549092420",
      "zitiId" : "zitiEdgeRouterId02",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "dc5f689a-462c-46be-bcf7-acd4209b1dba",
      "ownerIdentityId" : "d5740702-2b6f-415e-a39b-4e2bce09023f",
      "createdBy" : "d5740702-2b6f-415e-a39b-4e2bce09023f",
      "createdAt" : "2020-12-01T13:37:06.828179Z",
      "updatedAt" : "2020-12-01T13:37:06.828179Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 02 2020-12-01T13:37:06.828008Z",
      "id" : "87b4226a-18a7-447d-8c46-64552fe54495",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/fc9016ef-08bb-42cd-b22f-84f2ea824d5d"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/87b4226a-18a7-447d-8c46-64552fe54495"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "fc9016ef-08bb-42cd-b22f-84f2ea824d5d",
      "status" : "PROVISIONING",
      "dataCenterId" : "38e5d95f-4cf2-4c96-9da3-03fe49c827a3",
      "zitiId" : "zitiEdgeRouterId03",
      "deletedAt" : null,
      "jwt" : "jwtdata",
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "aa7bd9cc-be79-458d-af44-b8c29e3f1052",
      "ownerIdentityId" : "d5740702-2b6f-415e-a39b-4e2bce09023f",
      "createdBy" : "d5740702-2b6f-415e-a39b-4e2bce09023f",
      "createdAt" : "2020-12-01T13:37:06.828530Z",
      "updatedAt" : "2020-12-01T13:37:06.828530Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 03 2020-12-01T13:37:06.828344Z",
      "id" : "6526a951-8a27-433d-96ab-ff8002072467",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/fc9016ef-08bb-42cd-b22f-84f2ea824d5d"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/6526a951-8a27-433d-96ab-ff8002072467"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "6095ca55-71ce-4e0f-8d4c-08392b6612be",
      "status" : "PROVISIONING",
      "dataCenterId" : "5b578749-08fd-4a4d-8745-8a1e95682fa0",
      "zitiId" : "zitiEdgeRouterId01",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "2c61786b-c5e3-4660-bdb7-fc91b4e77815",
      "ownerIdentityId" : "1dbd11ac-1b46-4d40-91fc-dd603074bba6",
      "createdBy" : "1dbd11ac-1b46-4d40-91fc-dd603074bba6",
      "createdAt" : "2020-12-01T13:37:06.873853Z",
      "updatedAt" : "2020-12-01T13:37:06.873853Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME_edge_router_2020-12-01T13:37:06.873683Z",
      "id" : "d7f2cddf-00c0-4cf1-831a-a49e37acdb1c",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/6095ca55-71ce-4e0f-8d4c-08392b6612be"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/d7f2cddf-00c0-4cf1-831a-a49e37acdb1c"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "6095ca55-71ce-4e0f-8d4c-08392b6612be",
      "status" : "PROVISIONING",
      "dataCenterId" : "3d72812c-2344-42e7-ad6c-722aad3a3666",
      "zitiId" : "zitiEdgeRouterId02",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "81741521-99cd-4340-b1e9-bd03733f7e02",
      "ownerIdentityId" : "1dbd11ac-1b46-4d40-91fc-dd603074bba6",
      "createdBy" : "1dbd11ac-1b46-4d40-91fc-dd603074bba6",
      "createdAt" : "2020-12-01T13:37:06.874194Z",
      "updatedAt" : "2020-12-01T13:37:06.874194Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 02 2020-12-01T13:37:06.874027Z",
      "id" : "8d3e9081-aa82-4589-adb1-835fe9ee071f",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/6095ca55-71ce-4e0f-8d4c-08392b6612be"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/8d3e9081-aa82-4589-adb1-835fe9ee071f"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "6095ca55-71ce-4e0f-8d4c-08392b6612be",
      "status" : "PROVISIONING",
      "dataCenterId" : "8f3394c9-9c8f-4927-8d42-c8ee13e3c124",
      "zitiId" : "zitiEdgeRouterId03",
      "deletedAt" : null,
      "jwt" : "jwtdata",
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "51e616f9-6da5-4104-babb-6b3bbb0c3d17",
      "ownerIdentityId" : "1dbd11ac-1b46-4d40-91fc-dd603074bba6",
      "createdBy" : "1dbd11ac-1b46-4d40-91fc-dd603074bba6",
      "createdAt" : "2020-12-01T13:37:06.874523Z",
      "updatedAt" : "2020-12-01T13:37:06.874523Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 03 2020-12-01T13:37:06.874355Z",
      "id" : "12f4f190-4566-430c-a230-9a1e77e0a68c",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/6095ca55-71ce-4e0f-8d4c-08392b6612be"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/12f4f190-4566-430c-a230-9a1e77e0a68c"
        }
      }
    }, {
      "provider" : null,
      "networkId" : "6095ca55-71ce-4e0f-8d4c-08392b6612be",
      "status" : "NEW",
      "dataCenterId" : null,
      "zitiId" : "55c25ea1-b5af-4435-adc5-d9d06b4e4e8d",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : null,
      "locationMetadataId" : null,
      "ownerIdentityId" : "0a7309cb-dc26-41e0-9b7e-2304c6cfc16a",
      "createdBy" : "0a7309cb-dc26-41e0-9b7e-2304c6cfc16a",
      "createdAt" : "2020-12-01T13:37:06.970703Z",
      "updatedAt" : "2020-12-01T13:37:06.971781Z",
      "deletedBy" : null,
      "linkListener" : false,
      "online" : false,
      "verified" : false,
      "name" : "Test edge router 1606829826",
      "id" : "eb7dc1a5-1bca-4801-9d4e-d3402a670e7b",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/6095ca55-71ce-4e0f-8d4c-08392b6612be"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/eb7dc1a5-1bca-4801-9d4e-d3402a670e7b"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "90ca0154-765e-4cec-9ffb-f0e794f7684a",
      "status" : "PROVISIONING",
      "dataCenterId" : "35710879-ff7d-47a0-ad1d-af0deac2c526",
      "zitiId" : "zitiEdgeRouterId01",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "ba4de754-234a-4b76-9247-9567d1bebc0e",
      "ownerIdentityId" : "14c37b2d-d52e-431e-9f18-4dacdb1be66f",
      "createdBy" : "14c37b2d-d52e-431e-9f18-4dacdb1be66f",
      "createdAt" : "2020-12-01T13:37:07.016606Z",
      "updatedAt" : "2020-12-01T13:37:07.016606Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME_edge_router_2020-12-01T13:37:07.016399Z",
      "id" : "0b3457a2-ed49-435e-940a-45c31c0211ac",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/90ca0154-765e-4cec-9ffb-f0e794f7684a"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/0b3457a2-ed49-435e-940a-45c31c0211ac"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "90ca0154-765e-4cec-9ffb-f0e794f7684a",
      "status" : "PROVISIONING",
      "dataCenterId" : "3a850de4-d7fa-40ef-8c43-a712c06a1f8b",
      "zitiId" : "zitiEdgeRouterId02",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "4ab267bb-783d-42a3-9f37-a33e1c43e67a",
      "ownerIdentityId" : "14c37b2d-d52e-431e-9f18-4dacdb1be66f",
      "createdBy" : "14c37b2d-d52e-431e-9f18-4dacdb1be66f",
      "createdAt" : "2020-12-01T13:37:07.016958Z",
      "updatedAt" : "2020-12-01T13:37:07.016958Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 02 2020-12-01T13:37:07.016791Z",
      "id" : "7f19e9a6-a8ef-4517-93e2-3ac612e0c793",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/90ca0154-765e-4cec-9ffb-f0e794f7684a"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/7f19e9a6-a8ef-4517-93e2-3ac612e0c793"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "90ca0154-765e-4cec-9ffb-f0e794f7684a",
      "status" : "PROVISIONING",
      "dataCenterId" : "e150ee34-f99b-414a-9c15-c1afb7c257df",
      "zitiId" : "zitiEdgeRouterId03",
      "deletedAt" : null,
      "jwt" : "jwtdata",
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "600cd2cb-e02c-4abb-a847-5d53b1bace4d",
      "ownerIdentityId" : "14c37b2d-d52e-431e-9f18-4dacdb1be66f",
      "createdBy" : "14c37b2d-d52e-431e-9f18-4dacdb1be66f",
      "createdAt" : "2020-12-01T13:37:07.017289Z",
      "updatedAt" : "2020-12-01T13:37:07.017289Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 03 2020-12-01T13:37:07.017120Z",
      "id" : "8fff993e-b298-4e4f-9ed4-487afd5b721a",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/90ca0154-765e-4cec-9ffb-f0e794f7684a"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/8fff993e-b298-4e4f-9ed4-487afd5b721a"
        }
      }
    }, {
      "provider" : null,
      "networkId" : "90ca0154-765e-4cec-9ffb-f0e794f7684a",
      "status" : "NEW",
      "dataCenterId" : "25066e42-7351-4949-8340-aa39cb6724f3",
      "zitiId" : "3c15cf3e-f901-4273-9964-d110690f94fd",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : null,
      "locationMetadataId" : null,
      "ownerIdentityId" : "de36b991-67ce-46c4-aba1-7780fab1fb88",
      "createdBy" : "de36b991-67ce-46c4-aba1-7780fab1fb88",
      "createdAt" : "2020-12-01T13:37:07.028634Z",
      "updatedAt" : "2020-12-01T13:37:07.029303Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : false,
      "name" : "Test edge router 1606829827",
      "id" : "4b622099-2ec8-4aaf-82a3-7df41dd7cec8",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/90ca0154-765e-4cec-9ffb-f0e794f7684a"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/4b622099-2ec8-4aaf-82a3-7df41dd7cec8"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "8ec2701a-60b6-4afe-9dd8-c614533fc40e",
      "status" : "PROVISIONING",
      "dataCenterId" : "8f7e9019-e614-428a-954f-19312a663eb0",
      "zitiId" : "zitiEdgeRouterId01",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "da24924f-ab4b-4728-be24-3e4b8fddd42d",
      "ownerIdentityId" : "bbf1b914-2dac-4e3c-b2d1-a5371c9bb898",
      "createdBy" : "bbf1b914-2dac-4e3c-b2d1-a5371c9bb898",
      "createdAt" : "2020-12-01T13:37:07.063810Z",
      "updatedAt" : "2020-12-01T13:37:07.063810Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME_edge_router_2020-12-01T13:37:07.063637Z",
      "id" : "2ce5baa1-1df2-41f9-babb-cf2dedc4c5cf",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/8ec2701a-60b6-4afe-9dd8-c614533fc40e"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/2ce5baa1-1df2-41f9-babb-cf2dedc4c5cf"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "8ec2701a-60b6-4afe-9dd8-c614533fc40e",
      "status" : "PROVISIONING",
      "dataCenterId" : "6f27c4f0-a518-4a88-bffc-4484c89fd621",
      "zitiId" : "zitiEdgeRouterId02",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "32835580-8b72-42be-8348-dd16db2999ff",
      "ownerIdentityId" : "bbf1b914-2dac-4e3c-b2d1-a5371c9bb898",
      "createdBy" : "bbf1b914-2dac-4e3c-b2d1-a5371c9bb898",
      "createdAt" : "2020-12-01T13:37:07.064168Z",
      "updatedAt" : "2020-12-01T13:37:07.064168Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 02 2020-12-01T13:37:07.063988Z",
      "id" : "7bd5dd3b-fe71-4e4f-93ea-38daf855ed98",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/8ec2701a-60b6-4afe-9dd8-c614533fc40e"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/7bd5dd3b-fe71-4e4f-93ea-38daf855ed98"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "8ec2701a-60b6-4afe-9dd8-c614533fc40e",
      "status" : "PROVISIONING",
      "dataCenterId" : "cbf00a8d-52f6-4398-9116-0d417ceea028",
      "zitiId" : "zitiEdgeRouterId03",
      "deletedAt" : null,
      "jwt" : "jwtdata",
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "7b4db7e7-d926-48bf-a34d-9020d0aacffe",
      "ownerIdentityId" : "bbf1b914-2dac-4e3c-b2d1-a5371c9bb898",
      "createdBy" : "bbf1b914-2dac-4e3c-b2d1-a5371c9bb898",
      "createdAt" : "2020-12-01T13:37:07.064517Z",
      "updatedAt" : "2020-12-01T13:37:07.064517Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 03 2020-12-01T13:37:07.064336Z",
      "id" : "97043265-789b-459b-ac1e-c8dbbb334c4a",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/8ec2701a-60b6-4afe-9dd8-c614533fc40e"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/97043265-789b-459b-ac1e-c8dbbb334c4a"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "d5974aee-1d96-4178-ab20-f86ec6661459",
      "status" : "PROVISIONING",
      "dataCenterId" : "b2a0156c-a50b-4c36-b351-c31d47c0419b",
      "zitiId" : "zitiEdgeRouterId01",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "0759e457-d0d2-4c90-a605-b6f1d514a95f",
      "ownerIdentityId" : "b1f6379d-66d8-48a6-8a4d-a3b348b2013c",
      "createdBy" : "b1f6379d-66d8-48a6-8a4d-a3b348b2013c",
      "createdAt" : "2020-12-01T13:37:07.100280Z",
      "updatedAt" : "2020-12-01T13:37:07.100280Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME_edge_router_2020-12-01T13:37:07.100104Z",
      "id" : "35359246-ce05-416e-8360-6dd8131dac8c",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/d5974aee-1d96-4178-ab20-f86ec6661459"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/35359246-ce05-416e-8360-6dd8131dac8c"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "d5974aee-1d96-4178-ab20-f86ec6661459",
      "status" : "DELETING",
      "dataCenterId" : "497300af-e3fd-427d-962f-58a675816f1b",
      "zitiId" : "zitiEdgeRouterId02",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "23c9cc92-c421-4565-930e-dae388634495",
      "ownerIdentityId" : "b1f6379d-66d8-48a6-8a4d-a3b348b2013c",
      "createdBy" : "b1f6379d-66d8-48a6-8a4d-a3b348b2013c",
      "createdAt" : "2020-12-01T13:37:07.100655Z",
      "updatedAt" : "2020-12-01T13:37:07.110136Z",
      "deletedBy" : "456debe0-6e58-477f-870f-765552023072",
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 02 2020-12-01T13:37:07.100478Z",
      "id" : "20b4f279-da30-472a-98fa-97fa1bd6073e",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/d5974aee-1d96-4178-ab20-f86ec6661459"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/20b4f279-da30-472a-98fa-97fa1bd6073e"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "d5974aee-1d96-4178-ab20-f86ec6661459",
      "status" : "PROVISIONING",
      "dataCenterId" : "6440685f-3a27-4e27-9aa2-0374c0955bb2",
      "zitiId" : "zitiEdgeRouterId03",
      "deletedAt" : null,
      "jwt" : "jwtdata",
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "92af1667-482e-4474-80d1-dab73e4a31f6",
      "ownerIdentityId" : "b1f6379d-66d8-48a6-8a4d-a3b348b2013c",
      "createdBy" : "b1f6379d-66d8-48a6-8a4d-a3b348b2013c",
      "createdAt" : "2020-12-01T13:37:07.100984Z",
      "updatedAt" : "2020-12-01T13:37:07.100984Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 03 2020-12-01T13:37:07.100823Z",
      "id" : "5b4a3c16-9a67-46a1-a4a7-cfcc0f70654c",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/d5974aee-1d96-4178-ab20-f86ec6661459"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/5b4a3c16-9a67-46a1-a4a7-cfcc0f70654c"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "ae6317a0-9b11-4d79-9be5-4819eec0760d",
      "status" : "PROVISIONING",
      "dataCenterId" : "ff2dcd0d-bc39-4c96-ab1e-d3249009c378",
      "zitiId" : "zitiEdgeRouterId01",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "cbf68482-cb1e-4897-a0bf-1cbfe41dc683",
      "ownerIdentityId" : "176511f4-78bf-4ecc-80ee-174c10e03457",
      "createdBy" : "176511f4-78bf-4ecc-80ee-174c10e03457",
      "createdAt" : "2020-12-01T13:37:07.143485Z",
      "updatedAt" : "2020-12-01T13:37:07.143485Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME_edge_router_2020-12-01T13:37:07.143313Z",
      "id" : "2b1c194e-4480-423b-b06b-75baab74ca0b",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/ae6317a0-9b11-4d79-9be5-4819eec0760d"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/2b1c194e-4480-423b-b06b-75baab74ca0b"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "ae6317a0-9b11-4d79-9be5-4819eec0760d",
      "status" : "PROVISIONING",
      "dataCenterId" : "49a2c6ee-b538-4b00-9334-bc5ebf13b26c",
      "zitiId" : "zitiEdgeRouterId02",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "308c8ba9-e912-4b22-9fb0-24e0a0eb6cfa",
      "ownerIdentityId" : "176511f4-78bf-4ecc-80ee-174c10e03457",
      "createdBy" : "176511f4-78bf-4ecc-80ee-174c10e03457",
      "createdAt" : "2020-12-01T13:37:07.143827Z",
      "updatedAt" : "2020-12-01T13:37:07.143827Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 02 2020-12-01T13:37:07.143665Z",
      "id" : "470d0f93-d0fc-4add-979b-f45ddbbf4e14",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/ae6317a0-9b11-4d79-9be5-4819eec0760d"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/470d0f93-d0fc-4add-979b-f45ddbbf4e14"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "ae6317a0-9b11-4d79-9be5-4819eec0760d",
      "status" : "PROVISIONING",
      "dataCenterId" : "54f86ebc-9d41-4412-a628-49727a9148c2",
      "zitiId" : "zitiEdgeRouterId03",
      "deletedAt" : null,
      "jwt" : "jwtdata",
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "aa309e9a-c5da-4fd6-8855-1f4706285e4b",
      "ownerIdentityId" : "176511f4-78bf-4ecc-80ee-174c10e03457",
      "createdBy" : "176511f4-78bf-4ecc-80ee-174c10e03457",
      "createdAt" : "2020-12-01T13:37:07.144162Z",
      "updatedAt" : "2020-12-01T13:37:07.144162Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 03 2020-12-01T13:37:07.143997Z",
      "id" : "57650104-cb7b-4417-abd1-5e4de4dd2ddd",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/ae6317a0-9b11-4d79-9be5-4819eec0760d"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/57650104-cb7b-4417-abd1-5e4de4dd2ddd"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "b5ff0102-3906-4357-a434-a789a0e6c22c",
      "status" : "PROVISIONING",
      "dataCenterId" : "9ebd5750-e364-425c-a905-172f4e7ca534",
      "zitiId" : "zitiEdgeRouterId01",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "87d58977-0c90-4b45-9307-e9ca22cc7417",
      "ownerIdentityId" : "7aa65867-0987-40f9-b931-417510e5bee7",
      "createdBy" : "7aa65867-0987-40f9-b931-417510e5bee7",
      "createdAt" : "2020-12-01T13:37:07.177154Z",
      "updatedAt" : "2020-12-01T13:37:07.177154Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME_edge_router_2020-12-01T13:37:07.176964Z",
      "id" : "6db02629-781c-43a6-bd98-0495a9fc4520",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/b5ff0102-3906-4357-a434-a789a0e6c22c"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/6db02629-781c-43a6-bd98-0495a9fc4520"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "b5ff0102-3906-4357-a434-a789a0e6c22c",
      "status" : "PROVISIONING",
      "dataCenterId" : "f348da4f-adc8-40a3-b9a6-c292528fcf75",
      "zitiId" : "zitiEdgeRouterId02",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "c9342dc3-42cc-4b81-bb40-ab52ac9f193d",
      "ownerIdentityId" : "7aa65867-0987-40f9-b931-417510e5bee7",
      "createdBy" : "7aa65867-0987-40f9-b931-417510e5bee7",
      "createdAt" : "2020-12-01T13:37:07.177503Z",
      "updatedAt" : "2020-12-01T13:37:07.177503Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 02 2020-12-01T13:37:07.177332Z",
      "id" : "90d55e9b-dc5d-4ec1-93ec-eab7291fda18",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/b5ff0102-3906-4357-a434-a789a0e6c22c"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/90d55e9b-dc5d-4ec1-93ec-eab7291fda18"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "b5ff0102-3906-4357-a434-a789a0e6c22c",
      "status" : "PROVISIONING",
      "dataCenterId" : "be585558-8974-440d-9a85-d61f3f82d82e",
      "zitiId" : "zitiEdgeRouterId03",
      "deletedAt" : null,
      "jwt" : "jwtdata",
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "f85ff3e4-6fac-4fae-8a5e-db572b1fc9b2",
      "ownerIdentityId" : "7aa65867-0987-40f9-b931-417510e5bee7",
      "createdBy" : "7aa65867-0987-40f9-b931-417510e5bee7",
      "createdAt" : "2020-12-01T13:37:07.177828Z",
      "updatedAt" : "2020-12-01T13:37:07.177828Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 03 2020-12-01T13:37:07.177669Z",
      "id" : "c2ca03e3-02a0-40fe-b4a1-3ed047c3e36d",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/b5ff0102-3906-4357-a434-a789a0e6c22c"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/c2ca03e3-02a0-40fe-b4a1-3ed047c3e36d"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "72e32b46-6dff-4024-b08d-6857adac14cd",
      "status" : "PROVISIONING",
      "dataCenterId" : "0903ce5b-33a4-4938-86a4-7693c0586c3d",
      "zitiId" : "zitiEdgeRouterId01",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "63e57b4a-e0e7-4a61-af3c-906cb9fade0e",
      "ownerIdentityId" : "b9f5572c-f0d7-494c-8342-10db290e7bd0",
      "createdBy" : "b9f5572c-f0d7-494c-8342-10db290e7bd0",
      "createdAt" : "2020-12-01T13:37:07.210576Z",
      "updatedAt" : "2020-12-01T13:37:07.227548Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "Updated name",
      "id" : "49bf4695-03c3-4a41-aa8a-373dbb7cd78b",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/72e32b46-6dff-4024-b08d-6857adac14cd"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/49bf4695-03c3-4a41-aa8a-373dbb7cd78b"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "72e32b46-6dff-4024-b08d-6857adac14cd",
      "status" : "PROVISIONING",
      "dataCenterId" : "7f7b69aa-b63b-4a9f-b8b6-9db3c7509136",
      "zitiId" : "zitiEdgeRouterId02",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "201ba360-e4b7-4c2b-afb2-fc6b07582c36",
      "ownerIdentityId" : "b9f5572c-f0d7-494c-8342-10db290e7bd0",
      "createdBy" : "b9f5572c-f0d7-494c-8342-10db290e7bd0",
      "createdAt" : "2020-12-01T13:37:07.210932Z",
      "updatedAt" : "2020-12-01T13:37:07.210932Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 02 2020-12-01T13:37:07.210765Z",
      "id" : "128b3e2f-2b46-4d8c-ad36-496bfe90e2c3",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/72e32b46-6dff-4024-b08d-6857adac14cd"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/128b3e2f-2b46-4d8c-ad36-496bfe90e2c3"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "72e32b46-6dff-4024-b08d-6857adac14cd",
      "status" : "PROVISIONING",
      "dataCenterId" : "04a848e8-fdda-4709-b313-51ef7d245cc1",
      "zitiId" : "zitiEdgeRouterId03",
      "deletedAt" : null,
      "jwt" : "jwtdata",
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "d5cd6d97-3e44-4fd7-8da7-e45918c6be70",
      "ownerIdentityId" : "b9f5572c-f0d7-494c-8342-10db290e7bd0",
      "createdBy" : "b9f5572c-f0d7-494c-8342-10db290e7bd0",
      "createdAt" : "2020-12-01T13:37:07.211264Z",
      "updatedAt" : "2020-12-01T13:37:07.211264Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 03 2020-12-01T13:37:07.211101Z",
      "id" : "947606ef-0bd3-4ccf-a716-c37107afb12e",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/72e32b46-6dff-4024-b08d-6857adac14cd"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/947606ef-0bd3-4ccf-a716-c37107afb12e"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "dfc92c87-1912-4a0e-8cd9-9e45f5545111",
      "status" : "PROVISIONING",
      "dataCenterId" : "02a84066-09d8-4cf8-93ce-0eb75bc20bdc",
      "zitiId" : "zitiEdgeRouterId01",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "3de9a878-a13e-4bbe-bef6-76c53e5d8065",
      "ownerIdentityId" : "7092dcfd-d526-4132-bdec-5dfc1befe53f",
      "createdBy" : "7092dcfd-d526-4132-bdec-5dfc1befe53f",
      "createdAt" : "2020-12-01T13:37:07.263064Z",
      "updatedAt" : "2020-12-01T13:37:07.263064Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME_edge_router_2020-12-01T13:37:07.262878Z",
      "id" : "37304789-79d2-44bd-9b92-3760b8b21451",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/dfc92c87-1912-4a0e-8cd9-9e45f5545111"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/37304789-79d2-44bd-9b92-3760b8b21451"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "dfc92c87-1912-4a0e-8cd9-9e45f5545111",
      "status" : "PROVISIONING",
      "dataCenterId" : "9a25ffc4-47f9-4ce0-b197-7e400e3db528",
      "zitiId" : "zitiEdgeRouterId02",
      "deletedAt" : null,
      "jwt" : null,
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "8ad7b1a9-192f-49f8-bf26-e990c8424f9f",
      "ownerIdentityId" : "7092dcfd-d526-4132-bdec-5dfc1befe53f",
      "createdBy" : "7092dcfd-d526-4132-bdec-5dfc1befe53f",
      "createdAt" : "2020-12-01T13:37:07.263420Z",
      "updatedAt" : "2020-12-01T13:37:07.263420Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 02 2020-12-01T13:37:07.263256Z",
      "id" : "a5253bac-3f32-4d7b-a95c-3cdc0c1f1c06",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/dfc92c87-1912-4a0e-8cd9-9e45f5545111"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/a5253bac-3f32-4d7b-a95c-3cdc0c1f1c06"
        }
      }
    }, {
      "provider" : "AWS",
      "networkId" : "dfc92c87-1912-4a0e-8cd9-9e45f5545111",
      "status" : "PROVISIONING",
      "dataCenterId" : "d1b71697-a309-417e-951a-3bfd4c8a8b48",
      "zitiId" : "zitiEdgeRouterId03",
      "deletedAt" : null,
      "jwt" : "jwtdata",
      "ipAddress" : "1.2.3.4",
      "locationMetadataId" : "0aed3653-58f9-4076-860f-162cf10bf46b",
      "ownerIdentityId" : "7092dcfd-d526-4132-bdec-5dfc1befe53f",
      "createdBy" : "7092dcfd-d526-4132-bdec-5dfc1befe53f",
      "createdAt" : "2020-12-01T13:37:07.263778Z",
      "updatedAt" : "2020-12-01T13:37:07.263778Z",
      "deletedBy" : null,
      "linkListener" : true,
      "online" : false,
      "verified" : true,
      "name" : "ACME edge router 03 2020-12-01T13:37:07.263616Z",
      "id" : "7b4748a7-7a99-45a5-9592-43dc313dad31",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/dfc92c87-1912-4a0e-8cd9-9e45f5545111"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/7b4748a7-7a99-45a5-9592-43dc313dad31"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers"
    }
  },
  "page" : {
    "size" : 2000,
    "totalElements" : 50,
    "totalPages" : 1,
    "number" : 0
  }
}

Get Edge Router

GET /edge-routers/{id}

Authorization

This endpoint requires read action on the edge-router resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

provider

String

true

networkId

String

false

status

String

true

dataCenterId

String

true

zitiId

String

true

deletedAt

String

true

jwt

String

true

ipAddress

String

true

locationMetadataId

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

linkListener

Boolean

true

online

Boolean

true

verified

Boolean

true

name

String

false

id

String

true

attributes

Array[String]

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/edge-routers/42a458b4-d41c-416c-b7fe-0b11ff8e6c38' -i -X GET \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJsaGltQ1g2S2xsdXhnd2t6elNVQmNRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjRjNjM4MTkxLTA5NTgtNGU3Yy1iNGE1LTJjODQ4NWExMTI0MyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgyNywiZXhwIjoxNjA2ODMzNDI3LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcImE5YjVmODU0LWM2YjgtNGI5Ni05MDMyLTcyMmUyYjIwZjM4Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgyN31dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.p9HJndshEXZg1AkRZaZAC16zIAwL-pntJZ1C-7a7CVmpcehaILy7FbRKJeV2NXof8q9LvrBXsjOe_JA7mIPNj_TwEsQJX3UdydX4-Rk7GqL_UfJQ2mAsgtuNu2q2nYPYYuj-f7iiTA3ifiggP74ft76pS231opy-hO3hczU04nSZsDcKqHWrjxaSbElK72PttL6tW4PZvl21tRSZsdRaZ9GDcimc0VMsuWh2yvIMu6p8wcYqV_SaqEo5JFv4mkMh9VQi7mOlmqC5p2miLo4f8GcKkbQCYVJ8qxbjNN9Tx8v99PuqqcV6cVD0DZ99_uq00fn0RuPOAEzwxfPqtam0kg'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 1057

{
  "provider" : "AWS",
  "networkId" : "11f7a500-fea6-4f9e-8050-f99a864b6498",
  "status" : "PROVISIONING",
  "dataCenterId" : "daa5d709-f80a-4e20-af12-8384ef5b309b",
  "zitiId" : "zitiEdgeRouterId01",
  "deletedAt" : null,
  "jwt" : null,
  "ipAddress" : "1.2.3.4",
  "locationMetadataId" : "4df873be-29b1-4919-a469-3e7b7e039f62",
  "ownerIdentityId" : "93d659a7-4d96-487e-bb37-44b2d49a49ea",
  "createdBy" : "93d659a7-4d96-487e-bb37-44b2d49a49ea",
  "createdAt" : "2020-12-01T13:37:07.416237Z",
  "updatedAt" : "2020-12-01T13:37:07.416237Z",
  "deletedBy" : null,
  "linkListener" : true,
  "online" : false,
  "verified" : true,
  "name" : "ACME_edge_router_2020-12-01T13:37:07.416062Z",
  "id" : "42a458b4-d41c-416c-b7fe-0b11ff8e6c38",
  "attributes" : [ ],
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/11f7a500-fea6-4f9e-8050-f99a864b6498"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/42a458b4-d41c-416c-b7fe-0b11ff8e6c38"
    }
  }
}

Create Edge Router

POST /edge-routers/

Authorization

This endpoint requires create action on the edge-router resource type.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

name

String

true

networkId

String

true

Client must have create action under the annotated resource.

dataCenterId

String

true

linkListener

Boolean

true

attributes

Array[String]

true

Response fields

Path Type Optional Description

provider

String

true

networkId

String

false

status

String

true

dataCenterId

String

true

zitiId

String

true

deletedAt

String

true

jwt

String

true

ipAddress

String

true

locationMetadataId

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

linkListener

Boolean

true

online

Boolean

true

verified

Boolean

true

name

String

false

id

String

true

attributes

Array[String]

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/edge-routers/' -i -X POST \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIwNmliaHUtRi1SZGUwRTFpSWZkQ25BIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjBhNzMwOWNiLWRjMjYtNDFlMC05YjdlLTIzMDRjNmNmYzE2YSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgyNiwiZXhwIjoxNjA2ODMzNDI2LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjNiZTlmNDZlLTI3ZDAtNDAyYy1hMTFhLTdkM2VlNDAzYjVhZFwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgyNn1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.RXBGzvdfC5EWkOumqe4ZucomxNSbS_rppeFlI1pXtiuST56znJPt-kQgEFk277muNNz1ZhIk7cs6EE_YAtKmfyqJiAUZz6Tpy8fiY1WtQ7hkP3MNeuyCT47yyNNfGH89Skr8hXIFonOouIhhkXJ8FQbMiDDURpJn-rCq0uFd2ctE3TIuwrVOGarw5txP81FaN90Xn6_l3qhcVync6-3JaLHg-MSLZoGOzRIniRlUO5aqhkuHgDi_UVgJZ-tTdVLxkmyjtOVbGuddkjiLQ4ldEUpT9kA18CFOraVzGcperjouaqfemkE_WHb1meFyc5HNV6LP8_04BQA7ovfdRZ86Mw' \
    -d '{"name":"Test edge router 1606829826","networkId":"6095ca55-71ce-4e0f-8d4c-08392b6612be","dataCenterId":null,"linkListener":false,"attributes":[]}'

Example response

HTTP/1.1 202 Accepted
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 977

{
  "provider" : null,
  "networkId" : "6095ca55-71ce-4e0f-8d4c-08392b6612be",
  "status" : "NEW",
  "dataCenterId" : null,
  "zitiId" : "55c25ea1-b5af-4435-adc5-d9d06b4e4e8d",
  "deletedAt" : null,
  "jwt" : null,
  "ipAddress" : null,
  "locationMetadataId" : null,
  "ownerIdentityId" : "0a7309cb-dc26-41e0-9b7e-2304c6cfc16a",
  "createdBy" : "0a7309cb-dc26-41e0-9b7e-2304c6cfc16a",
  "createdAt" : "2020-12-01T13:37:06.970703Z",
  "updatedAt" : "2020-12-01T13:37:06.971781Z",
  "deletedBy" : null,
  "linkListener" : false,
  "online" : false,
  "verified" : false,
  "name" : "Test edge router 1606829826",
  "id" : "eb7dc1a5-1bca-4801-9d4e-d3402a670e7b",
  "attributes" : [ ],
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/6095ca55-71ce-4e0f-8d4c-08392b6612be"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/eb7dc1a5-1bca-4801-9d4e-d3402a670e7b"
    }
  }
}

Patch Edge Router

PATCH /edge-routers/{id}

Authorization

This endpoint requires update action on the edge-router resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have update action on the annotated resource.

Query parameters

No parameters.

Request fields

Path Type Optional Description

name

String

true

attributes

Array[String]

true

Response fields

Path Type Optional Description

provider

String

true

networkId

String

false

status

String

true

dataCenterId

String

true

zitiId

String

true

deletedAt

String

true

jwt

String

true

ipAddress

String

true

locationMetadataId

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

linkListener

Boolean

true

online

Boolean

true

verified

Boolean

true

name

String

false

id

String

true

attributes

Array[String]

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/edge-routers/3ce98abc-20a7-4764-a56d-009ce9169982' -i -X PATCH \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJFdm81eWFaLXpnWjFvU2F1TVZZd05nIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImFmYzFlNjJhLWI2ZDQtNGNlMi1iMzgyLTliM2M2ODg1YTBkNCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgyNywiZXhwIjoxNjA2ODMzNDI3LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcImFjNDE0ZDJjLWI2MjQtNGVlYS04NzVhLTljNjczOGUyOGVkY1wiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgyN31dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.kLvCPWNisTeLluf91hXNT-fI0apw5Rz06JEoBIsiUGxUQUXVLcmEePH2BoDdvyZ2JhKWrUat6J-2oaiAzVrDNNRufJXFmH3dWRRgACOWaMkziuK3JA284-AMUO4gWpBVyOoBTUYs34WzNtOSSZprdQANJIf557f0erlt4M6tR7u7Y8IfbAcuoLfD0ErEe0NMsXSLNMvE2A55NFPzb1HyVd6YUAtDV0HlFxY32llftGGL8s_CiVwto7eXTMdBfnEonBA2AVVUuJm9-wqVFYquSYoeE1UPcBdGxoGdE5myv5ntLxdGRdXihl8FHjykGvpflw9t_PA8nQn8f-kDfHn56A' \
    -d '{"name":"Updated name","attributes":null}'

Example response

HTTP/1.1 202 Accepted
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 1025

{
  "provider" : "AWS",
  "networkId" : "15aa16b5-ba39-4207-8236-232181420029",
  "status" : "PROVISIONING",
  "dataCenterId" : "78f84d67-85ff-4acd-8eb4-191fb0f7fd89",
  "zitiId" : "zitiEdgeRouterId01",
  "deletedAt" : null,
  "jwt" : null,
  "ipAddress" : "1.2.3.4",
  "locationMetadataId" : "ccfc53ca-158a-42da-a289-d3f45747f951",
  "ownerIdentityId" : "2fded387-bd62-4f06-9909-473603a3e110",
  "createdBy" : "2fded387-bd62-4f06-9909-473603a3e110",
  "createdAt" : "2020-12-01T13:37:07.371930Z",
  "updatedAt" : "2020-12-01T13:37:07.382630Z",
  "deletedBy" : null,
  "linkListener" : true,
  "online" : false,
  "verified" : true,
  "name" : "Updated name",
  "id" : "3ce98abc-20a7-4764-a56d-009ce9169982",
  "attributes" : [ ],
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/15aa16b5-ba39-4207-8236-232181420029"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/edge-routers/3ce98abc-20a7-4764-a56d-009ce9169982"
    }
  }
}

Delete Edge Router

DELETE /edge-routers/{id}

Authorization

This endpoint requires delete action on the edge-router resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have delete action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

No links.

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/edge-routers/20b4f279-da30-472a-98fa-97fa1bd6073e' -i -X DELETE \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIzbXN6cU9iR1FiUFBXbmtMQUpxQ2pRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjQ1NmRlYmUwLTZlNTgtNDc3Zi04NzBmLTc2NTU1MjAyMzA3MiIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgyNywiZXhwIjoxNjA2ODMzNDI3LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjg0ZjU3OWQ1LTliZTAtNDBlNy05MjRjLTkxZjdhZWI4YzUwNFwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgyN31dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.RMvRX8wcvS5ZFmMUPxDykZCrFjORPq6MuotyAZwkhCbeiTU2-l6qMowFKnv5P5niYnK95WkCJcl7MiXRKPSN_K3Di5TPw9aPl-LOG_CwWb7jDZIMBddylfq_Y5_koZLb5_otme4T_F6hjDmmS_o9qJtWm27Bkugf-_X59jXrrvNyT32DrQVRX_qqQQDTGFRSQsfAH0oLUK34BA7xI7qexHpwFa4ZnlL6LK6X_l7OGSquZGv9iB1iplVFz8Fwyuq7h4Ut9ViL0Q0-fLeYV7FW8uCqhR8ZLsTShXuDQGj09_l8rmEOSK8ZcFKSmshzmjo_OMVtDZIVtp-kitKpleovlg'

Example response

HTTP/1.1 200 OK

Edge Router Policies

Find Edge Router Policies

GET /edge-router-policies

Authorization

This endpoint requires read action on the edge-router-policy resource type.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

networkId

Object

true

name

String

true

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

networkId

String

false

deletedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

edgeRouterAttributes

Array[String]

true

endpointAttributes

Array[String]

true

name

String

false

id

String

true

Path Optional Description

self

false

network

false

Embedded resources

Path Type Optional Description

networkId

String

false

deletedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

edgeRouterAttributes

Array[String]

true

endpointAttributes

Array[String]

true

name

String

false

id

String

true

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/edge-router-policies' -i -X GET \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJBR1RhMjdSZEE0V3Z5elRpQUk0dkRRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImVjZWMyNmFlLTdmNDktNGM2OS04ZWEwLTg2MGViMmNmODI1NiIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgwMSwiZXhwIjoxNjA2ODMzNDAxLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcImYxZjQ5NDg2LTcwYmQtNGJmMi1hYTE4LTY0YzFkYzcwZjNkZVwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgwMX1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.V1joG2y9IXjoSwNz5lD_cvDxRzKj64D2mUmXuNh1RKLS9XRk9J4UDiHubBcL1kf4d9TFXfwbZjf9K5mtqBebn38j43KsW4vJodhLIlVXE6cQUbZ7yZYnbAiKfmTCZ-iAKTmW5AU8s5QjxkoLISFPAmXbrDPFZZSxJj4mWwd1aU3YsJ8BD7_WPKg7oSZaQTW6oOM-9PxoCIo3X-9LbFfbgiIpxAH-bgK-7Y7U59MzeZuTfKwdJThI9p4YionjXBX7WNVNwSbN1_45j65X08Vr70RKuDxlxO0F9lX0ywOpAib1uyi761BZh1xaekHwdwCc4CPcAfuFN8ZfY6BCpVAkYA'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 1093

{
  "_embedded" : {
    "edgeRouterPolicyList" : [ {
      "networkId" : "223d1481-21b5-4f28-b28a-a1d08e5c9ed7",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:36:41.516355Z",
      "updatedAt" : "2020-12-01T13:36:41.516355Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "endpointAttributes" : [ ],
      "name" : "ACME edge router policy 2020-12-01T13:36:41.516141Z",
      "id" : "c5cb0db8-7221-4049-9a0e-b2892ccc0a87",
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/223d1481-21b5-4f28-b28a-a1d08e5c9ed7"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/edge-router-policies/c5cb0db8-7221-4049-9a0e-b2892ccc0a87"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/edge-router-policies"
    }
  },
  "page" : {
    "size" : 2000,
    "totalElements" : 1,
    "totalPages" : 1,
    "number" : 0
  }
}

Get Edge Router Policy

GET /edge-router-policies/{id}

Authorization

This endpoint requires read action on the edge-router-policy resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

networkId

String

false

deletedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

edgeRouterAttributes

Array[String]

true

endpointAttributes

Array[String]

true

name

String

false

id

String

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/edge-router-policies/cb829c53-39b7-4af3-b368-a85aa501345d' -i -X GET \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJ2TUtSdnlxMEpGNWtfX0Jwd1FTWHJRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjIwZjllYjNhLTQzZDgtNDM4Mi04M2M4LWRhY2U2Mjc5NDc2ZSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgwMSwiZXhwIjoxNjA2ODMzNDAxLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjJmM2M2MjhiLWMzYjgtNGY5Ny1hNWYzLTY1ODM4NmMwZTYyY1wiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgwMX1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.ebM0LKVyfoFdSE1Dmxe7QLhkhxNwNSih7AC14p_GzQ04MK_UY-BuM-SH2a2CkK1vylnQ1tKHQogTTQe1yX9yhbFgMWui-T7kcsoltNrb8YnEm5gRC3soaModuZ3db4u7ZUb7L2uGy33SdIvWZBwXYgUdwEPuPoUDOEdbr4IdvwhioUEHaMnMtAJNH-C4OeiLNOlQlilrh4QvdhKdTAJpZGlYIzV-ylewKBMm3iLzw5h_EZ0GQBPXbyOwT0aGx4H3HQFTpYSaLfFSsrKfnoNMKk7DAeR9zMV5W9na9rWtVkE40OgM73Uc3yc_6dYJJLQHQbQM5IfRSfpa38HDmqolkg'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 725

{
  "networkId" : "f8c9228a-8b3b-46be-83d4-8f0e76b9873c",
  "deletedAt" : null,
  "ownerIdentityId" : null,
  "createdBy" : null,
  "createdAt" : "2020-12-01T13:36:41.685735Z",
  "updatedAt" : "2020-12-01T13:36:41.685735Z",
  "deletedBy" : null,
  "edgeRouterAttributes" : [ ],
  "endpointAttributes" : [ ],
  "name" : "ACME edge router policy 2020-12-01T13:36:41.685579Z",
  "id" : "cb829c53-39b7-4af3-b368-a85aa501345d",
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/f8c9228a-8b3b-46be-83d4-8f0e76b9873c"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/edge-router-policies/cb829c53-39b7-4af3-b368-a85aa501345d"
    }
  }
}

Create Edge Router Policy

POST /edge-router-policies

Authorization

This endpoint requires create action on the edge-router-policy resource type.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

name

String

true

networkId

String

true

Client must have create action under the annotated resource.

endpointAttributes

Array[String]

true

edgeRouterAttributes

Array[String]

true

Response fields

Path Type Optional Description

networkId

String

false

deletedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

edgeRouterAttributes

Array[String]

true

endpointAttributes

Array[String]

true

name

String

false

id

String

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/edge-router-policies' -i -X POST \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJ6S0hUVlNjOWVVU2plQkh3MFE1S1dnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImRiOTUxYzFhLWE2NzQtNDYzYy1hYzg0LWJiNjM5MDY2ZTNjNyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgwMSwiZXhwIjoxNjA2ODMzNDAxLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcImVmYjMyMmI2LTgxN2EtNDRmMC04MDEzLTVmODNmNGE4ZjJiZVwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgwMX1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.pMRuQtFQnFsNaw1JU9HVFX0ODLeih_jFf1ztxMYx5vNOZBAbkiFg5IDIHHN0FTq0BSpI8TFxigW4ucrThgil6M1JxsDWTufscmGAT5UzwBLjUroc7EIWJeZ83Gh-8A5Slv7YDwp7ZlOwkNncVD5toupWVRt97eECbceR5MawBaej72sFHptE3LAOi1ovbl_tsoTKS6GJ4tq4vCmVYuPozrEiPw_cff8uFsa5NvI-pTQvFjcxkkH4sTTCtFtNUnmct8CzaNy4Ql9_wTvbMjY84ODMbqtJHjf9-crpAt41llTjlPP-0vOap1ufgVVYbpVZCHvPBFQf0B8TTgtjppEZmQ' \
    -d '{"name":"Test edge router policy 1606829801","networkId":"533499cf-1543-40d2-baac-54a87b5803f9","endpointAttributes":["#topclients"],"edgeRouterAttributes":["#westrouters","@ACME_edge_router_2020-12-01T13:36:41.601616Z"]}'

Example response

HTTP/1.1 202 Accepted
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 854

{
  "networkId" : "533499cf-1543-40d2-baac-54a87b5803f9",
  "deletedAt" : null,
  "ownerIdentityId" : "db951c1a-a674-463c-ac84-bb639066e3c7",
  "createdBy" : "db951c1a-a674-463c-ac84-bb639066e3c7",
  "createdAt" : "2020-12-01T13:36:41.631254Z",
  "updatedAt" : "2020-12-01T13:36:41.634467Z",
  "deletedBy" : null,
  "edgeRouterAttributes" : [ "#westrouters", "@ACME_edge_router_2020-12-01T13:36:41.601616Z" ],
  "endpointAttributes" : [ "#topclients" ],
  "name" : "Test edge router policy 1606829801",
  "id" : "9c967fdb-0991-4309-b7c6-c67ff56f3d27",
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/533499cf-1543-40d2-baac-54a87b5803f9"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/edge-router-policies/9c967fdb-0991-4309-b7c6-c67ff56f3d27"
    }
  }
}

Update Edge Router Policy

PUT /edge-router-policies/{id}

Authorization

This endpoint requires update action on the edge-router-policy resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have update action on the annotated resource.

Query parameters

No parameters.

Request fields

Path Type Optional Description

name

String

true

networkId

String

true

endpointAttributes

Array[String]

true

edgeRouterAttributes

Array[String]

true

Response fields

Path Type Optional Description

networkId

String

false

deletedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

edgeRouterAttributes

Array[String]

true

endpointAttributes

Array[String]

true

name

String

false

id

String

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/edge-router-policies/f5ab8af5-5561-4bdf-b955-396750c6e05e' -i -X PUT \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJkMDI0b1QwQTdYRTY2Z0FzN3IydW5RIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjIyMDlhYzhiLWQxMzAtNDNmYy1iYTNmLWUzNDM1MThjMTI4NCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgwMSwiZXhwIjoxNjA2ODMzNDAxLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjFmZDQzY2Q4LTE1ZDItNGMxOS1hN2ZkLTI5NGEyZTAxM2UxNVwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgwMX1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.cxkhmB9Qou9_77E4h2zUVO3vTKF1zxuP_jWS8OFN5_EFqowsguxwnMThzbRv_4xvygpKBXa3UI8tXBLT9uJ-f9jgrGjoQOEHyfBB0HbHNowm6QvMfHanIqC7uD3qzhyRnx9M_trvM1QivFYZJWZQiO-CwW1IU8yBlaRarIL4PvnXG2_PBziIF-rEyclnAbV2h9pa4ZambiTTIyJOZlyrWPlc44fwXXAAoh4K_H0qGFBxXZQsimPtTPIMkWlHcPlKz9efE8E7cSXQIoRmwcWgLwTy8bvr6X3N7Ak0AzhOWsIVEOij9bnXAZCl2MXO1m2omz8salJ3JzsJmQpq8Y0_xw' \
    -d '{"name":"Updated edge router policy name","networkId":"198fa14c-0937-4082-ac32-b32615a8da85","endpointAttributes":["#useastrouters"],"edgeRouterAttributes":["#usendpoints"]}'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 737

{
  "networkId" : "198fa14c-0937-4082-ac32-b32615a8da85",
  "deletedAt" : null,
  "ownerIdentityId" : null,
  "createdBy" : null,
  "createdAt" : "2020-12-01T13:36:41.899018Z",
  "updatedAt" : "2020-12-01T13:36:41.909286Z",
  "deletedBy" : null,
  "edgeRouterAttributes" : [ "#usendpoints" ],
  "endpointAttributes" : [ "#useastrouters" ],
  "name" : "Updated edge router policy name",
  "id" : "f5ab8af5-5561-4bdf-b955-396750c6e05e",
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/198fa14c-0937-4082-ac32-b32615a8da85"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/edge-router-policies/f5ab8af5-5561-4bdf-b955-396750c6e05e"
    }
  }
}

Delete Edge Router Policy

DELETE /edge-router-policies/{id}

Authorization

This endpoint requires delete action on the edge-router-policy resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have delete action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

No links.

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/edge-router-policies/7a7320f4-74c7-40ca-92cf-12d77822fe6b' -i -X DELETE \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJCN0dZZDNON2VOZ2tmZXdDU2RiaEdBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjI2MjM0ZDhhLWMwZTMtNDUzZS04YzExLTc4MWVhNDNhYWRhOCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgwMSwiZXhwIjoxNjA2ODMzNDAxLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjRkZDAxMjc4LTljNWItNDZjNi04Y2MzLTQwYjdlYTBmNDAyZFwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgwMX1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.iMMhIxOF0GkgVuEym0695K2wk-6fmKZjp0l5ULFtdeTX2UbtuFRa-CQc9UB5dqy-BgjPW5K-YSby-4A2hgOgRZJJZUHRmkI8tRNPIDK_HKkOgyC4Xtpvmutd_fNFvcfxKG9dkQ_RJlsI1lCYDt-cIuiD-bO2QI7sZL9t1l6d_0mywVp6XtT4xyLrw-xmOqs5aNTsi5DlfV2awoyT6DBvCJiiYe0woo48hMXTnKnqjdEL81-LazmDrE5IaYiiOuYWKpcFmEQux12TfhTphDInYbOFiTXhR8lprKD7nRSHeD0tylIyDC96pDMHHM5MjJKWzu1xhxC5E1DpaS5MeEIHGA'

Example response

HTTP/1.1 200 OK

Services

Find Services

GET /services

Authorization

This endpoint requires read action on the service resource type.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

networkId

Object

true

name

String

true

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

networkId

String

false

zitiId

String

true

deletedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

edgeRouterAttributes

Array[String]

true

egressRouterId

String

true

endpoints

Array[String]

true

clientHostName

String

true

clientPortRange

String

true

serverPortRange

String

true

serverProtocol

String

true

encryptionRequired

Boolean

true

serverHostName

String

true

name

String

false

id

String

true

attributes

Array[String]

true

Path Optional Description

self

false

network

false

Embedded resources

Path Type Optional Description

networkId

String

false

zitiId

String

true

deletedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

edgeRouterAttributes

Array[String]

true

egressRouterId

String

true

endpoints

Array[String]

true

clientHostName

String

true

clientPortRange

String

true

serverPortRange

String

true

serverProtocol

String

true

encryptionRequired

Boolean

true

serverHostName

String

true

name

String

false

id

String

true

attributes

Array[String]

true

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/services' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJxUFlfelBlQmtoWnVHVGJTZENNMUF3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjAyNTk1YjYwLTk4ODktNGE1NC04YjM2LWFjNWQwNzhlOTZlZCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgyMCwiZXhwIjoxNjA2ODMzNDIwLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjY5ZjI2ODhlLTY2M2UtNDkwZS1iMTMzLTNlOTJiZmJkOTkxY1wiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgyMH1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.UFXRsA3G64hpAepFN8aKiSYKwH_WAevGXrYJOz2YewBYmdSFGUQ0kLs9waNj0IzxruY2dz5OdMpN-LkcQI62MO2-X2h3Lcs3bi3e7K9v_MZ1tTqfnozgV5K0-5XVG5B3WZNh65At4iHnfU084u1-23KI2Lt0azA2Gaozr8Ld7DjW08MrH1rqKo_n6W736BUnh7R6N5fYlV1Hn5blvxYaYFsUyXO1ufiHj5bz3EBta800KGVTyTHOHdPfUDE5Nmj__MN7kaGVMSWnB_yTA4iz-t5XIX2w07c3AH4aYhc8Yjxsx13hG-GJbJcAvArSt6EcX1HrDvyuKUylP4DSc9apaA'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 24128

{
  "_embedded" : {
    "serviceList" : [ {
      "networkId" : "105f1c45-26f6-461c-8043-97e8817389a0",
      "zitiId" : "zitiservice01",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:36:59.945532Z",
      "updatedAt" : "2020-12-01T13:36:59.945532Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "egressRouterId" : "64a86811-ee04-4783-aab0-c78a6da7d432",
      "endpoints" : [ ],
      "clientHostName" : "outlook.office.com",
      "clientPortRange" : "443",
      "serverPortRange" : "443",
      "serverProtocol" : "TCP",
      "encryptionRequired" : false,
      "serverHostName" : "server.com",
      "name" : "ACME_Service01_2020-12-01T13:36:59.945325Z",
      "id" : "4896451f-221f-4adb-90e8-0a6a4f81be49",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/105f1c45-26f6-461c-8043-97e8817389a0"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/4896451f-221f-4adb-90e8-0a6a4f81be49"
        }
      }
    }, {
      "networkId" : "105f1c45-26f6-461c-8043-97e8817389a0",
      "zitiId" : "919bd65b-36b0-4ad9-91e3-b8abc414960e",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:36:59.946045Z",
      "updatedAt" : "2020-12-01T13:36:59.946045Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "egressRouterId" : "64a86811-ee04-4783-aab0-c78a6da7d432",
      "endpoints" : [ ],
      "clientHostName" : "13.107.6.152",
      "clientPortRange" : "443",
      "serverPortRange" : "443",
      "serverProtocol" : "TCP",
      "encryptionRequired" : false,
      "serverHostName" : "server.com",
      "name" : "ACME Service02 2020-12-01T13:36:59.945880Z",
      "id" : "ece21d64-2913-4ebd-8e86-c6c505b67431",
      "attributes" : [ "#clientservices" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/105f1c45-26f6-461c-8043-97e8817389a0"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/ece21d64-2913-4ebd-8e86-c6c505b67431"
        }
      }
    }, {
      "networkId" : "105f1c45-26f6-461c-8043-97e8817389a0",
      "zitiId" : "c698d530-7ab8-4a6f-a7b5-2ac7c549c635",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:36:59.946748Z",
      "updatedAt" : "2020-12-01T13:36:59.946748Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "egressRouterId" : "64a86811-ee04-4783-aab0-c78a6da7d432",
      "endpoints" : [ ],
      "clientHostName" : "",
      "clientPortRange" : "",
      "serverPortRange" : "443",
      "serverProtocol" : "TCP",
      "encryptionRequired" : false,
      "serverHostName" : "server.com",
      "name" : "ACME Service03 2020-12-01T13:36:59.946585Z",
      "id" : "36890f68-a190-458b-93b1-936244c855f8",
      "attributes" : [ "#clientservices" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/105f1c45-26f6-461c-8043-97e8817389a0"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/36890f68-a190-458b-93b1-936244c855f8"
        }
      }
    }, {
      "networkId" : "105f1c45-26f6-461c-8043-97e8817389a0",
      "zitiId" : "zitiIdService04",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:36:59.947307Z",
      "updatedAt" : "2020-12-01T13:36:59.947307Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "egressRouterId" : null,
      "endpoints" : [ ],
      "clientHostName" : "",
      "clientPortRange" : "",
      "serverPortRange" : "443",
      "serverProtocol" : "TCP",
      "encryptionRequired" : false,
      "serverHostName" : "server.com",
      "name" : "ACME Service04 2020-12-01T13:36:59.947158Z",
      "id" : "dd403ffe-cbda-4cc5-9b2b-50b3a8a18217",
      "attributes" : [ "#clientservices" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/105f1c45-26f6-461c-8043-97e8817389a0"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/dd403ffe-cbda-4cc5-9b2b-50b3a8a18217"
        }
      }
    }, {
      "networkId" : "105f1c45-26f6-461c-8043-97e8817389a0",
      "zitiId" : "ebba4ab3-c4b4-4890-9139-e1fd62678480",
      "deletedAt" : null,
      "ownerIdentityId" : "34630948-b021-4bf3-affe-09f9bfc22241",
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:36:59.985391Z",
      "updatedAt" : "2020-12-01T13:36:59.992049Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ "#accessrouters" ],
      "egressRouterId" : null,
      "endpoints" : [ "93f1639b-089d-4e00-8470-a40661c99c0f" ],
      "clientHostName" : "newclient.com",
      "clientPortRange" : "80",
      "serverPortRange" : "80",
      "serverProtocol" : "UDP",
      "encryptionRequired" : false,
      "serverHostName" : "newserver.com",
      "name" : "Test Service 1606829819",
      "id" : "644a26d6-2324-4f4a-b591-69e361e82fad",
      "attributes" : [ "#service01" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/105f1c45-26f6-461c-8043-97e8817389a0"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/644a26d6-2324-4f4a-b591-69e361e82fad"
        }
      }
    }, {
      "networkId" : "dc9973c2-8fbe-4f92-9c94-b20bd79f8dca",
      "zitiId" : "zitiservice01",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:37:00.046952Z",
      "updatedAt" : "2020-12-01T13:37:00.059869Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ "#accessrouterswest", "#accessrouterseast" ],
      "egressRouterId" : "4d864200-72fe-42c3-9e60-37a85cc1b29a",
      "endpoints" : [ ],
      "clientHostName" : "newclient.com",
      "clientPortRange" : "443",
      "serverPortRange" : "443",
      "serverProtocol" : "UDP",
      "encryptionRequired" : false,
      "serverHostName" : "newserver.com",
      "name" : "Test Service 1606829820",
      "id" : "ffe854db-f10e-4568-9c6d-00141ac27d6b",
      "attributes" : [ "#service01" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/dc9973c2-8fbe-4f92-9c94-b20bd79f8dca"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/ffe854db-f10e-4568-9c6d-00141ac27d6b"
        }
      }
    }, {
      "networkId" : "dc9973c2-8fbe-4f92-9c94-b20bd79f8dca",
      "zitiId" : "f99fcfb2-fbf1-4f53-94f2-1687dd007ea6",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:37:00.047284Z",
      "updatedAt" : "2020-12-01T13:37:00.047284Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "egressRouterId" : "4d864200-72fe-42c3-9e60-37a85cc1b29a",
      "endpoints" : [ ],
      "clientHostName" : "13.107.6.152",
      "clientPortRange" : "443",
      "serverPortRange" : "443",
      "serverProtocol" : "TCP",
      "encryptionRequired" : false,
      "serverHostName" : "server.com",
      "name" : "ACME Service02 2020-12-01T13:37:00.047117Z",
      "id" : "fd83297c-65e3-4944-a835-87165a81cd56",
      "attributes" : [ "#clientservices" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/dc9973c2-8fbe-4f92-9c94-b20bd79f8dca"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/fd83297c-65e3-4944-a835-87165a81cd56"
        }
      }
    }, {
      "networkId" : "dc9973c2-8fbe-4f92-9c94-b20bd79f8dca",
      "zitiId" : "835cd2de-98ac-4994-b695-186513b233f6",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:37:00.047861Z",
      "updatedAt" : "2020-12-01T13:37:00.047861Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "egressRouterId" : "4d864200-72fe-42c3-9e60-37a85cc1b29a",
      "endpoints" : [ ],
      "clientHostName" : "",
      "clientPortRange" : "",
      "serverPortRange" : "443",
      "serverProtocol" : "TCP",
      "encryptionRequired" : false,
      "serverHostName" : "server.com",
      "name" : "ACME Service03 2020-12-01T13:37:00.047708Z",
      "id" : "0dae130b-7dfe-4261-91cf-2a7f7d20c697",
      "attributes" : [ "#clientservices" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/dc9973c2-8fbe-4f92-9c94-b20bd79f8dca"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/0dae130b-7dfe-4261-91cf-2a7f7d20c697"
        }
      }
    }, {
      "networkId" : "dc9973c2-8fbe-4f92-9c94-b20bd79f8dca",
      "zitiId" : "zitiIdService04",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:37:00.048416Z",
      "updatedAt" : "2020-12-01T13:37:00.048416Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "egressRouterId" : null,
      "endpoints" : [ ],
      "clientHostName" : "",
      "clientPortRange" : "",
      "serverPortRange" : "443",
      "serverProtocol" : "TCP",
      "encryptionRequired" : false,
      "serverHostName" : "server.com",
      "name" : "ACME Service04 2020-12-01T13:37:00.048261Z",
      "id" : "b9a66089-f9e1-44aa-b5fb-4e7e08951ba2",
      "attributes" : [ "#clientservices" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/dc9973c2-8fbe-4f92-9c94-b20bd79f8dca"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/b9a66089-f9e1-44aa-b5fb-4e7e08951ba2"
        }
      }
    }, {
      "networkId" : "1aaf1fac-72dc-49d9-a9fe-28bdcb4f6564",
      "zitiId" : "zitiservice01",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:37:00.106879Z",
      "updatedAt" : "2020-12-01T13:37:00.106879Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "egressRouterId" : "974fc321-a7d4-470d-bed2-460087dc8c5c",
      "endpoints" : [ ],
      "clientHostName" : "outlook.office.com",
      "clientPortRange" : "443",
      "serverPortRange" : "443",
      "serverProtocol" : "TCP",
      "encryptionRequired" : false,
      "serverHostName" : "server.com",
      "name" : "ACME_Service01_2020-12-01T13:37:00.106714Z",
      "id" : "9d5c3129-f836-4fce-8a50-882feeffe6a4",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/1aaf1fac-72dc-49d9-a9fe-28bdcb4f6564"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/9d5c3129-f836-4fce-8a50-882feeffe6a4"
        }
      }
    }, {
      "networkId" : "1aaf1fac-72dc-49d9-a9fe-28bdcb4f6564",
      "zitiId" : "5756eb2e-131d-4859-a4bc-6d0f504eecd7",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:37:00.107215Z",
      "updatedAt" : "2020-12-01T13:37:00.107215Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "egressRouterId" : "974fc321-a7d4-470d-bed2-460087dc8c5c",
      "endpoints" : [ ],
      "clientHostName" : "13.107.6.152",
      "clientPortRange" : "443",
      "serverPortRange" : "443",
      "serverProtocol" : "TCP",
      "encryptionRequired" : false,
      "serverHostName" : "server.com",
      "name" : "ACME Service02 2020-12-01T13:37:00.107051Z",
      "id" : "686da6d1-1372-418c-a117-ab185bb6d06f",
      "attributes" : [ "#clientservices" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/1aaf1fac-72dc-49d9-a9fe-28bdcb4f6564"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/686da6d1-1372-418c-a117-ab185bb6d06f"
        }
      }
    }, {
      "networkId" : "1aaf1fac-72dc-49d9-a9fe-28bdcb4f6564",
      "zitiId" : "873b7c1f-cea7-47aa-b47e-db55e285933f",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:37:00.107783Z",
      "updatedAt" : "2020-12-01T13:37:00.107783Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "egressRouterId" : "974fc321-a7d4-470d-bed2-460087dc8c5c",
      "endpoints" : [ ],
      "clientHostName" : "",
      "clientPortRange" : "",
      "serverPortRange" : "443",
      "serverProtocol" : "TCP",
      "encryptionRequired" : false,
      "serverHostName" : "server.com",
      "name" : "ACME Service03 2020-12-01T13:37:00.107632Z",
      "id" : "1ff1139c-d5ae-4d44-aa54-c9ea0f279718",
      "attributes" : [ "#clientservices" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/1aaf1fac-72dc-49d9-a9fe-28bdcb4f6564"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/1ff1139c-d5ae-4d44-aa54-c9ea0f279718"
        }
      }
    }, {
      "networkId" : "1aaf1fac-72dc-49d9-a9fe-28bdcb4f6564",
      "zitiId" : "zitiIdService04",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:37:00.108340Z",
      "updatedAt" : "2020-12-01T13:37:00.108340Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "egressRouterId" : null,
      "endpoints" : [ ],
      "clientHostName" : "",
      "clientPortRange" : "",
      "serverPortRange" : "443",
      "serverProtocol" : "TCP",
      "encryptionRequired" : false,
      "serverHostName" : "server.com",
      "name" : "ACME Service04 2020-12-01T13:37:00.108192Z",
      "id" : "71186dbf-5960-4ff1-b966-144a44127540",
      "attributes" : [ "#clientservices" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/1aaf1fac-72dc-49d9-a9fe-28bdcb4f6564"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/71186dbf-5960-4ff1-b966-144a44127540"
        }
      }
    }, {
      "networkId" : "6001441f-f513-4bfd-94a3-aa4240679ebc",
      "zitiId" : "zitiservice01",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:37:00.151889Z",
      "updatedAt" : "2020-12-01T13:37:00.151889Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "egressRouterId" : "c25dfe27-2dfe-4a4f-a91f-d51d1d118587",
      "endpoints" : [ ],
      "clientHostName" : "outlook.office.com",
      "clientPortRange" : "443",
      "serverPortRange" : "443",
      "serverProtocol" : "TCP",
      "encryptionRequired" : false,
      "serverHostName" : "server.com",
      "name" : "ACME_Service01_2020-12-01T13:37:00.151729Z",
      "id" : "7fd2533a-64d1-426b-b382-cde88abb659e",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/6001441f-f513-4bfd-94a3-aa4240679ebc"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/7fd2533a-64d1-426b-b382-cde88abb659e"
        }
      }
    }, {
      "networkId" : "6001441f-f513-4bfd-94a3-aa4240679ebc",
      "zitiId" : "d1b2ad99-9a33-4157-9a04-a55bd405c67e",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:37:00.152217Z",
      "updatedAt" : "2020-12-01T13:37:00.152217Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "egressRouterId" : "c25dfe27-2dfe-4a4f-a91f-d51d1d118587",
      "endpoints" : [ ],
      "clientHostName" : "13.107.6.152",
      "clientPortRange" : "443",
      "serverPortRange" : "443",
      "serverProtocol" : "TCP",
      "encryptionRequired" : false,
      "serverHostName" : "server.com",
      "name" : "ACME Service02 2020-12-01T13:37:00.152053Z",
      "id" : "cabcdabc-6e41-40cf-b674-dd1168adfedd",
      "attributes" : [ "#clientservices" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/6001441f-f513-4bfd-94a3-aa4240679ebc"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/cabcdabc-6e41-40cf-b674-dd1168adfedd"
        }
      }
    }, {
      "networkId" : "6001441f-f513-4bfd-94a3-aa4240679ebc",
      "zitiId" : "97b4dc6f-4b1d-44d5-89d6-b08034f58c9a",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:37:00.152810Z",
      "updatedAt" : "2020-12-01T13:37:00.152810Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "egressRouterId" : "c25dfe27-2dfe-4a4f-a91f-d51d1d118587",
      "endpoints" : [ ],
      "clientHostName" : "",
      "clientPortRange" : "",
      "serverPortRange" : "443",
      "serverProtocol" : "TCP",
      "encryptionRequired" : false,
      "serverHostName" : "server.com",
      "name" : "ACME Service03 2020-12-01T13:37:00.152658Z",
      "id" : "8993da83-e5bf-4579-8915-9cc92f9c25cb",
      "attributes" : [ "#clientservices" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/6001441f-f513-4bfd-94a3-aa4240679ebc"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/8993da83-e5bf-4579-8915-9cc92f9c25cb"
        }
      }
    }, {
      "networkId" : "6001441f-f513-4bfd-94a3-aa4240679ebc",
      "zitiId" : "zitiIdService04",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:37:00.153381Z",
      "updatedAt" : "2020-12-01T13:37:00.161332Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ "#accessrouterswest", "#accessrouterseast" ],
      "egressRouterId" : null,
      "endpoints" : [ "9c77bfeb-83cf-49fe-ab05-ab8d0f8f9ccf" ],
      "clientHostName" : "newclient.com",
      "clientPortRange" : "443",
      "serverPortRange" : "443",
      "serverProtocol" : "UDP",
      "encryptionRequired" : false,
      "serverHostName" : "newserver.com",
      "name" : "ACME Service04 2020-12-01T13:37:00.153225Z",
      "id" : "66aa4308-5f0e-4cd5-9e77-eb6817678b56",
      "attributes" : [ "#service01" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/6001441f-f513-4bfd-94a3-aa4240679ebc"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/66aa4308-5f0e-4cd5-9e77-eb6817678b56"
        }
      }
    }, {
      "networkId" : "fe08afbe-dd85-4bfd-baef-da9f2760d719",
      "zitiId" : "zitiservice01",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:37:00.202207Z",
      "updatedAt" : "2020-12-01T13:37:00.202207Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "egressRouterId" : "7190f1b7-24e9-47b6-968c-c702676b7acb",
      "endpoints" : [ ],
      "clientHostName" : "outlook.office.com",
      "clientPortRange" : "443",
      "serverPortRange" : "443",
      "serverProtocol" : "TCP",
      "encryptionRequired" : false,
      "serverHostName" : "server.com",
      "name" : "ACME_Service01_2020-12-01T13:37:00.202030Z",
      "id" : "2f2f98b3-02d6-4466-aa1f-7a1b3efedfdf",
      "attributes" : [ ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/fe08afbe-dd85-4bfd-baef-da9f2760d719"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/2f2f98b3-02d6-4466-aa1f-7a1b3efedfdf"
        }
      }
    }, {
      "networkId" : "fe08afbe-dd85-4bfd-baef-da9f2760d719",
      "zitiId" : "bacf5113-27c1-4ca9-9913-d64c73467249",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:37:00.202527Z",
      "updatedAt" : "2020-12-01T13:37:00.202527Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "egressRouterId" : "7190f1b7-24e9-47b6-968c-c702676b7acb",
      "endpoints" : [ ],
      "clientHostName" : "13.107.6.152",
      "clientPortRange" : "443",
      "serverPortRange" : "443",
      "serverProtocol" : "TCP",
      "encryptionRequired" : false,
      "serverHostName" : "server.com",
      "name" : "ACME Service02 2020-12-01T13:37:00.202373Z",
      "id" : "aabbac83-d719-4207-ada2-103c67969a44",
      "attributes" : [ "#clientservices" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/fe08afbe-dd85-4bfd-baef-da9f2760d719"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/aabbac83-d719-4207-ada2-103c67969a44"
        }
      }
    }, {
      "networkId" : "fe08afbe-dd85-4bfd-baef-da9f2760d719",
      "zitiId" : "73c5410c-89d0-4dd3-b345-fc2444826f9c",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:37:00.203156Z",
      "updatedAt" : "2020-12-01T13:37:00.203156Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "egressRouterId" : "7190f1b7-24e9-47b6-968c-c702676b7acb",
      "endpoints" : [ ],
      "clientHostName" : "",
      "clientPortRange" : "",
      "serverPortRange" : "443",
      "serverProtocol" : "TCP",
      "encryptionRequired" : false,
      "serverHostName" : "server.com",
      "name" : "ACME Service03 2020-12-01T13:37:00.202939Z",
      "id" : "d6b6018e-cf2e-46bf-be7d-19567019cdd6",
      "attributes" : [ "#clientservices" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/fe08afbe-dd85-4bfd-baef-da9f2760d719"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/d6b6018e-cf2e-46bf-be7d-19567019cdd6"
        }
      }
    }, {
      "networkId" : "fe08afbe-dd85-4bfd-baef-da9f2760d719",
      "zitiId" : "zitiIdService04",
      "deletedAt" : null,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:37:00.203698Z",
      "updatedAt" : "2020-12-01T13:37:00.203698Z",
      "deletedBy" : null,
      "edgeRouterAttributes" : [ ],
      "egressRouterId" : null,
      "endpoints" : [ ],
      "clientHostName" : "",
      "clientPortRange" : "",
      "serverPortRange" : "443",
      "serverProtocol" : "TCP",
      "encryptionRequired" : false,
      "serverHostName" : "server.com",
      "name" : "ACME Service04 2020-12-01T13:37:00.203552Z",
      "id" : "64104094-2627-4eb6-a8a0-6fb7ef56066e",
      "attributes" : [ "#clientservices" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/fe08afbe-dd85-4bfd-baef-da9f2760d719"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/services/64104094-2627-4eb6-a8a0-6fb7ef56066e"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/services"
    }
  },
  "page" : {
    "size" : 2000,
    "totalElements" : 21,
    "totalPages" : 1,
    "number" : 0
  }
}

Get Service

GET /services/{id}

Authorization

This endpoint requires read action on the service resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

networkId

String

false

zitiId

String

true

deletedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

edgeRouterAttributes

Array[String]

true

egressRouterId

String

true

endpoints

Array[String]

true

clientHostName

String

true

clientPortRange

String

true

serverPortRange

String

true

serverProtocol

String

true

encryptionRequired

Boolean

true

serverHostName

String

true

name

String

false

id

String

true

attributes

Array[String]

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/services/9d5c3129-f836-4fce-8a50-882feeffe6a4' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJONEhrdkhCZVR5MXo1WEs3Ui1rcnJBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjE3M2QyYmEwLTQ0NjctNDFhYy1iMGVkLTA1NjEwMjAwNjEzOCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgyMCwiZXhwIjoxNjA2ODMzNDIwLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcImVlM2U5ZTFkLWIyM2ItNDJjMS1iYjZkLTRmYjIzMWZlYWE1NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgyMH1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.BVtpkkAIxMg1orcenu1GcsONez4xgC4pp3Z6-OiNRad667ggUbxI6z9BKxeb7_2uX9ufUBqmSaUWX4d_mq9bYHfCgLoBSs4qqoBMtg95oq_mAxn9vqKy8HeNpHwO1GRP8Bw9d05Wpg69A8nSw5YfG0-kIzhwHIlpQSD1MwvLeUALvUa1mZ0Ri3iyFm2Cb67RDQgeXt_AZRRjiefkNh4rhIvdC1XlKSr0RPBBUk-GTes47grusdWags87w_mD5UnUOTqz0HNTJioGtbdk8iGfEItgO6fsGtj1LgvkLZgvOjJFZ_czeN8Dv6Nhg9bfB_lrTDOc5MIo7oR8-t6ZUa0kkg'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 1004

{
  "networkId" : "1aaf1fac-72dc-49d9-a9fe-28bdcb4f6564",
  "zitiId" : "zitiservice01",
  "deletedAt" : null,
  "ownerIdentityId" : null,
  "createdBy" : null,
  "createdAt" : "2020-12-01T13:37:00.106879Z",
  "updatedAt" : "2020-12-01T13:37:00.106879Z",
  "deletedBy" : null,
  "edgeRouterAttributes" : [ ],
  "egressRouterId" : "974fc321-a7d4-470d-bed2-460087dc8c5c",
  "endpoints" : [ ],
  "clientHostName" : "outlook.office.com",
  "clientPortRange" : "443",
  "serverPortRange" : "443",
  "serverProtocol" : "TCP",
  "encryptionRequired" : false,
  "serverHostName" : "server.com",
  "name" : "ACME_Service01_2020-12-01T13:37:00.106714Z",
  "id" : "9d5c3129-f836-4fce-8a50-882feeffe6a4",
  "attributes" : [ ],
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/1aaf1fac-72dc-49d9-a9fe-28bdcb4f6564"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/services/9d5c3129-f836-4fce-8a50-882feeffe6a4"
    }
  }
}

Create Service

POST /services

Authorization

This endpoint requires create action on the service resource type.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

name

String

true

networkId

String

true

Client must have create action under the annotated resource.

egressRouterId

String

true

endpoints

Array[String]

true

attributes

Array[String]

true

edgeRouterAttributes

Array[String]

true

clientHostName

String

true

clientPortRange

String

true

serverHostName

String

true

serverPortRange

String

true

serverProtocol

String

true

Must be one of [TCP, UDP].

encryptionRequired

Boolean

true

Response fields

Path Type Optional Description

networkId

String

false

zitiId

String

true

deletedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

edgeRouterAttributes

Array[String]

true

egressRouterId

String

true

endpoints

Array[String]

true

clientHostName

String

true

clientPortRange

String

true

serverPortRange

String

true

serverProtocol

String

true

encryptionRequired

Boolean

true

serverHostName

String

true

name

String

false

id

String

true

attributes

Array[String]

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/services' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIzd0d3d1BidzdCRzBMaDgycU14ZXN3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjkwZjE5Y2MxLWQzYjUtNDAxYS1hMTA3LWM1ODAzNjAyZDEyMCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgyMCwiZXhwIjoxNjA2ODMzNDIwLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcImZiZGNlOTQzLTNmNDQtNGY3OC05M2VhLTU0NDIxMjFkNGQzMVwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgyMH1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.mxRQzFDNpNx3NpWfjL-MeMFcpvhJS4AJSK-9SIc4wwV1l3NH-5h296r6zhG2hHmHPIpVZORDIj87kdrg06cR5jdS3pTJEoCNuMHpnSOEHSJJSB7l0t0xHET_Xjmc7EHeiFpYF3jgP2PE0l3J9FJfkEanV13qWfp4igvlejwTWWMsmPs2Qjnz7JtKqBkV8LAYyn1pPqu95tOb8OQW7vO1_VtSb-F7QswSdVHQAgQfOPkFQcgMqWag9JhCXbfxE_pp0RMM9EHJL2twQE6CXONRvtOIYH0VuCCDRVLXe0uHnTJVTSYy0juC9KlBpzxMqxaCk2vRFQWwSB6Vw2acJsCbrg' \
    -d '{"name":"Test Service 1606829820","networkId":"8eb5fee9-8e0a-453e-803d-851c3db62800","egressRouterId":"af9c957a-c7ac-4567-866d-954daeca10a4","endpoints":null,"attributes":["#service01"],"edgeRouterAttributes":["#accessrouters"],"clientHostName":"newclient.com","clientPortRange":"80","serverHostName":"newserver.com","serverPortRange":"80","serverProtocol":"UDP","encryptionRequired":false}'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 1034

{
  "networkId" : "8eb5fee9-8e0a-453e-803d-851c3db62800",
  "zitiId" : null,
  "deletedAt" : null,
  "ownerIdentityId" : "90f19cc1-d3b5-401a-a107-c5803602d120",
  "createdBy" : null,
  "createdAt" : "2020-12-01T13:37:00.424391Z",
  "updatedAt" : "2020-12-01T13:37:00.424391Z",
  "deletedBy" : null,
  "edgeRouterAttributes" : [ "#accessrouters" ],
  "egressRouterId" : "af9c957a-c7ac-4567-866d-954daeca10a4",
  "endpoints" : [ ],
  "clientHostName" : "newclient.com",
  "clientPortRange" : "80",
  "serverPortRange" : "80",
  "serverProtocol" : "UDP",
  "encryptionRequired" : false,
  "serverHostName" : "newserver.com",
  "name" : "Test Service 1606829820",
  "id" : "00b4ca90-2d8a-4fea-b194-d220c1f7575e",
  "attributes" : [ "#service01" ],
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/8eb5fee9-8e0a-453e-803d-851c3db62800"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/services/00b4ca90-2d8a-4fea-b194-d220c1f7575e"
    }
  }
}

Update Service

PUT /services/{id}

Authorization

This endpoint requires update action on the service resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Query parameters

No parameters.

Request fields

Path Type Optional Description

name

String

true

egressRouterId

String

true

endpoints

Array[String]

true

attributes

Array[String]

true

edgeRouterAttributes

Array[String]

true

clientHostName

String

true

clientPortRange

String

true

serverHostName

String

true

serverPortRange

String

true

serverProtocol

String

true

Must be one of [TCP, UDP].

encryptionRequired

Boolean

true

Response fields

Path Type Optional Description

networkId

String

false

zitiId

String

true

deletedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

edgeRouterAttributes

Array[String]

true

egressRouterId

String

true

endpoints

Array[String]

true

clientHostName

String

true

clientPortRange

String

true

serverPortRange

String

true

serverProtocol

String

true

encryptionRequired

Boolean

true

serverHostName

String

true

name

String

false

id

String

true

attributes

Array[String]

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/services/ffe854db-f10e-4568-9c6d-00141ac27d6b' -i -X PUT \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJVLUNQcm5RVEZvcl95TXdpVWQzTHpnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImI4MGEzNzk5LWIyMTQtNDk4Zi05NzMyLTIyNzY1NWYxZGVkMyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgyMCwiZXhwIjoxNjA2ODMzNDIwLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjlkM2Y2ZTUxLWU3ZWUtNDNmZC1hOGQ0LTIxMDhiMGU2OWE3N1wiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgyMH1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.sIDeppTlYykTGheDw-Xg4Pu8nEt85nQjJbL6sQ39f4gP79MmGQZYkpR5Al_cz4cAY2FWoa5Qs1b-STaAI1Xja7ogYRxGFJVzxCJaBLW6Ao9oRs4Ev1YVCnAOpiV40CjFrmEUfqsTEPKAuMjX_I-IoB8153L3M_bqKj6cWdIRP-zBs684_FV5DzymHgOBSBpkYVrbN8pn6lfME6OAxW0iPzfY6FMOKMFlaVsY0k45-zI_2ZT9S7_grAge6SX1N77Ljn9m3bcY_IKnWlyP6pSZPDwy5qrOaIHz4Tf7Xk4aLifIUuFbAFhSuJG6nO4LWfN5cumgkgW0xofGKkIc1faNSA' \
    -d '{"name":"Test Service 1606829820","egressRouterId":"4d864200-72fe-42c3-9e60-37a85cc1b29a","endpoints":null,"attributes":["#service01"],"edgeRouterAttributes":["#accessrouterseast","#accessrouterswest"],"clientHostName":"newclient.com","clientPortRange":"443","serverHostName":"newserver.com","serverPortRange":"443","serverProtocol":"UDP","encryptionRequired":false}'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 1039

{
  "networkId" : "dc9973c2-8fbe-4f92-9c94-b20bd79f8dca",
  "zitiId" : "zitiservice01",
  "deletedAt" : null,
  "ownerIdentityId" : null,
  "createdBy" : null,
  "createdAt" : "2020-12-01T13:37:00.046952Z",
  "updatedAt" : "2020-12-01T13:37:00.059869Z",
  "deletedBy" : null,
  "edgeRouterAttributes" : [ "#accessrouterswest", "#accessrouterseast" ],
  "egressRouterId" : "4d864200-72fe-42c3-9e60-37a85cc1b29a",
  "endpoints" : [ ],
  "clientHostName" : "newclient.com",
  "clientPortRange" : "443",
  "serverPortRange" : "443",
  "serverProtocol" : "UDP",
  "encryptionRequired" : false,
  "serverHostName" : "newserver.com",
  "name" : "Test Service 1606829820",
  "id" : "ffe854db-f10e-4568-9c6d-00141ac27d6b",
  "attributes" : [ "#service01" ],
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/dc9973c2-8fbe-4f92-9c94-b20bd79f8dca"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/services/ffe854db-f10e-4568-9c6d-00141ac27d6b"
    }
  }
}

Delete Service

DELETE /services/{id}

Authorization

This endpoint requires delete action on the service resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have delete action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

No links.

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/services/7f50b808-e4f8-446a-882b-90d2d49073e5' -i -X DELETE \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIxdnBKd0FWQ045VENaT3lpQnZJbGx3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjQwNGNlYTM4LTYwYzYtNDUxMi05NGIxLTc4OGE3OTVjMDhkZCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgyMCwiZXhwIjoxNjA2ODMzNDIwLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcImUzNDhkNThmLTk2MGItNGY4MS1iZTVjLWExZDViNjc2NzBhMVwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgyMH1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.AXX4slEKF4peXfMmy3XSxWJleecjOkf0a9JcIhdm3nX18b6SnR4FxpCAuOkoCPrmcmPbMYc1b_mwjaJv7hzV0SnXduI65zXSdz6lClPGCXS3oAPJ3HZP5_NKyfxQh5Ihg8dpaXdDNaHDp0taiQ9ulrVy962-CXaCe39Jig-yWiIcTqv47no2itNgvuCJIdAaj6sF7psHLsp6A047aV0w3NGy5hjz-Z4O2XMRlZKIJjqzsOkoOxKK9kd5qRxiQpFS_mU3CC4dO5VrA3MinuMuWbREunaG0rvploz_C8mnpj-RdCewF5hU6ZZJtey00kpfpqPjhn-mQbmsrIPuNFk8vg'

Example response

HTTP/1.1 200 OK

App Wans

Find App Wans

GET /app-wans

Authorization

This endpoint requires read action on the app-wan resource type.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

networkId

Object

true

name

String

true

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

networkId

String

false

deletedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

serviceAttributes

Array[String]

true

endpointAttributes

Array[String]

true

postureCheckAttributes

Array[String]

true

name

String

false

id

String

true

Path Optional Description

self

false

network

false

Embedded resources

Path Type Optional Description

networkId

String

false

deletedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

serviceAttributes

Array[String]

true

endpointAttributes

Array[String]

true

postureCheckAttributes

Array[String]

true

name

String

false

id

String

true

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/app-wans' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJDZGF3QlhyQUdLdkRQNVQ4bHlDVXdnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjlmZjE2OWI5LTFiM2UtNGJhOC05M2IzLTFiMmZkZDhlODVjMiIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgzMywiZXhwIjoxNjA2ODMzNDMzLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjIzNWNjMmVjLTY2MWQtNDhiOS05NThlLTY0NGRiMDZlYzk1NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgzM31dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.bFO9UH9FzXIddSsrabhezcDnKHMiSXMCcYsedwW_wIuT0eVvjddoYr-d-ye2zXyKjPQDawxzkgsFUu0aEiea8HH04m9wiXUWgcxBQTGCxlRB5k2iFilhty9IxayYGN6a9NRdpHyuWGfkG8B1pRhjuOI7SrP59iUWgJ9Ke3qum7eMdsbdmMCUKI5o-2qQUYdA3einyheHl6rFyggLW_v0kgORUN09Rt3MezxwWVuGhn6eGzEQWKKnVkptIuq5I5HuGoT85FBFAlP4dGZxZUoCs7t3VDbhc5WMx4GKCZ8AwZ9nF2kBD2_ObAnYF1H4EvUv-PIOF_vVsclx7AMFi5csbQ'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 3926

{
  "_embedded" : {
    "appWanList" : [ {
      "networkId" : "02deb05a-d701-40a3-a733-9e154c66e722",
      "deletedAt" : null,
      "ownerIdentityId" : "5d2f273d-09c6-48fb-864d-5807a0eee804",
      "createdBy" : "5d2f273d-09c6-48fb-864d-5807a0eee804",
      "createdAt" : "2020-12-01T13:37:13.005560Z",
      "updatedAt" : "2020-12-01T13:37:13.005560Z",
      "deletedBy" : null,
      "serviceAttributes" : [ ],
      "endpointAttributes" : [ ],
      "postureCheckAttributes" : [ ],
      "name" : "ACME App Wan 2020-12-01T13:37:13.005424Z",
      "id" : "22025255-12db-4cf5-9470-4d2d2c643bb6",
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/02deb05a-d701-40a3-a733-9e154c66e722"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans/22025255-12db-4cf5-9470-4d2d2c643bb6"
        }
      }
    }, {
      "networkId" : "09403521-e824-4405-a976-4a8bd4e6c894",
      "deletedAt" : null,
      "ownerIdentityId" : "e8ba3ade-427f-4ad5-aa18-39b22cbb6bf7",
      "createdBy" : "e8ba3ade-427f-4ad5-aa18-39b22cbb6bf7",
      "createdAt" : "2020-12-01T13:37:13.063247Z",
      "updatedAt" : "2020-12-01T13:37:13.070754Z",
      "deletedBy" : null,
      "serviceAttributes" : [ "#service03", "#service02", "#service01" ],
      "endpointAttributes" : [ "#usendpoints" ],
      "postureCheckAttributes" : [ "#windows" ],
      "name" : "Updated App Wan name",
      "id" : "ccbd08d8-dfad-4516-90b6-2dbecd4c4a8f",
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/09403521-e824-4405-a976-4a8bd4e6c894"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans/ccbd08d8-dfad-4516-90b6-2dbecd4c4a8f"
        }
      }
    }, {
      "networkId" : "8b266f62-7baa-4ca5-8ef0-21ea0ee17ed9",
      "deletedAt" : null,
      "ownerIdentityId" : "1876feba-ecbf-425e-bbb4-00e11f208d03",
      "createdBy" : "1876feba-ecbf-425e-bbb4-00e11f208d03",
      "createdAt" : "2020-12-01T13:37:13.117883Z",
      "updatedAt" : "2020-12-01T13:37:13.117883Z",
      "deletedBy" : null,
      "serviceAttributes" : [ "#service03", "#service02", "#service01" ],
      "endpointAttributes" : [ "#usendpoints" ],
      "postureCheckAttributes" : [ "#windows" ],
      "name" : "ACME App Wan 2020-12-01T13:37:13.117750Z",
      "id" : "3379e251-a83b-45a8-b8f4-175f91b726f2",
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/8b266f62-7baa-4ca5-8ef0-21ea0ee17ed9"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans/3379e251-a83b-45a8-b8f4-175f91b726f2"
        }
      }
    }, {
      "networkId" : "8dff42cb-d61c-43d7-b7f6-e5a51afeb051",
      "deletedAt" : null,
      "ownerIdentityId" : "83944cc0-e06f-45b8-927e-26e755553499",
      "createdBy" : "83944cc0-e06f-45b8-927e-26e755553499",
      "createdAt" : "2020-12-01T13:37:13.161091Z",
      "updatedAt" : "2020-12-01T13:37:13.161091Z",
      "deletedBy" : null,
      "serviceAttributes" : [ ],
      "endpointAttributes" : [ ],
      "postureCheckAttributes" : [ ],
      "name" : "ACME App Wan 2020-12-01T13:37:13.160945Z",
      "id" : "883ac55c-1656-4f19-8487-ba3aac1edbc4",
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/8dff42cb-d61c-43d7-b7f6-e5a51afeb051"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans/883ac55c-1656-4f19-8487-ba3aac1edbc4"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans"
    }
  },
  "page" : {
    "size" : 2000,
    "totalElements" : 4,
    "totalPages" : 1,
    "number" : 0
  }
}

Get App Wan

GET /app-wans/{id}

Authorization

This endpoint requires read action on the app-wan resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

networkId

String

false

deletedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

serviceAttributes

Array[String]

true

endpointAttributes

Array[String]

true

postureCheckAttributes

Array[String]

true

name

String

false

id

String

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/app-wans/a3455984-7aeb-413f-baec-34256b082c6f' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJ2MXQ5NjRiY0hzMjZmeVB2TUxuOHRRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImQxMDFmODM3LTRjZDUtNDNlMi04OGQ5LTkyODdkYzJmMDdhOCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgzMywiZXhwIjoxNjA2ODMzNDMzLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjk5OTdiODdmLWRmMTktNDExNi1iMmU1LTJiNjU2ODJlMTY0MlwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgzM31dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.RHiZBwpQXruQSrit3RiF57hI0mUY7lMqg9JBK7mJzQPwK1mZP7TNrPAHMKILlR9x9d7PJooVneO0yFtGbzlne7IELTRFqzYi0O3Owv_5aFXUb-_yQbuHprEua0zM4ntisoi2NUePRoaLjjsCNpZL6nHEenNHHsti9OS9wFsPmy7Py5qGsjWmV_c92Xf4bt7ABTBARo3MOZN4cOZlvPbEOuXvRZ9Y2m1qPN4Hnryo9Jr5J2V9VXPOm8BuTpYOswRJ9345aLWYWUyS7H6lvhJXAtVFHbnsPLMTyDLHoj24Y5nQwXVWRWXNiU2uwzhUN6K9V-PbXdn3S2g1OISfT8rGtA'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 801

{
  "networkId" : "60fb447c-c547-4c26-8f46-859f5346bed9",
  "deletedAt" : null,
  "ownerIdentityId" : "2126b00b-30b9-41a1-b01f-be6173040f90",
  "createdBy" : "2126b00b-30b9-41a1-b01f-be6173040f90",
  "createdAt" : "2020-12-01T13:37:13.215978Z",
  "updatedAt" : "2020-12-01T13:37:13.215978Z",
  "deletedBy" : null,
  "serviceAttributes" : [ ],
  "endpointAttributes" : [ ],
  "postureCheckAttributes" : [ ],
  "name" : "ACME App Wan 2020-12-01T13:37:13.215782Z",
  "id" : "a3455984-7aeb-413f-baec-34256b082c6f",
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/60fb447c-c547-4c26-8f46-859f5346bed9"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans/a3455984-7aeb-413f-baec-34256b082c6f"
    }
  }
}

Create App Wan

POST /app-wans

Authorization

This endpoint requires create action on the app-wan resource type.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

networkId

String

true

Client must have create action under the annotated resource.

name

String

true

endpointAttributes

Array[String]

true

serviceAttributes

Array[String]

true

postureCheckAttributes

Array[String]

true

Response fields

Path Type Optional Description

networkId

String

false

deletedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

serviceAttributes

Array[String]

true

endpointAttributes

Array[String]

true

postureCheckAttributes

Array[String]

true

name

String

false

id

String

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/app-wans' -i -X POST \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI3XzZ1R1pDVkkyV2UwbnRnT2hIdFZ3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImMwMTU2MjAwLTBkMzktNGYyNy1iZGE2LTFhNjdlOTQwYzZlYiIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgzMywiZXhwIjoxNjA2ODMzNDMzLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjA1YmQ0NjJiLWY3OGUtNGZlZS1hNjAzLThmN2IxOTNmNjgzY1wiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgzM31dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.SIra9lOLec8hIzmrLmFokVg3qa3uWT9_KAtEeInWmntziqfxwOfDIAlez99rK_MVx1oG40KEGlbAk6q4lLLPjAxVHYNisbNTdIo22ubY68QtCLYB4XaBFgmkk3nQLGMYonIizulqssuJHf5qyVnLIF2nStlFJk8rcWIWizI_thuD6fmzjnHA3L3DYw8S4jxglv8xKgYO-YsmrLcO3CPwNKtDPqc-YieHIi9-oEi7kFVqyCqLi-Fqxr79mdXid0nIh9Qp3n2p1Rh-OaCFMGJ5HcydEsFFSPBkTpJ1-hwPIntmh7mW2Ed6IxaCWOUoFxCWOVvUva5Ju_UGp1j1T8cQjA' \
    -d '{"networkId":"32bbb5c7-392c-4079-8a6b-1cb81113630d","name":"Test App Wan 1606829833","endpointAttributes":["#accessclients","@Test_endpoint2020-12-01T13:37:13.358612Z"],"serviceAttributes":["#service01","@ACME_Service01_2020-12-01T13:37:13.361559Z"],"postureCheckAttributes":["#windows"]}'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 917

{
  "networkId" : "32bbb5c7-392c-4079-8a6b-1cb81113630d",
  "deletedAt" : null,
  "ownerIdentityId" : "c0156200-0d39-4f27-bda6-1a67e940c6eb",
  "createdBy" : "c0156200-0d39-4f27-bda6-1a67e940c6eb",
  "createdAt" : "2020-12-01T13:37:13.380233Z",
  "updatedAt" : "2020-12-01T13:37:13.383459Z",
  "deletedBy" : null,
  "serviceAttributes" : [ "#service01", "@ACME_Service01_2020-12-01T13:37:13.361559Z" ],
  "endpointAttributes" : [ "#accessclients", "@Test_endpoint2020-12-01T13:37:13.358612Z" ],
  "postureCheckAttributes" : [ "#windows" ],
  "name" : "Test App Wan 1606829833",
  "id" : "449bb268-3b70-4b54-9e8b-150315efb839",
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/32bbb5c7-392c-4079-8a6b-1cb81113630d"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans/449bb268-3b70-4b54-9e8b-150315efb839"
    }
  }
}

Update App Wan

PUT /app-wans/{id}

Authorization

This endpoint requires update action on the app-wan resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have update action on the annotated resource.

Query parameters

No parameters.

Request fields

Path Type Optional Description

name

String

true

networkId

String

true

endpointAttributes

Array[String]

true

serviceAttributes

Array[String]

true

postureCheckAttributes

Array[String]

true

Response fields

Path Type Optional Description

networkId

String

false

deletedAt

String

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

serviceAttributes

Array[String]

true

endpointAttributes

Array[String]

true

postureCheckAttributes

Array[String]

true

name

String

false

id

String

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/app-wans/ccbd08d8-dfad-4516-90b6-2dbecd4c4a8f' -i -X PUT \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJiSmdFWjUxQVYzZm81M3hoZ1RGVUhnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjdiODUzN2I3LWE1ZDktNDM0ZS1hYzI0LTEzYWQ4NTE5YTVjOSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgzMywiZXhwIjoxNjA2ODMzNDMzLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjczNGQ5OWE3LTFiNDQtNDkxMi1hOWMyLTk3M2U2MDkwNTNhN1wiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgzM31dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.EKwfI0TOGGqnAPREuh3nKKPxvlLeJFsnIIJwhEYQiufsO4D2fgMV5J92QGjHtUHaiXtrY2YWS5vO2n2bQ2HDNvICEnfgqUSZfzLEctRl6c9OLq1Xjp8iPsQADg82QlGMvLyk5a7rOAFwVAd9UAQPGAhUPdKkyWSlnzad7AvSCIOtpagr8B4TFv8eLFHclY3-2maeRZnWJ-BopmCPWqIIh-xY6UROsbbUzYudSy-BfV6rf8Z25sM0D_P2pa4WD-Ui9Ni_gpwMsaR7sdnaMkLy7F0tRRJYfJLfj3tQXyOcZYtegs7uHY_jdwSjM1FuYGMLOkeH2lxkfW242FchL1K0_w' \
    -d '{"name":"Updated App Wan name","networkId":"09403521-e824-4405-a976-4a8bd4e6c894","endpointAttributes":["#usendpoints"],"serviceAttributes":["#service02","#service03","#service01"],"postureCheckAttributes":["#windows"]}'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 848

{
  "networkId" : "09403521-e824-4405-a976-4a8bd4e6c894",
  "deletedAt" : null,
  "ownerIdentityId" : "e8ba3ade-427f-4ad5-aa18-39b22cbb6bf7",
  "createdBy" : "e8ba3ade-427f-4ad5-aa18-39b22cbb6bf7",
  "createdAt" : "2020-12-01T13:37:13.063247Z",
  "updatedAt" : "2020-12-01T13:37:13.070754Z",
  "deletedBy" : null,
  "serviceAttributes" : [ "#service03", "#service02", "#service01" ],
  "endpointAttributes" : [ "#usendpoints" ],
  "postureCheckAttributes" : [ "#windows" ],
  "name" : "Updated App Wan name",
  "id" : "ccbd08d8-dfad-4516-90b6-2dbecd4c4a8f",
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/09403521-e824-4405-a976-4a8bd4e6c894"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/app-wans/ccbd08d8-dfad-4516-90b6-2dbecd4c4a8f"
    }
  }
}

Delete App Wan

DELETE /app-wans/{id}

Authorization

This endpoint requires delete action on the app-wan resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have delete action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

No links.

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/app-wans/5ac1c891-6431-4f25-82a1-3891b8ad5d2e' -i -X DELETE \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJXcm5wQUNBSndYOFY4dnJrY0dnOXNBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjcwNDUxYjhhLTQ4NzYtNDc2Ny05Mjc5LWZiYTBiYjNjYmZiNiIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTgzMiwiZXhwIjoxNjA2ODMzNDMyLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjZiYmFlNjU2LTM1OWItNDRiOS1hNzdmLWJmOWMxOTY5Y2VmN1wiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTgzMn1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.MRYH515JLgAmFZWbwY_M64IPvkUsc0v9XOJzF71CRoIVUbjW1ZWDUxCnQ9P49tcSQipASmprHMob4n_wzgqElFHGIMDUGunLxfeBXAtLNKhqaOrTq4p3KY3mfYX3N9xzGd_9JEaGAvuQBPyBH_14N4uxDPD1i5iHV-FBK-prMg6lC4P1dF8ZIUEVs0QgdXIwHKhowPQPhf2JVQKEMwYmelQF1N_RRQx3b9ccLln5qc8sYjcqxGnnEPl_oeepaTHRw_sAZRpQJKwonvi8WYm4kRpuI1nAzqdIe9YjuukZykqtLzEm_z5qjWJvkTkGz3jU4pNJEAAz66cYxqkGb_u2IQ'

Example response

HTTP/1.1 200 OK

Posture Checks

Find Posture Checks

GET /posture-checks

Authorization

This endpoint requires read action on the posture-check resource type.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

networkId

Object

true

name

String

true

deleted

Object

true

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

id

String

false

zitiId

String

false

Size must be between 1 and 255 inclusive.

name

String

false

Size must be between 5 and 255 inclusive.

networkId

String

false

type

String

false

ownerIdentityId

String

false

createdBy

String

false

createdAt

String

false

updatedAt

String

false

deletedBy

String

true

deletedAt

String

true

attributes

Array[String]

false

Path Optional Description

self

false

network

false

Embedded resources

Path Type Optional Description

id

String

false

zitiId

String

false

Size must be between 1 and 255 inclusive.

name

String

false

Size must be between 5 and 255 inclusive.

networkId

String

false

type

String

false

ownerIdentityId

String

false

createdBy

String

false

createdAt

String

false

updatedAt

String

false

deletedBy

String

true

deletedAt

String

true

attributes

Array[String]

false

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/posture-checks' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJhd1dLempmN19NZ0cwNjlVcVFpVFVBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjBjZGMyOTcwLWY1NTEtNDA5Yi1hYTk4LWNlZmRjM2UxMmE3ZSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTc5NSwiZXhwIjoxNjA2ODMzMzk1LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjA1ZDczMTQ4LTc4ZTItNGUxNi1hMzdkLWEzNDI0OThhOWU5NlwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTc5NX1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.PNy3GBcM0QkY1_Okhym48iQpAwmWz8suZ6wueBbnic1vWhfa6UWK2wOAeen77pETCjAbpABbNyqkkUpnivAywylGwCUnIPqUd1uPJXZBafWKRoLkYJ1kk_nW8kG7-i7JcqiOdKDn9nH0N9PP2jVJhseiwPF6te0eGrmp-aJmxx8RI5IjDGP89w5U2ZzPD5l2VzOQPqdbsDnfArHbMP3mXAMllH_ZVGnlSMLaZlKzqh_R6_Dc-hBFPSuTQ8M7sbSg_PDq1C_5D2uCMUnA13Ou6x5PFL3m_LG3gjn9QdLVLjUsPa3cIa5QrPoCuJCLvKb9qgP_JOU9K8itkgEzvHytMQ'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 2067

{
  "_embedded" : {
    "postureCheckList" : [ {
      "id" : "f96e5470-81ca-4906-a1a7-539952975526",
      "zitiId" : "zitiId-fake-eab090a9-ba81-45a9-ad4d-1b7939e77734",
      "name" : "Test Posture Check-28",
      "networkId" : "a58e849b-7559-42ff-acec-5390495093e8",
      "type" : "UNKNOWN",
      "ownerIdentityId" : "2995f313-0495-4725-9b8b-a1c317d066f7",
      "createdBy" : "2995f313-0495-4725-9b8b-a1c317d066f7",
      "createdAt" : "2020-12-01T13:36:35.042816Z",
      "updatedAt" : "2020-12-01T13:36:35.042816Z",
      "deletedBy" : null,
      "deletedAt" : null,
      "attributes" : [ "Test-Attr" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/a58e849b-7559-42ff-acec-5390495093e8"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/posture-checks/f96e5470-81ca-4906-a1a7-539952975526"
        }
      }
    }, {
      "id" : "239bdcbb-cfd9-411e-983a-85e895f69c58",
      "zitiId" : "ziti-63d2c4fd-7d18-4dfb-8b21-3876b1b77bdd",
      "name" : "Test Posture Check",
      "networkId" : "b1bf19b6-7850-4ecb-be56-88ac93218fbf",
      "type" : "UNKNOWN",
      "ownerIdentityId" : "092a10e2-b218-4b6d-bd84-a568accbc284",
      "createdBy" : "092a10e2-b218-4b6d-bd84-a568accbc284",
      "createdAt" : "2020-12-01T13:36:35.201693Z",
      "updatedAt" : "2020-12-01T13:36:35.201693Z",
      "deletedBy" : null,
      "deletedAt" : null,
      "attributes" : [ "Attr-1" ],
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/b1bf19b6-7850-4ecb-be56-88ac93218fbf"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/posture-checks/239bdcbb-cfd9-411e-983a-85e895f69c58"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/posture-checks"
    }
  },
  "page" : {
    "size" : 2000,
    "totalElements" : 2,
    "totalPages" : 1,
    "number" : 0
  }
}

Get Posture Check

GET /posture-checks/{id}

Authorization

This endpoint requires read action on the posture-check resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

zitiId

String

false

Size must be between 1 and 255 inclusive.

name

String

false

Size must be between 5 and 255 inclusive.

networkId

String

false

type

String

false

ownerIdentityId

String

false

createdBy

String

false

createdAt

String

false

updatedAt

String

false

deletedBy

String

true

deletedAt

String

true

attributes

Array[String]

false

data

Object

true

data.description

String

false

data.tags

Map

true

data.domains

Array[String]

false

data.macAddresses

Array[String]

false

data.operatingSystems

Array[Object]

false

data.operatingSystems[].type

String

false

Must be one of [Windows, Android, iOS, Linux, macOS, WindowsServer].

data.operatingSystems[].versions

Array[String]

false

data.process

Object

false

data.process.osType

String

false

Must be one of [Windows, Android, iOS, Linux, macOS].

data.process.path

String

false

data.process.hashes

Array[String]

true

data.process.signerFingerprint

String

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/posture-checks/f96e5470-81ca-4906-a1a7-539952975526' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5VzlRTEljdHVsZUFFMUpNWXFVbEdBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImU1Yzg1MjJkLTdmMzctNGJlYi1hMDI0LTViMmM3NDMxMTg0NCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTc5NSwiZXhwIjoxNjA2ODMzMzk1LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjUyMmFiZmFhLTM3MzQtNGE1Zi05NTJkLTAyYjA5ZWQ4MDY0OVwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTc5NX1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.YwxJz7ko436cKcjACfMr2OXuDx2PVAnOWKZ1kAa-jsAxBfusLei6O5kccAODGpXm_0-YPUFVkxowhJenWa5OKdLpM3RitglBvgFK1BoZiaM2WJpr-MSNrG62Ey0_rLq3nQVvMkZwgwKqSQH9mqHhuV2t5OO8GGYkgzVexMtSgM_zjfWUAAzIYY8lE-HxTVFEb7rRtg8jfzsgAPXfkZaUDOK-4BWEFhGS2py3xp60-lBF63tmrjRDzYpzKAQAcpbGdcoFvUFoiW6xzyMShdWeYETbnOe0nwLMsCes4qvFHFG4CVzpmDbUMdjYydXJBfHAjKYGK3EP_PukPc0fYQ5RIw'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 903

{
  "id" : "f96e5470-81ca-4906-a1a7-539952975526",
  "zitiId" : "zitiId-fake-eab090a9-ba81-45a9-ad4d-1b7939e77734",
  "name" : "Test Posture Check-28",
  "networkId" : "a58e849b-7559-42ff-acec-5390495093e8",
  "type" : "UNKNOWN",
  "ownerIdentityId" : "2995f313-0495-4725-9b8b-a1c317d066f7",
  "createdBy" : "2995f313-0495-4725-9b8b-a1c317d066f7",
  "createdAt" : "2020-12-01T13:36:35.042816Z",
  "updatedAt" : "2020-12-01T13:36:35.042816Z",
  "deletedBy" : null,
  "deletedAt" : null,
  "attributes" : [ "Test-Attr" ],
  "data" : {
    "description" : null,
    "tags" : null,
    "unknownData" : { }
  },
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/a58e849b-7559-42ff-acec-5390495093e8"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/posture-checks/f96e5470-81ca-4906-a1a7-539952975526"
    }
  }
}

Create Posture Check

POST /posture-checks

Authorization

This endpoint requires create action on the posture-check resource type.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

name

String

true

io.netfoundry.common.util.validation.ValidAs.

networkId

String

true

Client must have create action under the annotated resource.
io.netfoundry.common.util.validation.ValidAs.

type

String

true

io.netfoundry.common.util.validation.ValidAs.

attributes

Array[String]

true

io.netfoundry.common.util.validation.ValidAs.

data

Map

true

Response fields

Path Type Optional Description

id

String

false

zitiId

String

false

Size must be between 1 and 255 inclusive.

name

String

false

Size must be between 5 and 255 inclusive.

networkId

String

false

type

String

false

ownerIdentityId

String

false

createdBy

String

false

createdAt

String

false

updatedAt

String

false

deletedBy

String

true

deletedAt

String

true

attributes

Array[String]

false

data

Object

true

data.description

String

false

data.tags

Map

true

data.domains

Array[String]

false

data.macAddresses

Array[String]

false

data.operatingSystems

Array[Object]

false

data.operatingSystems[].type

String

false

Must be one of [Windows, Android, iOS, Linux, macOS, WindowsServer].

data.operatingSystems[].versions

Array[String]

false

data.process

Object

false

data.process.osType

String

false

Must be one of [Windows, Android, iOS, Linux, macOS].

data.process.path

String

false

data.process.hashes

Array[String]

true

data.process.signerFingerprint

String

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/posture-checks' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJGZlFhcXRTWFBiaC1ULTNqRDF2MlBRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjA5MmExMGUyLWIyMTgtNGI2ZC1iZDg0LWE1NjhhY2NiYzI4NCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTc5NSwiZXhwIjoxNjA2ODMzMzk1LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjdmOTZiNzEyLWY1ZGEtNGJiNi04YzhjLTYyZGQxYzdjODkzMFwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTc5NX1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.oPbJPljt9fGbz3jFmx5hwCFZo0S1xJAob2Jr2upVMIvFEoXNLZTiqd_5nZchNWYV_Be8ixyPHYf3kcskQkox6jkxxOibnjDiYRMTmU0elvPsOpYTo9MUdB06-wC43f2LGtvnmgsUbc3dgrSKul23rhoo-fV5-86CL7vcD26G9fZAWDQ2ENWJUdX6TRgQF7009LV9mUpdmR5ZeHaHhjgMWeEbHUg0UKBXxL_rR6mK4ggOh7W7wMELh-qiLGpkNFrmu3HtIGehlgZfpFkEq8ZO4PHDmaF_yXBrDh8sY7edpITQ0zV0ucmQFRTI1t2FT4S7ihLyUm5QTd3e8WqPdUVXUg' \
    -d '{"name":"Test Posture Check","networkId":"b1bf19b6-7850-4ecb-be56-88ac93218fbf","type":"UNKNOWN","attributes":["Attr-1"],"data":{}}'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 890

{
  "id" : "239bdcbb-cfd9-411e-983a-85e895f69c58",
  "zitiId" : "ziti-63d2c4fd-7d18-4dfb-8b21-3876b1b77bdd",
  "name" : "Test Posture Check",
  "networkId" : "b1bf19b6-7850-4ecb-be56-88ac93218fbf",
  "type" : "UNKNOWN",
  "ownerIdentityId" : "092a10e2-b218-4b6d-bd84-a568accbc284",
  "createdBy" : "092a10e2-b218-4b6d-bd84-a568accbc284",
  "createdAt" : "2020-12-01T13:36:35.201693Z",
  "updatedAt" : "2020-12-01T13:36:35.201693Z",
  "deletedBy" : null,
  "deletedAt" : null,
  "attributes" : [ "Attr-1" ],
  "data" : {
    "description" : null,
    "tags" : null,
    "unknownData" : { }
  },
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/b1bf19b6-7850-4ecb-be56-88ac93218fbf"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/posture-checks/239bdcbb-cfd9-411e-983a-85e895f69c58"
    }
  }
}

Unresolved directive in index.adoc - include::/home/jenkins/workspace/core-management_develop/target/generated-snippets/posture-checks/updte-posture-check/auto-section.adoc[]

Delete Posture Check

DELETE /posture-checks/{id}

Authorization

This endpoint requires delete action on the posture-check resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have delete action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

No links.

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/posture-checks/f31a71b7-b2cd-4291-9e8e-dabd9527ed62' -i -X DELETE \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI1YnFJbUxCT05tUFJ0UlFlWkpKT093IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImM1NjdlZDY5LWY1MjMtNGZiYS1hZjFjLWUyMTdkZjQxNzFkNyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTc5NSwiZXhwIjoxNjA2ODMzMzk1LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjFjZWU0YTJhLTExZjUtNGE3NS1hYzQxLWIyMGRmMjE3MWExM1wiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTc5NX1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.LmVMs4NV_z_2sdVWYw2IwsWiYLEDdKIEMYSGF4mFzpgtnpaz8snJeznK9hdvrxqDOaq8vA-JikU6YSJz5ts7_cvM7lHKtv4niWaHJIm5SI2FvbWfh_1xQhg5IoLOcsOwzR5AQYs0BJKuVV94Lj1s7pDKZOPkTavRIgqBngPDMNpNnOGy8LJJI8e6UqbhTz8Iy3vMG-14r_re2T-BiPZJ61cc4Emqd0od0fjKo6pnIWHkE4-muiZqOKDD72Ny1yJxBhs68Q9cjJXcBg_twhOzwq0Btq7BUki7J7uVu0y_E0Viz3lq-y2vGguWkjHyPQ5q4YRjPTU6jdgYLmgwd6hxoA'

Example response

HTTP/1.1 200 OK

Certificate Authorities

Find Certificate Authorities

GET /certificate-authorities

Authorization

This endpoint requires read action on the certificate-authority resource type.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

networkId

Object

true

name

String

true

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

fingerprint

String

true

networkId

String

false

deletedAt

String

true

jwt

String

true

verified

Boolean

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

endpointAttributes

Array[String]

false

authEnabled

Boolean

true

autoCaEnrollmentEnabled

Boolean

true

ottCaEnrollmentEnabled

Boolean

true

verificationToken

String

true

name

String

false

id

String

true

Path Optional Description

self

false

network

false

Embedded resources

Path Type Optional Description

fingerprint

String

true

networkId

String

false

deletedAt

String

true

jwt

String

true

verified

Boolean

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

endpointAttributes

Array[String]

false

authEnabled

Boolean

true

autoCaEnrollmentEnabled

Boolean

true

ottCaEnrollmentEnabled

Boolean

true

verificationToken

String

true

name

String

false

id

String

true

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/certificate-authorities' -i -X GET \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJfWHFHTGdneU1kQmlsSDJEcDBNSWR3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjE4MTAyOWQ3LWI4MjAtNGQ3NC04MGQ3LWRjMGI0NmE3MzJhZSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTc4MiwiZXhwIjoxNjA2ODMzMzgyLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcImQ3NDMyNDM3LTdmOTItNGYxYS04ZmRkLTdjM2I1NDRmZTczNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTc4Mn1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.eDeFm_1iP9UuU8yQd45wLcfV7GdSuQkhdjDGY48dxf7ZEWUyWm8Qq47UfQXPIsDXPUa7qap5ER4_8svNkttSJCcVCSz-py1l_VAnzBazgZHWRiN0XvhPjIpHhoi8maoXrZTt76O3gaZXxqNHxf3ax6VtYbM_xrg2WhgFDMTW5I4U8-HmZmRTAnSJXGKV59KfIHIDGltfvDgeCoTrga_IRrhjlRU_oLVFjD4j36uV8xfX7hOh0Cb-6xgfXuyIlT7EK2I_I6iPRElY-urwLm5BzEVLZQH68LTQ71EGEU1S3HPf86LaFyTBjmM_6EyP4EM5KMUoLze_WTuAt75DCC-MrA'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 12064

{
  "_embedded" : {
    "certificateAuthorityList" : [ {
      "fingerprint" : null,
      "networkId" : "c7ac2ca6-f91f-4e24-a7f2-313b02e4ffdf",
      "deletedAt" : null,
      "jwt" : null,
      "verified" : false,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:36:22.205596Z",
      "updatedAt" : "2020-12-01T13:36:22.205596Z",
      "deletedBy" : null,
      "endpointAttributes" : [ ],
      "authEnabled" : false,
      "autoCaEnrollmentEnabled" : false,
      "ottCaEnrollmentEnabled" : false,
      "verificationToken" : null,
      "name" : "ACME CA 2020-12-01T13:36:22.205346Z",
      "id" : "83ede9b2-0576-4531-87d3-94fab877b02f",
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/c7ac2ca6-f91f-4e24-a7f2-313b02e4ffdf"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities/83ede9b2-0576-4531-87d3-94fab877b02f"
        }
      }
    }, {
      "fingerprint" : null,
      "networkId" : "c7ac2ca6-f91f-4e24-a7f2-313b02e4ffdf",
      "deletedAt" : null,
      "jwt" : null,
      "verified" : false,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:36:22.206044Z",
      "updatedAt" : "2020-12-01T13:36:22.206044Z",
      "deletedBy" : null,
      "endpointAttributes" : [ ],
      "authEnabled" : false,
      "autoCaEnrollmentEnabled" : false,
      "ottCaEnrollmentEnabled" : false,
      "verificationToken" : null,
      "name" : "ACME CA NO 2020-12-01T13:36:22.205861Z",
      "id" : "7c1c5eb1-49cc-4faa-94ee-3f56b804a4d0",
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/c7ac2ca6-f91f-4e24-a7f2-313b02e4ffdf"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities/7c1c5eb1-49cc-4faa-94ee-3f56b804a4d0"
        }
      }
    }, {
      "fingerprint" : null,
      "networkId" : "72bd8db7-85ea-44b7-bf13-3ad58ea7abd9",
      "deletedAt" : null,
      "jwt" : null,
      "verified" : false,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:36:22.223543Z",
      "updatedAt" : "2020-12-01T13:36:22.223543Z",
      "deletedBy" : null,
      "endpointAttributes" : [ ],
      "authEnabled" : false,
      "autoCaEnrollmentEnabled" : false,
      "ottCaEnrollmentEnabled" : false,
      "verificationToken" : null,
      "name" : "ACME CA 2020-12-01T13:36:22.223312Z",
      "id" : "c18bbeda-cc82-4146-b93d-841567878021",
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/72bd8db7-85ea-44b7-bf13-3ad58ea7abd9"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities/c18bbeda-cc82-4146-b93d-841567878021"
        }
      }
    }, {
      "fingerprint" : null,
      "networkId" : "72bd8db7-85ea-44b7-bf13-3ad58ea7abd9",
      "deletedAt" : null,
      "jwt" : null,
      "verified" : false,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:36:22.224011Z",
      "updatedAt" : "2020-12-01T13:36:22.224011Z",
      "deletedBy" : null,
      "endpointAttributes" : [ ],
      "authEnabled" : false,
      "autoCaEnrollmentEnabled" : false,
      "ottCaEnrollmentEnabled" : false,
      "verificationToken" : null,
      "name" : "ACME CA NO 2020-12-01T13:36:22.223791Z",
      "id" : "e7ad48e9-9796-480a-90fb-00d4ecf1180f",
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/72bd8db7-85ea-44b7-bf13-3ad58ea7abd9"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities/e7ad48e9-9796-480a-90fb-00d4ecf1180f"
        }
      }
    }, {
      "fingerprint" : null,
      "networkId" : "72bd8db7-85ea-44b7-bf13-3ad58ea7abd9",
      "deletedAt" : null,
      "jwt" : null,
      "verified" : false,
      "ownerIdentityId" : "678ce134-1795-4582-b3a6-d15ffa6dfd4a",
      "createdBy" : "678ce134-1795-4582-b3a6-d15ffa6dfd4a",
      "createdAt" : "2020-12-01T13:36:22.453478Z",
      "updatedAt" : "2020-12-01T13:36:22.455216Z",
      "deletedBy" : null,
      "endpointAttributes" : [ "#secureclients" ],
      "authEnabled" : false,
      "autoCaEnrollmentEnabled" : false,
      "ottCaEnrollmentEnabled" : false,
      "verificationToken" : null,
      "name" : "Test ca 02",
      "id" : "6dad8f7f-215b-4123-b5bc-a85a6af77014",
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/72bd8db7-85ea-44b7-bf13-3ad58ea7abd9"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities/6dad8f7f-215b-4123-b5bc-a85a6af77014"
        }
      }
    }, {
      "fingerprint" : null,
      "networkId" : "f9ba1486-d8a7-4495-86a7-e70276821369",
      "deletedAt" : null,
      "jwt" : null,
      "verified" : false,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:36:22.615858Z",
      "updatedAt" : "2020-12-01T13:36:22.651484Z",
      "deletedBy" : null,
      "endpointAttributes" : [ ],
      "authEnabled" : false,
      "autoCaEnrollmentEnabled" : false,
      "ottCaEnrollmentEnabled" : false,
      "verificationToken" : null,
      "name" : "Test ca 02 updated",
      "id" : "9384f6a1-96b5-442a-8542-a68bd573009f",
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/f9ba1486-d8a7-4495-86a7-e70276821369"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities/9384f6a1-96b5-442a-8542-a68bd573009f"
        }
      }
    }, {
      "fingerprint" : null,
      "networkId" : "f9ba1486-d8a7-4495-86a7-e70276821369",
      "deletedAt" : null,
      "jwt" : null,
      "verified" : false,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:36:22.616230Z",
      "updatedAt" : "2020-12-01T13:36:22.616230Z",
      "deletedBy" : null,
      "endpointAttributes" : [ ],
      "authEnabled" : false,
      "autoCaEnrollmentEnabled" : false,
      "ottCaEnrollmentEnabled" : false,
      "verificationToken" : null,
      "name" : "ACME CA NO 2020-12-01T13:36:22.616037Z",
      "id" : "793c538d-f443-422a-ad70-8f9b8d201e2d",
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/f9ba1486-d8a7-4495-86a7-e70276821369"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities/793c538d-f443-422a-ad70-8f9b8d201e2d"
        }
      }
    }, {
      "fingerprint" : null,
      "networkId" : "382ad522-2a8e-4adf-8b9a-5e2658ac2fe3",
      "deletedAt" : null,
      "jwt" : null,
      "verified" : false,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:36:22.693774Z",
      "updatedAt" : "2020-12-01T13:36:22.693774Z",
      "deletedBy" : null,
      "endpointAttributes" : [ ],
      "authEnabled" : false,
      "autoCaEnrollmentEnabled" : false,
      "ottCaEnrollmentEnabled" : false,
      "verificationToken" : null,
      "name" : "ACME CA 2020-12-01T13:36:22.693526Z",
      "id" : "6cf250bf-c631-4909-a4d0-ad42928a89de",
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/382ad522-2a8e-4adf-8b9a-5e2658ac2fe3"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities/6cf250bf-c631-4909-a4d0-ad42928a89de"
        }
      }
    }, {
      "fingerprint" : null,
      "networkId" : "382ad522-2a8e-4adf-8b9a-5e2658ac2fe3",
      "deletedAt" : null,
      "jwt" : null,
      "verified" : false,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:36:22.694132Z",
      "updatedAt" : "2020-12-01T13:36:22.694132Z",
      "deletedBy" : null,
      "endpointAttributes" : [ ],
      "authEnabled" : false,
      "autoCaEnrollmentEnabled" : false,
      "ottCaEnrollmentEnabled" : false,
      "verificationToken" : null,
      "name" : "ACME CA NO 2020-12-01T13:36:22.693961Z",
      "id" : "909f03a0-9b42-4d83-8345-e6e9feedf67b",
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/382ad522-2a8e-4adf-8b9a-5e2658ac2fe3"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities/909f03a0-9b42-4d83-8345-e6e9feedf67b"
        }
      }
    }, {
      "fingerprint" : null,
      "networkId" : "f4aa299f-ac76-4eca-98ed-ef8c3a585bc6",
      "deletedAt" : null,
      "jwt" : null,
      "verified" : false,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:36:22.756123Z",
      "updatedAt" : "2020-12-01T13:36:22.756123Z",
      "deletedBy" : null,
      "endpointAttributes" : [ ],
      "authEnabled" : false,
      "autoCaEnrollmentEnabled" : false,
      "ottCaEnrollmentEnabled" : false,
      "verificationToken" : null,
      "name" : "ACME CA 2020-12-01T13:36:22.755933Z",
      "id" : "8a4d1c52-1c5f-48ce-a5c2-f236b04b0f1e",
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/f4aa299f-ac76-4eca-98ed-ef8c3a585bc6"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities/8a4d1c52-1c5f-48ce-a5c2-f236b04b0f1e"
        }
      }
    }, {
      "fingerprint" : null,
      "networkId" : "70b55449-30a1-41b8-afa1-350b4b3f1b62",
      "deletedAt" : null,
      "jwt" : null,
      "verified" : false,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:36:22.804248Z",
      "updatedAt" : "2020-12-01T13:36:22.804248Z",
      "deletedBy" : null,
      "endpointAttributes" : [ ],
      "authEnabled" : false,
      "autoCaEnrollmentEnabled" : false,
      "ottCaEnrollmentEnabled" : false,
      "verificationToken" : null,
      "name" : "ACME CA 2020-12-01T13:36:22.804064Z",
      "id" : "141a863e-4731-47b4-b222-d6c373c1bb8c",
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/70b55449-30a1-41b8-afa1-350b4b3f1b62"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities/141a863e-4731-47b4-b222-d6c373c1bb8c"
        }
      }
    }, {
      "fingerprint" : null,
      "networkId" : "70b55449-30a1-41b8-afa1-350b4b3f1b62",
      "deletedAt" : null,
      "jwt" : null,
      "verified" : false,
      "ownerIdentityId" : null,
      "createdBy" : null,
      "createdAt" : "2020-12-01T13:36:22.804636Z",
      "updatedAt" : "2020-12-01T13:36:22.804636Z",
      "deletedBy" : null,
      "endpointAttributes" : [ ],
      "authEnabled" : false,
      "autoCaEnrollmentEnabled" : false,
      "ottCaEnrollmentEnabled" : false,
      "verificationToken" : null,
      "name" : "ACME CA NO 2020-12-01T13:36:22.804448Z",
      "id" : "6c8b4c93-771e-4eda-ac40-a761c2f0ad97",
      "_links" : {
        "network" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/networks/70b55449-30a1-41b8-afa1-350b4b3f1b62"
        },
        "self" : {
          "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities/6c8b4c93-771e-4eda-ac40-a761c2f0ad97"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities"
    }
  },
  "page" : {
    "size" : 2000,
    "totalElements" : 12,
    "totalPages" : 1,
    "number" : 0
  }
}

Get Certificate Authority

GET /certificate-authorities/{id}

Authorization

This endpoint requires read action on the certificate-authority resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

fingerprint

String

true

networkId

String

false

deletedAt

String

true

jwt

String

true

verified

Boolean

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

endpointAttributes

Array[String]

false

authEnabled

Boolean

true

autoCaEnrollmentEnabled

Boolean

true

ottCaEnrollmentEnabled

Boolean

true

verificationToken

String

true

name

String

false

id

String

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/certificate-authorities/a7cf5afd-8d00-476d-8658-76d1a6450881' -i -X GET \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIweHdzZGNJWFVpNjlGZzZPcE5Fd2l3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjY0NzZiOWRlLWRlYjQtNDk1Mi1hYTlmLTU0NTNiMzk2ZGJjZSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTc4MiwiZXhwIjoxNjA2ODMzMzgyLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjNlYzgwZTJiLTI4NzQtNDQ4ZC05MzQyLWZiNjQxN2Y1MzU4OFwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTc4Mn1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.FsRtyA7eaYkVP3vU41BivryBOy_BwCYF2bLXuF9PE4HLiS5SLiJawUq7G2XjMkpql0W_kMW40urDg6LXCNu_BVnM1Gk6L12viSRbunIj2D3rcSpEjBKlkRfuSSVGoRyzDi1nIyOAwyA-y-OFaxbJTyQyA7dUJctL_dmFYPG3kwZKHqta_7Z_E2KIs9pnEWckw9BJUF_oH-3ufN2CnFpdeiPS2et2ew4kusU6Id8KvnjNv9IfJsWG3wtQF0pf42RFLNT7PmM5BICv7_JwgLalhgTYEtrSz8wIVYgFs61iUjabmihkBcdQMz0LFTCA2kAjN2SDYJi-iGw6sLQFUj_nbA'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 870

{
  "fingerprint" : null,
  "networkId" : "21afc36b-6810-4a7f-8011-20b19a3d32da",
  "deletedAt" : null,
  "jwt" : null,
  "verified" : false,
  "ownerIdentityId" : null,
  "createdBy" : null,
  "createdAt" : "2020-12-01T13:36:22.906811Z",
  "updatedAt" : "2020-12-01T13:36:22.906811Z",
  "deletedBy" : null,
  "endpointAttributes" : [ ],
  "authEnabled" : false,
  "autoCaEnrollmentEnabled" : false,
  "ottCaEnrollmentEnabled" : false,
  "verificationToken" : null,
  "name" : "ACME CA 2020-12-01T13:36:22.906643Z",
  "id" : "a7cf5afd-8d00-476d-8658-76d1a6450881",
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/21afc36b-6810-4a7f-8011-20b19a3d32da"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities/a7cf5afd-8d00-476d-8658-76d1a6450881"
    }
  }
}

Create Certificate Authority

POST /certificate-authorities

Authorization

This endpoint requires create action on the certificate-authority resource type.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

networkId

String

true

Client must have create action under the annotated resource.

name

String

true

autoCaEnrollmentEnabled

Boolean

true

authEnabled

Boolean

true

ottCaEnrollmentEnabled

Boolean

true

certPem

String

true

endpointAttributes

Array[String]

true

Response fields

Path Type Optional Description

fingerprint

String

true

networkId

String

false

deletedAt

String

true

jwt

String

true

verified

Boolean

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

endpointAttributes

Array[String]

false

authEnabled

Boolean

true

autoCaEnrollmentEnabled

Boolean

true

ottCaEnrollmentEnabled

Boolean

true

verificationToken

String

true

name

String

false

id

String

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/certificate-authorities' -i -X POST \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJOLW92eGhCMmJVem5kalhjZWdvTUtRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjY3OGNlMTM0LTE3OTUtNDU4Mi1iM2E2LWQxNWZmYTZkZmQ0YSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTc4MiwiZXhwIjoxNjA2ODMzMzgyLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjQxODcyMmVmLTA4ZDAtNGFjNS1hZDg5LTMxM2NkMTQ3YWE4MlwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTc4Mn1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.MkMOXbVJxzvrqwOA7X6yTL8afpSroTIbJ3IqNzZLHw4NogfIv1vzGIi_9d_9zYwZJkfRNHEJ79BIdsXspcpBIanPV3vRyD9XpuDXyX6oRWTLXmRZGcMPxboTf--3zARHrFdWEN2qXr4uEbMA30R6sFuDEA22sS2PZZYN7CKMVEHataa8Gfljo4CR32wOfoWc06Az8RQSLu-9PoK7_LZSdF-fj5_FRIhkPTcH_nUXbuUWY6N2Hx6OQvhLdWem03Hal91lHYrZCKg-th2drKvBiPYehE4idZetgpQdcBthLNwqHTO5TlQv4c_D9Tau905koN9RDJgWAX7yZmlszTlMzA' \
    -d '{"networkId":"72bd8db7-85ea-44b7-bf13-3ad58ea7abd9","name":"Test ca 02","autoCaEnrollmentEnabled":true,"authEnabled":false,"ottCaEnrollmentEnabled":false,"certPem":"fakepemdata","endpointAttributes":["#secureclients"]}'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 930

{
  "fingerprint" : null,
  "networkId" : "72bd8db7-85ea-44b7-bf13-3ad58ea7abd9",
  "deletedAt" : null,
  "jwt" : null,
  "verified" : false,
  "ownerIdentityId" : "678ce134-1795-4582-b3a6-d15ffa6dfd4a",
  "createdBy" : "678ce134-1795-4582-b3a6-d15ffa6dfd4a",
  "createdAt" : "2020-12-01T13:36:22.453478Z",
  "updatedAt" : "2020-12-01T13:36:22.455216Z",
  "deletedBy" : null,
  "endpointAttributes" : [ "#secureclients" ],
  "authEnabled" : false,
  "autoCaEnrollmentEnabled" : false,
  "ottCaEnrollmentEnabled" : false,
  "verificationToken" : null,
  "name" : "Test ca 02",
  "id" : "6dad8f7f-215b-4123-b5bc-a85a6af77014",
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/72bd8db7-85ea-44b7-bf13-3ad58ea7abd9"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities/6dad8f7f-215b-4123-b5bc-a85a6af77014"
    }
  }
}

Verify Certificate Authority

POST /certificate-authorities/{id}/verify

Authorization

This endpoint requires update action on the certificate-authority resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have update action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

fingerprint

String

true

networkId

String

false

deletedAt

String

true

jwt

String

true

verified

Boolean

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

endpointAttributes

Array[String]

false

authEnabled

Boolean

true

autoCaEnrollmentEnabled

Boolean

true

ottCaEnrollmentEnabled

Boolean

true

verificationToken

String

true

name

String

false

id

String

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/certificate-authorities/6cf250bf-c631-4909-a4d0-ad42928a89de/verify' -i -X POST \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJrbTB4enpTbTIzdUd5MkVXMi0wRzlRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImMxYjIwODFjLTE3M2MtNDY2OC04YWQ3LTA5MTk2MjQyNGNiZCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTc4MiwiZXhwIjoxNjA2ODMzMzgyLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjFjMjQxODNhLWY2NTAtNGFhOC1iNTNjLWU2MDBiNWM2YWJkN1wiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTc4Mn1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.FQ2gk9QEkC1UhR_-24Cee59pClwOTXaBH5_c3NUGM2VHt3eHZ35938AVOlLN9M6KJtimvO8CZ7Txwoj-TWPxhMF8WSOE0iul0JLO0iDcUhnIILF2IZ37LO5GGLTBlcU3tZ7ipxGW2VDPyIzwgaMKvse48cTBmkacthyhXOy2-BEplt2ZuJM8OqKEGC_K22tqOcjfVFPEysUZ29Z6Z-INFnVBQp9ZdiWg9BjdhugAtc0YyVEJYdobKAtT7uEiZy2xa5TUpXjHTP2a--oxs2QqxGAIsJEeJaavNUYIwMHT0O0fT0ra1fL4t3ViILQooGllsUjTzMUhsfNG2Th-pbK3vw' \
    -d '<testcertverificationbody>'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 870

{
  "fingerprint" : null,
  "networkId" : "382ad522-2a8e-4adf-8b9a-5e2658ac2fe3",
  "deletedAt" : null,
  "jwt" : null,
  "verified" : false,
  "ownerIdentityId" : null,
  "createdBy" : null,
  "createdAt" : "2020-12-01T13:36:22.693774Z",
  "updatedAt" : "2020-12-01T13:36:22.693774Z",
  "deletedBy" : null,
  "endpointAttributes" : [ ],
  "authEnabled" : false,
  "autoCaEnrollmentEnabled" : false,
  "ottCaEnrollmentEnabled" : false,
  "verificationToken" : null,
  "name" : "ACME CA 2020-12-01T13:36:22.693526Z",
  "id" : "6cf250bf-c631-4909-a4d0-ad42928a89de",
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/382ad522-2a8e-4adf-8b9a-5e2658ac2fe3"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities/6cf250bf-c631-4909-a4d0-ad42928a89de"
    }
  }
}

Patch Certificate Authority

PATCH /certificate-authorities/{id}

Authorization

This endpoint requires update action on the certificate-authority resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have update action on the annotated resource.

Query parameters

No parameters.

Request fields

Path Type Optional Description

name

String

true

autoCaEnrollmentEnabled

Boolean

true

authEnabled

Boolean

true

ottCaEnrollmentEnabled

Boolean

true

endpointAttributes

Array[String]

true

Response fields

Path Type Optional Description

fingerprint

String

true

networkId

String

false

deletedAt

String

true

jwt

String

true

verified

Boolean

true

ownerIdentityId

String

true

createdBy

String

true

createdAt

String

true

updatedAt

String

true

deletedBy

String

true

endpointAttributes

Array[String]

false

authEnabled

Boolean

true

autoCaEnrollmentEnabled

Boolean

true

ottCaEnrollmentEnabled

Boolean

true

verificationToken

String

true

name

String

false

id

String

true

Path Optional Description

self

false

network

false

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/certificate-authorities/9384f6a1-96b5-442a-8542-a68bd573009f' -i -X PATCH \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJ2TVFDSEZjSG4yVll2R3hXSW0zNFNRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjNjM2Q0YTc1LTE2NDctNDM0Ni1hOTk1LTA4ZmNiNDQ3MTFlMyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTc4MiwiZXhwIjoxNjA2ODMzMzgyLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjA4YjNlOTg4LTU3N2ItNDczMC05MDRjLWNmYTFlMzE5NmVmY1wiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTc4Mn1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.IDXvfQwA9rZ7pRCHpgOj7hpKzV9SWA9gztZCShjrITx43g9fcByEYbfs6Fm_V32q5Mq9DFdj8k0gmwEN1Cgl3NtWegBwX2mQjd_CZ99yNt2zjgpcGbCSKoxWHr97RaXSbbAQNiE-UrWfpnYbDFcDOmWur1cQBdGsS2j2OLplwdKG1g4_aCpXdk7pNz0trdBOG-DhhRiglTDZsEWmFgoRVEj5hcj5OGR8L2m1kcyaIZIUar3UTzr9GATBNnyrIci9_BcFMLn4uFjPa-u2YnN3F8eA8cKFi7nDP1ZhkeUJF2jHT9JpkqbxftGR4OEVJU21UDUHCJsJIjHMsc5ii_kdnQ' \
    -d '{"name":"Test ca 02 updated","autoCaEnrollmentEnabled":null,"authEnabled":null,"ottCaEnrollmentEnabled":null,"endpointAttributes":[]}'

Example response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 853

{
  "fingerprint" : null,
  "networkId" : "f9ba1486-d8a7-4495-86a7-e70276821369",
  "deletedAt" : null,
  "jwt" : null,
  "verified" : false,
  "ownerIdentityId" : null,
  "createdBy" : null,
  "createdAt" : "2020-12-01T13:36:22.615858Z",
  "updatedAt" : "2020-12-01T13:36:22.651484Z",
  "deletedBy" : null,
  "endpointAttributes" : [ ],
  "authEnabled" : false,
  "autoCaEnrollmentEnabled" : false,
  "ottCaEnrollmentEnabled" : false,
  "verificationToken" : null,
  "name" : "Test ca 02 updated",
  "id" : "9384f6a1-96b5-442a-8542-a68bd573009f",
  "_links" : {
    "network" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/networks/f9ba1486-d8a7-4495-86a7-e70276821369"
    },
    "self" : {
      "href" : "https://gateway.production.netfoundry.io/core/v2/certificate-authorities/9384f6a1-96b5-442a-8542-a68bd573009f"
    }
  }
}

Delete Certificate Authority

DELETE /certificate-authorities/{id}

Authorization

This endpoint requires delete action on the certificate-authority resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have delete action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

No links.

Embedded resources

No embedded resources.

Example request

$ curl 'https://gateway.production.netfoundry.io/core/v2/certificate-authorities/898fcb78-0a93-4c86-bbcb-0677e4856302' -i -X DELETE \
    -H 'Content-Type: application/hal+json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI0VGhIZzNRbzhGR3ZPQm9ZOGxJRGZRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjJiZDA1NWI3LTcyODgtNDQwNC1iZDM0LWY3NmJjMTE2NTNkNSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkubmV0d29yayIsImlhdCI6MTYwNjgyOTc4MiwiZXhwIjoxNjA2ODMzMzgyLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbXSIsImdyYW50cy1hY3Rpb24iOiJbe1wiaWRcIjpcIjExMTg3ZGU5LWY3MGMtNGM4OS05MDlkLTk4NTRkMDhkMzQwZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYwNjgyOTc4Mn1dIiwiZ3JhbnRzLXN0YW5kYXJkIjoiW10ifQ.WgPJB1ChikPtE7snhxlJSx5uXaBLD3WAj-qk3xyh8hwGPZCca-akzk7ZslE2nJGpDV7rKBKOIAa5jhEkWt_KnYhzbdLHQDUySTFWe6KjK_Yg_eSvuY9H-JFgl3El0sI_1ThQulVj8rc2s3l_H3wuyu7j-x7qFLD-gB7du41EUHlxxpu7rp4-VkuqjhXyZAswuqsghP34vBSSO50lSzutTVnrtKAt-oJ1osASRi_TTiPWiTSWjmNicAM601Qb-MM0G2IqkJfrmsd2i5uhdoGZlG-ROcMu1dGvXms2xR_PtnHNleRgphqKKC11T1fycyjb7K6OB285PyKyj_AEYWig4g'

Example response

HTTP/1.1 200 OK