route_tables
Creates, updates, deletes, gets or lists a route_tables resource.
Overview
| Name | route_tables |
| Type | Resource |
| Id | azure.network.route_tables |
Fields
The following fields are returned by SELECT queries:
- get
- list
- list_all
| Name | Datatype | Description |
|---|---|---|
id | string | Resource ID. |
name | string | Resource name. |
disableBgpRoutePropagation | boolean | Whether to disable the routes learned by BGP on that route table. True means disable. |
disablePeeringRoute | string | Whether to disable the routes learned by peering on the route table. 'None' means peering routes are enabled, 'All' means all peering routes are disabled. Known values are: "None" and "All". (None, All) |
etag | string | A unique read-only string that changes whenever the resource is updated. |
location | string | Resource location. |
provisioningState | string | The provisioning state of the route table resource. Known values are: "Failed", "Succeeded", "Canceled", "Creating", "Updating", and "Deleting". (Failed, Succeeded, Canceled, Creating, Updating, Deleting) |
resourceGuid | string | The resource GUID property of the route table. |
routes | array | Collection of routes contained within a route table. |
subnets | array | A collection of references to subnets. |
tags | object | Resource tags. |
type | string | Resource type. |
| Name | Datatype | Description |
|---|---|---|
id | string | Resource ID. |
name | string | Resource name. |
disableBgpRoutePropagation | boolean | Whether to disable the routes learned by BGP on that route table. True means disable. |
disablePeeringRoute | string | Whether to disable the routes learned by peering on the route table. 'None' means peering routes are enabled, 'All' means all peering routes are disabled. Known values are: "None" and "All". (None, All) |
etag | string | A unique read-only string that changes whenever the resource is updated. |
location | string | Resource location. |
provisioningState | string | The provisioning state of the route table resource. Known values are: "Failed", "Succeeded", "Canceled", "Creating", "Updating", and "Deleting". (Failed, Succeeded, Canceled, Creating, Updating, Deleting) |
resourceGuid | string | The resource GUID property of the route table. |
routes | array | Collection of routes contained within a route table. |
subnets | array | A collection of references to subnets. |
tags | object | Resource tags. |
type | string | Resource type. |
| Name | Datatype | Description |
|---|---|---|
id | string | Resource ID. |
name | string | Resource name. |
disableBgpRoutePropagation | boolean | Whether to disable the routes learned by BGP on that route table. True means disable. |
disablePeeringRoute | string | Whether to disable the routes learned by peering on the route table. 'None' means peering routes are enabled, 'All' means all peering routes are disabled. Known values are: "None" and "All". (None, All) |
etag | string | A unique read-only string that changes whenever the resource is updated. |
location | string | Resource location. |
provisioningState | string | The provisioning state of the route table resource. Known values are: "Failed", "Succeeded", "Canceled", "Creating", "Updating", and "Deleting". (Failed, Succeeded, Canceled, Creating, Updating, Deleting) |
resourceGuid | string | The resource GUID property of the route table. |
routes | array | Collection of routes contained within a route table. |
subnets | array | A collection of references to subnets. |
tags | object | Resource tags. |
type | string | Resource type. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | resource_group_name, route_table_name, subscription_id | $expand | Gets the specified route table. |
list | select | resource_group_name, subscription_id | Gets all route tables in a resource group. | |
list_all | select | subscription_id | Gets all route tables in a subscription. | |
create_or_update | insert | resource_group_name, route_table_name, subscription_id | Create or updates a route table in a specified resource group. | |
update_tags | update | resource_group_name, route_table_name, subscription_id | Updates a route table tags. | |
create_or_update | replace | resource_group_name, route_table_name, subscription_id | Create or updates a route table in a specified resource group. | |
delete | delete | resource_group_name, route_table_name, subscription_id | Deletes the specified route table. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
resource_group_name | string | The name of the resource group. The name is case insensitive. Required. |
route_table_name | string | The name of the route table. Required. |
subscription_id | string | |
$expand | string | Expands referenced resources. Default value is None. |
SELECT examples
- get
- list
- list_all
Gets the specified route table.
SELECT
id,
name,
disableBgpRoutePropagation,
disablePeeringRoute,
etag,
location,
provisioningState,
resourceGuid,
routes,
subnets,
tags,
type
FROM azure.network.route_tables
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND route_table_name = '{{ route_table_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
AND $expand = '{{ $expand }}'
;
Gets all route tables in a resource group.
SELECT
id,
name,
disableBgpRoutePropagation,
disablePeeringRoute,
etag,
location,
provisioningState,
resourceGuid,
routes,
subnets,
tags,
type
FROM azure.network.route_tables
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;
Gets all route tables in a subscription.
SELECT
id,
name,
disableBgpRoutePropagation,
disablePeeringRoute,
etag,
location,
provisioningState,
resourceGuid,
routes,
subnets,
tags,
type
FROM azure.network.route_tables
WHERE subscription_id = '{{ subscription_id }}' -- required
;
INSERT examples
- create_or_update
- Manifest
Create or updates a route table in a specified resource group.
INSERT INTO azure.network.route_tables (
id,
location,
tags,
properties,
resource_group_name,
route_table_name,
subscription_id
)
SELECT
'{{ id }}',
'{{ location }}',
'{{ tags }}',
'{{ properties }}',
'{{ resource_group_name }}',
'{{ route_table_name }}',
'{{ subscription_id }}'
RETURNING
id,
name,
etag,
location,
properties,
tags,
type
;
# Description fields are for documentation purposes
- name: route_tables
props:
- name: resource_group_name
value: "{{ resource_group_name }}"
description: Required parameter for the route_tables resource.
- name: route_table_name
value: "{{ route_table_name }}"
description: Required parameter for the route_tables resource.
- name: subscription_id
value: "{{ subscription_id }}"
description: Required parameter for the route_tables resource.
- name: id
value: "{{ id }}"
description: |
Resource ID.
- name: location
value: "{{ location }}"
description: |
Resource location.
- name: tags
value: "{{ tags }}"
description: |
Resource tags.
- name: properties
description: |
Properties of the route table.
value:
routes:
- id: "{{ id }}"
name: "{{ name }}"
type: "{{ type }}"
properties:
addressPrefix: "{{ addressPrefix }}"
nextHopType: "{{ nextHopType }}"
nextHopIpAddress: "{{ nextHopIpAddress }}"
nextHop:
nextHopIpAddresses:
- "{{ nextHopIpAddresses }}"
provisioningState: "{{ provisioningState }}"
hasBgpOverride: {{ hasBgpOverride }}
etag: "{{ etag }}"
subnets:
- id: "{{ id }}"
name: "{{ name }}"
type: "{{ type }}"
properties:
addressPrefix: "{{ addressPrefix }}"
addressPrefixes:
- "{{ addressPrefixes }}"
networkSecurityGroup:
id: "{{ id }}"
name: "{{ name }}"
type: "{{ type }}"
location: "{{ location }}"
tags: "{{ tags }}"
properties:
flushConnection: {{ flushConnection }}
securityRules: "{{ securityRules }}"
defaultSecurityRules: "{{ defaultSecurityRules }}"
networkInterfaces: "{{ networkInterfaces }}"
subnets: "{{ subnets }}"
flowLogs: "{{ flowLogs }}"
resourceGuid: "{{ resourceGuid }}"
provisioningState: "{{ provisioningState }}"
etag: "{{ etag }}"
routeTable:
id: "{{ id }}"
name: "{{ name }}"
type: "{{ type }}"
location: "{{ location }}"
tags: "{{ tags }}"
properties:
routes: "{{ routes }}"
subnets: "{{ subnets }}"
disableBgpRoutePropagation: {{ disableBgpRoutePropagation }}
disablePeeringRoute: "{{ disablePeeringRoute }}"
provisioningState: "{{ provisioningState }}"
resourceGuid: "{{ resourceGuid }}"
etag: "{{ etag }}"
natGateway:
id: "{{ id }}"
serviceEndpoints:
- service: "{{ service }}"
networkIdentifier:
id: "{{ id }}"
locations: "{{ locations }}"
provisioningState: "{{ provisioningState }}"
serviceEndpointPolicies:
- id: "{{ id }}"
name: "{{ name }}"
type: "{{ type }}"
location: "{{ location }}"
tags: "{{ tags }}"
properties:
serviceEndpointPolicyDefinitions: "{{ serviceEndpointPolicyDefinitions }}"
subnets: "{{ subnets }}"
resourceGuid: "{{ resourceGuid }}"
provisioningState: "{{ provisioningState }}"
serviceAlias: "{{ serviceAlias }}"
contextualServiceEndpointPolicies: "{{ contextualServiceEndpointPolicies }}"
etag: "{{ etag }}"
kind: "{{ kind }}"
privateEndpoints:
- id: "{{ id }}"
name: "{{ name }}"
type: "{{ type }}"
location: "{{ location }}"
tags: "{{ tags }}"
properties:
subnet: "{{ subnet }}"
networkInterfaces: "{{ networkInterfaces }}"
provisioningState: "{{ provisioningState }}"
ipVersionType: "{{ ipVersionType }}"
privateLinkServiceConnections: "{{ privateLinkServiceConnections }}"
manualPrivateLinkServiceConnections: "{{ manualPrivateLinkServiceConnections }}"
customDnsConfigs: "{{ customDnsConfigs }}"
applicationSecurityGroups: "{{ applicationSecurityGroups }}"
ipConfigurations: "{{ ipConfigurations }}"
customNetworkInterfaceName: "{{ customNetworkInterfaceName }}"
billingSku: "{{ billingSku }}"
extendedLocation:
name: "{{ name }}"
type: "{{ type }}"
etag: "{{ etag }}"
ipConfigurations:
- id: "{{ id }}"
properties:
privateIPAddress: "{{ privateIPAddress }}"
privateIPAllocationMethod: "{{ privateIPAllocationMethod }}"
subnet: "{{ subnet }}"
publicIPAddress: "{{ publicIPAddress }}"
provisioningState: "{{ provisioningState }}"
name: "{{ name }}"
etag: "{{ etag }}"
ipConfigurationProfiles:
- id: "{{ id }}"
properties:
subnet: "{{ subnet }}"
provisioningState: "{{ provisioningState }}"
name: "{{ name }}"
type: "{{ type }}"
etag: "{{ etag }}"
ipAllocations:
- id: "{{ id }}"
resourceNavigationLinks:
- id: "{{ id }}"
properties:
linkedResourceType: "{{ linkedResourceType }}"
link: "{{ link }}"
provisioningState: "{{ provisioningState }}"
name: "{{ name }}"
etag: "{{ etag }}"
type: "{{ type }}"
serviceAssociationLinks:
- id: "{{ id }}"
properties:
linkedResourceType: "{{ linkedResourceType }}"
link: "{{ link }}"
provisioningState: "{{ provisioningState }}"
allowDelete: {{ allowDelete }}
locations: "{{ locations }}"
name: "{{ name }}"
etag: "{{ etag }}"
type: "{{ type }}"
delegations:
- id: "{{ id }}"
properties:
serviceName: "{{ serviceName }}"
actions: "{{ actions }}"
provisioningState: "{{ provisioningState }}"
name: "{{ name }}"
etag: "{{ etag }}"
type: "{{ type }}"
purpose: "{{ purpose }}"
provisioningState: "{{ provisioningState }}"
privateEndpointNetworkPolicies: "{{ privateEndpointNetworkPolicies }}"
privateLinkServiceNetworkPolicies: "{{ privateLinkServiceNetworkPolicies }}"
applicationGatewayIPConfigurations:
- id: "{{ id }}"
properties:
subnet: "{{ subnet }}"
provisioningState: "{{ provisioningState }}"
name: "{{ name }}"
etag: "{{ etag }}"
type: "{{ type }}"
sharingScope: "{{ sharingScope }}"
defaultOutboundAccess: {{ defaultOutboundAccess }}
ipamPoolPrefixAllocations:
- pool:
id: "{{ id }}"
numberOfIpAddresses: "{{ numberOfIpAddresses }}"
allocatedAddressPrefixes: "{{ allocatedAddressPrefixes }}"
serviceGateway:
id: "{{ id }}"
etag: "{{ etag }}"
disableBgpRoutePropagation: {{ disableBgpRoutePropagation }}
disablePeeringRoute: "{{ disablePeeringRoute }}"
provisioningState: "{{ provisioningState }}"
resourceGuid: "{{ resourceGuid }}"
UPDATE examples
- update_tags
Updates a route table tags.
UPDATE azure.network.route_tables
SET
tags = '{{ tags }}'
WHERE
resource_group_name = '{{ resource_group_name }}' --required
AND route_table_name = '{{ route_table_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
RETURNING
id,
name,
etag,
location,
properties,
tags,
type;
REPLACE examples
- create_or_update
Create or updates a route table in a specified resource group.
REPLACE azure.network.route_tables
SET
id = '{{ id }}',
location = '{{ location }}',
tags = '{{ tags }}',
properties = '{{ properties }}'
WHERE
resource_group_name = '{{ resource_group_name }}' --required
AND route_table_name = '{{ route_table_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
RETURNING
id,
name,
etag,
location,
properties,
tags,
type;
DELETE examples
- delete
Deletes the specified route table.
DELETE FROM azure.network.route_tables
WHERE resource_group_name = '{{ resource_group_name }}' --required
AND route_table_name = '{{ route_table_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
;