vpc.md

vpc

Create, read, and update a Linode VPC.

• Minimum Required Fields
• Examples
• Parameters
• Return Values

Minimum Required Fields

Field	Type	Required	Description
api_token	str	Required	The Linode account personal access token. It is necessary to run the module. It can be exposed by the environment variable LINODE_API_TOKEN instead. See details in Usage.

Examples

- name: Create a VPC 
  linode.cloud.vpc:
    label: my-vpc
    region: us-east
    description: A description of this VPC.
    state: present

- name: Delete a VPC
  linode.cloud.vpc:
    label: my-vpc
    state: absent

Parameters

Field	Type	Required	Description
label	str	Required	This VPC's unique label.
state	str	Required	The state of this token. (Choices: present, absent)
description	str	Optional	A description describing this VPC.
region	str	Optional	The region this VPC is located in.

Return Values

• vpc - The VPC in JSON serialized form.

  • Sample Response:

    {
        "created": "2023-08-31T18:35:01",
        "description": "A description of this VPC",
        "id": 344,
        "label": "my-vpc",
        "region": "us-east",
        "subnets": [],
        "updated": "2023-08-31T18:35:03"
    }

  • See the Linode API response documentation for a list of returned fields