curl --request POST \
--url https://api.example.com/api/v2/networks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"metadata": {
"name": "network-name",
"description": "A verbose description",
"tags": [
{
"name": "cluster-id",
"value": "9361402c-f998-49cc-ab21-9bb99afcfde8"
}
]
},
"spec": {
"organizationId": "161b9d5a-701d-4fea-848d-0e345edf16e9",
"projectId": "f113be96-4dd2-4c14-9c0e-e96c500f21e0",
"regionId": "c7568e2d-f9ab-453d-9a3a-51375f78426b",
"prefix": "192.168.0.0/24",
"dnsNameservers": [
"8.8.8.8"
],
"routes": [
{
"prefix": "10.0.0.0/8",
"nexthop": "192.168.0.10"
}
]
}
}
'{
"metadata": {
"id": "a64f9269-36e0-4312-b8d1-52d93d569b7b",
"name": "my-network",
"organizationId": "9a8c6370-4065-4d4a-9da0-7678df40cd9d",
"projectId": "e36c058a-8eba-4f5b-91f4-f6ffb983795c",
"creationTime": "2024-05-31T14:11:00Z",
"createdBy": "[email protected]",
"provisioningStatus": "provisioned",
"healthStatus": "healthy"
},
"spec": {
"dnsNameservers": [
"8.8.8.8"
]
},
"status": {
"regionId": "d891dbf0-0a01-4efc-ae3a-5d77f6d3424b",
"prefix": "192.168.0.0/24"
}
}Create a new network.
curl --request POST \
--url https://api.example.com/api/v2/networks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"metadata": {
"name": "network-name",
"description": "A verbose description",
"tags": [
{
"name": "cluster-id",
"value": "9361402c-f998-49cc-ab21-9bb99afcfde8"
}
]
},
"spec": {
"organizationId": "161b9d5a-701d-4fea-848d-0e345edf16e9",
"projectId": "f113be96-4dd2-4c14-9c0e-e96c500f21e0",
"regionId": "c7568e2d-f9ab-453d-9a3a-51375f78426b",
"prefix": "192.168.0.0/24",
"dnsNameservers": [
"8.8.8.8"
],
"routes": [
{
"prefix": "10.0.0.0/8",
"nexthop": "192.168.0.10"
}
]
}
}
'{
"metadata": {
"id": "a64f9269-36e0-4312-b8d1-52d93d569b7b",
"name": "my-network",
"organizationId": "9a8c6370-4065-4d4a-9da0-7678df40cd9d",
"projectId": "e36c058a-8eba-4f5b-91f4-f6ffb983795c",
"creationTime": "2024-05-31T14:11:00Z",
"createdBy": "[email protected]",
"provisioningStatus": "provisioned",
"healthStatus": "healthy"
},
"spec": {
"dnsNameservers": [
"8.8.8.8"
]
},
"status": {
"regionId": "d891dbf0-0a01-4efc-ae3a-5d77f6d3424b",
"prefix": "192.168.0.0/24"
}
}Operation requires OAuth 2.0 bearer token authentication.
A request for a network create.
A network request.
Metadata required for all API resource reads and writes.
Show child attributes
A valid Kubernetes label value, typically used for resource names that can be indexed in the database.
The resource description, this optionally augments the name with more context.
A network's specification. A network's specification.
Show child attributes
A list of IPv4 addresses.
An IPv4 address.
The organization to provision the resource in.
The project to provision the resource in.
The region a network is to be provisioned in.
An IPv4 prefix for the network.
A layer 3 network.
A network.
Metadata required by project scoped resource reads.
Show child attributes
A valid Kubernetes label value, typically used for resource names that can be indexed in the database.
The unique resource ID.
The time the resource was created.
The provisioning state of a resource.
unknown, provisioning, provisioned, deprovisioning, error The health state of a resource.
unknown, healthy, degraded, error The organization identifier the resource belongs to.
The project identifier the resource belongs to.
The resource description, this optionally augments the name with more context.
The user who created the resource.
The time a resource was updated.
The user who updated the resource.
The time the resource was deleted.
A network's specification.
Show child attributes