diff --git a/_vendor/github.com/linode/linode-api-docs/v4/openapi.yaml b/_vendor/github.com/linode/linode-api-docs/v4/openapi.yaml index bc530343b71..8efc7a3c7cd 100644 --- a/_vendor/github.com/linode/linode-api-docs/v4/openapi.yaml +++ b/_vendor/github.com/linode/linode-api-docs/v4/openapi.yaml @@ -1,6 +1,6 @@ openapi: 3.0.1 info: - version: 4.173.0 + version: 4.174.0 title: Linode API license: name: Apache 2.0 @@ -6613,7 +6613,7 @@ paths: "subnet_id": 101, "ipv4": { "vpc": "10.0.1.2", - "nat_1_1": "203.0.113.2" + "nat_1_1": "add" } } ], @@ -8248,7 +8248,9 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/Disk' + properties: + label: + $ref: '#/components/schemas/Disk/properties/label' responses: '200': description: The updated Disk. @@ -8550,8 +8552,10 @@ paths: tags: - Linode Instances summary: Networking Information List - description: > + description: | Returns networking information for a single Linode. + + **Note:** If the target Linode has several configuration profiles that include a Virtual Private Cloud (VPC) interface, address information for all of VPCs will be listed in the response. operationId: getLinodeIPs x-linode-cli-action: ips-list security: @@ -8593,13 +8597,13 @@ paths: description: > A list of private IP Address objects belonging to this Linode. readOnly: true - shared: + vpc: type: array readOnly: true items: - $ref: '#/components/schemas/IPAddress' + $ref: '#/components/schemas/IPAddressesVPCListResponse' description: > - A list of shared IP Address objects assigned to this Linode. + A list of Virtual Private Cloud (VPC)-specific addresses or ranges for the Linode. reserved: type: array readOnly: true @@ -8607,6 +8611,13 @@ paths: $ref: '#/components/schemas/IPAddress' description: > A list of reserved IP Address objects belonging to this Linode. + shared: + type: array + readOnly: true + items: + $ref: '#/components/schemas/IPAddress' + description: > + A list of shared IP Address objects assigned to this Linode. ipv6: type: object description: > @@ -19902,6 +19913,85 @@ paths: linode-cli vpcs update $vpcId \ --description "A description of my VPC." --label cool-vpc + /vpcs/ips: + get: + x-linode-grant: read_only + tags: + - VPCs + summary: VPC IP Addresses List + servers: + - url: https://api.linode.com/v4 + parameters: + - $ref: '#/components/parameters/pageOffset' + - $ref: '#/components/parameters/pageSize' + description: | + Returns a paginated list of all VPC IP addresses and address ranges on your account. + + **Note**: If a Linode has several configuration profiles that include a VPC interface, address information for all of them is listed in the response. Since VPCs can use the same address space, you may see duplicate IP addresses. + operationId: getAllVPCIPs + x-linode-cli-action: + - ip-list + - ip-ls + security: + - personalAccessToken: [] + - oauth: + - ips:read_only + responses: + '200': + description: A paginated list of VPC interface IP addresses. + content: + application/json: + schema: + $ref: '#/components/schemas/IPAddressesVPCListResponse' + default: + $ref: '#/components/responses/ErrorResponse' + x-code-samples: + - lang: Shell + source: > + curl -H "Authorization: Bearer $TOKEN" \ + https://api.linode.com/v4/networking/vpcs/ips + - lang: CLI + source: > + linode-cli vpcs ip list + /vpcs/{vpcId}/ips: + parameters: + - $ref: '#/components/parameters/vpcId' + get: + tags: + - VPCs + summary: VPC IP Addresses View + servers: + - url: https://api.linode.com/v4 + parameters: + - $ref: '#/components/parameters/pageOffset' + - $ref: '#/components/parameters/pageSize' + description: | + Returns a paginated list of IP addresses for a single VPC. + operationId: getVPCIPs + x-linode-cli-action: + - ip-list + - ip-ls + security: + - personalAccessToken: [] + - oauth: + - ips:read_only + responses: + '200': + description: The IP addresses for the requested VPC. + content: + application/json: + schema: + $ref: '#/components/schemas/IPAddressesVPCListResponse' + default: + $ref: '#/components/responses/ErrorResponse' + x-code-samples: + - lang: Shell + source: > + curl -H "Authorization: Bearer $TOKEN" \ + https://api.linode.com/v4/vpcs/123/ips + - lang: CLI + source: > + linode-cli vpcs ip-list 123 /vpcs/{vpcId}/subnets: x-linode-cli-command: vpcs parameters: @@ -21800,7 +21890,7 @@ components: The interval, in seconds, at which a failed refresh should be retried. * Valid values are - 0, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200. + 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200. * Any other value is rounded up to the nearest valid value. @@ -21832,7 +21922,7 @@ components: authoritative. * Valid values are - 0, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200. + 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200. * Any other value is rounded up to the nearest valid value. @@ -21845,7 +21935,7 @@ components: The amount of time in seconds before this Domain should be refreshed. * Valid values are - 0, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200. + 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200. * Any other value is rounded up to the nearest valid value. @@ -21859,7 +21949,7 @@ components: records may be cached by resolvers or other domain servers. * Valid values are - 0, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200. + 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200. * Any other value is rounded up to the nearest valid value. @@ -23000,21 +23090,23 @@ components: format: date-time nullable: true description: > - Only Images created automatically from a deleted Linode (type=automatic) will expire. + Only Images created automatically from a deleted Linode (type=automatic) will expire. `null` for private Images. example: null readOnly: true eol: type: string format: date-time + nullable: true description: > - The date of the public Image's planned end of life. `None` for private Images. + The date of the public Image's planned end of life. `null` for private Images. example: '2026-07-01T04:00:00' readOnly: true vendor: x-linode-filterable: true type: string + nullable: true description: > - The upstream distribution vendor. `None` for private Images. + The upstream distribution vendor. `null` for private Images. example: Debian readOnly: true x-linode-cli-display: 3 @@ -23454,7 +23546,6 @@ components: format: ipv4 description: | The IPv4 address that is configured as a 1:1 NAT for this VPC interface. - example: 192.0.2.1 IPAddressesShareRequest: type: object description: A request object IP Addresses Share (POST /networking/ips/share) @@ -23481,6 +23572,113 @@ components: * Can include both private and public IPv4 addresses. * You must have access to all of these addresses and they must be in the same Region as the primary Linode. * Enter an empty array to remove all shared IP addresses. + IPAddressesVPCListResponse: + description: The response data for the VPC IP Addresses List and View operations. + allOf: + - $ref: '#/components/schemas/PaginationEnvelope' + - type: object + properties: + data: + type: array + items: + type: object + description: > + A VPC IP address that exists in Linode's system, specific to the response for the VPC IP Addresses List command. Returned as an empty set for Linodes that are not part of a VPC. + properties: + active: + type: boolean + description: > + Returns `true` if the VPC interface is in use, meaning that the Linode was powered on using the `config_id` to which the interface belongs. Otherwise returns `false`. + example: true + readOnly: true + x-linode-filterable: true + address: + type: string + format: ip + description: > + An IPv4 address configured for this VPC interface. Displayed as `null` if an `address_range`. + example: 192.0.2.141 + nullable: true + readOnly: true + x-linode-cli-display: 1 + address_range: + type: string + description: > + A range of IPv4 addresses configured for this VPC interface. Displayed as `null` if a single `address`. + nullable: true + readOnly: true + config_id: + type: integer + description: > + The globally general entity identifier for the Linode configuration profile where the VPC is included. + example: 4567 + readOnly: true + x-linode-filterable: true + gateway: + type: string + format: ip + description: > + The default gateway for the VPC subnet that the IP or IP range belongs to. + example: 192.0.2.1 + nullable: true + readOnly: true + interface_id: + type: integer + description: > + The globally general API entity identifier for the Linode interface. + example: 2435 + readOnly: true + linode_id: + type: integer + description: > + The identifier for the Linode the VPC interface currently belongs to. + example: 123 + readOnly: true + x-linode-cli-display: 6 + x-linode-filterable: true + nat_1_1: + type: string + format: ip + description: > + The public IP address used for NAT 1:1 with the VPC. This is `null` if the VPC interface uses an `address_range` or NAT 1:1 isn't used. + example: null + nullable: true + readOnly: true + prefix: + type: integer + description: > + The number of bits set in the `subnet_mask`. + example: 24 + nullable: true + readOnly: true + region: + type: string + description: > + The region of the VPC. + example: us-east + readOnly: true + x-linode-filterable: true + x-linode-cli-display: 5 + subnet_id: + type: integer + nullable: false + description: | + The `id` of the VPC Subnet for this interface. + example: 101 + subnet_mask: + type: string + format: ip + description: > + The mask that separates host bits from network bits for the `address` or `address_range`. + example: 255.255.255.0 + readOnly: true + vpc_id: + type: integer + description: > + The unique globally general API entity identifier for the VPC. + example: 7654 + readOnly: true + x-linode-filterable: true IPAddressPrivate: type: object description: > @@ -23551,7 +23749,7 @@ components: IPAddressV6LinkLocal: type: object description: > - A link-local IPv6 address that exists in Linode's system,. + A link-local IPv6 address that exists in Linode's system. properties: address: type: string @@ -24445,6 +24643,8 @@ components: * Setting the value to a specific public IPv4 address that is assigned to the Linode enables a 1:1 NAT between that address and the VPC Subnet IPv4 address. * The public IPv4 address can't be shared with another Linode. * If omitted, set to `null`, or set to an empty string (`""`), no 1:1 NAT is established. + + **Note**: When creating a new compute-instance, you can't set this to a specific IPv4 address. When a new compute instance is created, the network establishes a public IPv4 address for it. Since this address doesn't exist yet, you can't include a custom IPv4 address to change it. Once your compute instances is created, you can [update your configuration profile interface](https://www.linode.com/docs/api/linode-instances/#configuration-profile-interface-update) to change the `nat_1_1` address. example: '203.0.113.2' # ipv6: # type: object @@ -24474,7 +24674,7 @@ components: type: array nullable: true description: | - An array of IPv4 CIDR VPC Subnet ranges that are routed to this Interface. **IPv6 ranges are also available to select participants in the Beta program.** + An array of IPv4 CIDR VPC Subnet ranges that are routed to this Interface. * Array items are only allowed for `vpc` type Interfaces. * This must be empty for non-`vpc` type Interfaces. diff --git a/_vendor/modules.txt b/_vendor/modules.txt index c843fab6c36..a67b981cfe7 100644 --- a/_vendor/modules.txt +++ b/_vendor/modules.txt @@ -5,4 +5,4 @@ # github.com/bep/turbo/v7 v7.20300.20000 # github.com/gohugoio/hugo-mod-jslibs/instantpage v0.5.1 # github.com/instantpage/instant.page v5.1.1+incompatible -# github.com/linode/linode-api-docs/v4 v4.173.0 +# github.com/linode/linode-api-docs/v4 v4.174.0 diff --git a/go.mod b/go.mod index 4a0ac845af8..cb2e48bc397 100644 --- a/go.mod +++ b/go.mod @@ -4,6 +4,6 @@ go 1.15 require ( github.com/hotwired/turbo v7.0.1+incompatible // indirect - github.com/linode/linode-api-docs/v4 v4.173.0 // indirect + github.com/linode/linode-api-docs/v4 v4.174.0 // indirect github.com/linode/linode-docs-theme v0.0.0-20240319173150-b92334abe6d7 // indirect ) diff --git a/go.sum b/go.sum index 83df9c4b68b..21d6b88914d 100644 --- a/go.sum +++ b/go.sum @@ -121,6 +121,8 @@ github.com/linode/linode-api-docs/v4 v4.171.0 h1:hEd02yYnRH+ZRokR+694+qU8XTaBD3B github.com/linode/linode-api-docs/v4 v4.171.0/go.mod h1:JRT7kOTjArLJngT4KkAnxWNGszYSP+zlQg2OHQ407RI= github.com/linode/linode-api-docs/v4 v4.173.0 h1:bh4gyJjunSLHuHn5SwrfrXn7QngdijND4eoGMjFpAPw= github.com/linode/linode-api-docs/v4 v4.173.0/go.mod h1:JRT7kOTjArLJngT4KkAnxWNGszYSP+zlQg2OHQ407RI= +github.com/linode/linode-api-docs/v4 v4.174.0 h1:7JHnjost3yfLZnKtzhWXgwdqXVPTIGl1GMa/67ozBXk= +github.com/linode/linode-api-docs/v4 v4.174.0/go.mod h1:JRT7kOTjArLJngT4KkAnxWNGszYSP+zlQg2OHQ407RI= github.com/linode/linode-docs-theme v0.0.0-20220622135843-166f108e1933 h1:QchGQS6xESuyjdlNJEjvq2ftGX0sCTAhPhD5hAOJVMI= github.com/linode/linode-docs-theme v0.0.0-20220622135843-166f108e1933/go.mod h1:6kYeZt+rMvJFZ9Wbnm4CDSn8Sg1MuYjr2Kx6W/awiQM= github.com/linode/linode-docs-theme v0.0.0-20220718150422-ea48dbf69943 h1:BE3OgPTfmSdYeNUxcC1clIpJZhdMmYByCCCap0njwyY=