Skip to content

Commit 2341d3c

Browse files
leslitagorditabbiggerr
authored andcommitted
Add info about support VLAN DCs
1 parent 5e70fb1 commit 2341d3c

File tree

1 file changed

+19
-6
lines changed

1 file changed

+19
-6
lines changed

openapi.yaml

Lines changed: 19 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3808,8 +3808,12 @@ paths:
38083808
type: object
38093809
description: >
38103810
The Network Interface(s) to add to this Linode. This field is only required when creating
3811-
a Linode that is attached to a Virtual Local Area Network (VLAN). **Note**: You must [create
3812-
the VLAN](/docs/api/networking/#vlan-create) prior to attaching a Linode to it.
3811+
a Linode that is attached to a Virtual Local Area Network (VLAN).
3812+
3813+
3814+
**Note**: You must [create the VLAN](/docs/api/networking/#vlan-create) prior to attaching a Linode to it. Linode VLAN is available in Next Generation Network (NGN) [data centers](https://www.linode.com/global-infrastructure/).
3815+
This includes Toronto (`ca-central`), Mumbai (`ap-west`), and Sydney (`ap-southeast`). A Linode can only be attached
3816+
to a VLAN that resides within the same data center region as the Linode.
38133817

38143818
* A Linode can only have one Network Interface of `type: default`. This is the Linode's
38153819
public Network Interface, which allows the Linode to communicate across public networks.
@@ -3829,7 +3833,7 @@ paths:
38293833
* Then,[booting the Linode](/docs/api/linode-instances/#linode-boot) into the Configuration Profile.
38303834

38313835
* You can omit this field in your POST request and attach this Linode to a VLAN at a
3832-
later time by using the VLANs Attach endpoint.
3836+
later time by using the [VLAN Attach](/docs/api/networking/#vlan-attach) endpoint.
38333837

38343838

38353839
**Note:** Once this Linode is created, you can view this Linode's Network Interfaces by
@@ -10962,6 +10966,9 @@ paths:
1096210966
* To attach an existing Linode to this VLAN, use this endpoint's `linodes` array when creating your VLAN
1096310967
or use the VLANs Attach endpoint.
1096410968

10969+
* Linode VLAN is available in Next Generation Network (NGN) [data centers](https://www.linode.com/global-infrastructure/).
10970+
This includes Toronto (`ca-central`), Mumbai (`ap-west`), and Sydney (`ap-southeast`).
10971+
1096510972

1096610973
**Beta**: This endpoint is in beta. Please make sure to prepend all requests with
1096710974
`/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking
@@ -11027,7 +11034,7 @@ paths:
1102711034
-H "Authorization: Bearer $TOKEN" \
1102811035
-X POST -d '{
1102911036
"description": "My example VLAN",
11030-
"region": "us-east",
11037+
"region": "ca-central",
1103111038
"linodes": [
1103211039
123,
1103311040
456,
@@ -11039,7 +11046,7 @@ paths:
1103911046
- lang: CLI
1104011047
source: >
1104111048
linode-cli networking vlan-create \
11042-
--region us-east \
11049+
--region ca-central \
1104311050
--description "My example VLAN" \
1104411051
--linodes [123, 456, 789] \
1104511052
--cidr_block "10.0.0.0/24"
@@ -11151,9 +11158,15 @@ paths:
1115111158
belonging to the Linode.
1115211159

1115311160

11161+
**Note**: Linode VLAN is available in Next Generation Network (NGN) [data centers](https://www.linode.com/global-infrastructure/).
11162+
This includes Toronto (`ca-central`), Mumbai (`ap-west`), and Sydney (`ap-southeast`). A Linode can only be attached
11163+
to a VLAN that resides within the same data center region as the Linode.
11164+
11165+
1115411166
For more fine-grained control, use the [Interface Create](/docs/api/linode-instances/#interface-create) endpoint to assign Network Interfaces to a Linode
1115511167
and the [Configuration Profile Update](/docs/api/linode-instances/#configuration-profile-update) endpoint to add the Network Interface(s) to a specific Configuration Profile belonging to a Linode.
1115611168

11169+
1115711170
**Beta**: This endpoint is in beta. Please make sure to prepend all requests with
1115811171
`/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking
1115911172
updates in the future. This notice will be removed when this endpoint is out of
@@ -22170,7 +22183,7 @@ components:
2217022183

2217122184
**Note:** Currently, a VLAN can only be assigned to a Linode
2217222185
within the same data center region.
22173-
example: us-east
22186+
example: ca-central
2217422187
x-linode-cli-display: 3
2217522188
x-linode-filterable: true
2217622189
linodes:

0 commit comments

Comments
 (0)