transit_gateway_route_tables
Creates, updates, deletes or gets a transit_gateway_route_table resource or lists transit_gateway_route_tables in a region
Overview
| Name | transit_gateway_route_tables |
| Type | Resource |
| Description | Resource Type definition for AWS::EC2::TransitGatewayRouteTable |
| Id | awscc.ec2.transit_gateway_route_tables |
Fields
- get (all properties)
- list (identifiers only)
| Name | Datatype | Description |
|---|---|---|
transit_gateway_route_table_id | string | Transit Gateway Route Table primary identifier |
transit_gateway_id | string | The ID of the transit gateway. |
tags | array | Tags are composed of a Key/Value pair. You can use tags to categorize and track each parameter group. The tag value null is permitted. |
region | string | AWS region. |
| Name | Datatype | Description |
|---|---|---|
transit_gateway_route_table_id | string | Transit Gateway Route Table primary identifier |
region | string | AWS region. |
For more information, see AWS::EC2::TransitGatewayRouteTable.
Methods
| Name | Resource | Accessible by | Required Params |
|---|---|---|---|
create_resource | transit_gateway_route_tables | INSERT | TransitGatewayId, region |
delete_resource | transit_gateway_route_tables | DELETE | Identifier, region |
update_resource | transit_gateway_route_tables | UPDATE | Identifier, PatchDocument, region |
list_resources | transit_gateway_route_tables_list_only | SELECT | region |
get_resource | transit_gateway_route_tables | SELECT | Identifier, region |
SELECT examples
- get (all properties)
- list (identifiers only)
Gets all properties from an individual transit_gateway_route_table.
SELECT
region,
transit_gateway_route_table_id,
transit_gateway_id,
tags
FROM awscc.ec2.transit_gateway_route_tables
WHERE
region = '{{ region }}' AND
Identifier = '{{ transit_gateway_route_table_id }}';
Lists all transit_gateway_route_tables in a region.
SELECT
region,
transit_gateway_route_table_id
FROM awscc.ec2.transit_gateway_route_tables_list_only
WHERE
region = '{{ region }}';
INSERT example
Use the following StackQL query and manifest file to create a new transit_gateway_route_table resource, using stack-deploy.
- Required Properties
- All Properties
- Manifest
/*+ create */
INSERT INTO awscc.ec2.transit_gateway_route_tables (
TransitGatewayId,
region
)
SELECT
'{{ transit_gateway_id }}',
'{{ region }}'
RETURNING
ErrorCode,
EventTime,
Identifier,
Operation,
OperationStatus,
RequestToken,
ResourceModel,
RetryAfter,
StatusMessage,
TypeName
;
/*+ create */
INSERT INTO awscc.ec2.transit_gateway_route_tables (
TransitGatewayId,
Tags,
region
)
SELECT
'{{ transit_gateway_id }}',
'{{ tags }}',
'{{ region }}'
RETURNING
ErrorCode,
EventTime,
Identifier,
Operation,
OperationStatus,
RequestToken,
ResourceModel,
RetryAfter,
StatusMessage,
TypeName
;
version: 1
name: stack name
description: stack description
providers:
- aws
globals:
- name: region
value: '{{ vars.AWS_REGION }}'
resources:
- name: transit_gateway_route_table
props:
- name: transit_gateway_id
value: '{{ transit_gateway_id }}'
- name: tags
value:
- key: '{{ key }}'
value: '{{ value }}'
UPDATE example
Use the following StackQL query and manifest file to update a transit_gateway_route_table resource, using stack-deploy.
/*+ update */
UPDATE awscc.ec2.transit_gateway_route_tables
SET PatchDocument = string('{{ {
"Tags": tags
} | generate_patch_document }}')
WHERE
region = '{{ region }}' AND
Identifier = '{{ transit_gateway_route_table_id }}'
RETURNING
ErrorCode,
EventTime,
Identifier,
Operation,
OperationStatus,
RequestToken,
ResourceModel,
RetryAfter,
StatusMessage,
TypeName
;
DELETE example
/*+ delete */
DELETE FROM awscc.ec2.transit_gateway_route_tables
WHERE
Identifier = '{{ transit_gateway_route_table_id }}' AND
region = '{{ region }}'
RETURNING
ErrorCode,
EventTime,
Identifier,
Operation,
OperationStatus,
RequestToken,
ResourceModel,
RetryAfter,
StatusMessage,
TypeName
;
Additional Parameters
Mutable resources in the Cloud Control provider support additional optional parameters which can be supplied with INSERT, UPDATE, or DELETE operations. These include:
| Parameter | Description |
|---|---|
ClientToken | A unique identifier to ensure the idempotency of the resource request.This allows the provider to accurately distinguish between retries and new requests.A client token is valid for 36 hours once used. After that, a resource request with the same client token is treated as a new request. If you do not specify a client token, one is generated for inclusion in the request. |
RoleArn | The ARN of the IAM role used to perform this resource operation.The role specified must have the permissions required for this operation.If you do not specify a role, a temporary session is created using your AWS user credentials. |
TypeVersionId | For private resource types, the type version to use in this resource operation.If you do not specify a resource version, the default version is used. |
Permissions
To operate on the transit_gateway_route_tables resource, the following permissions are required:
- Read
- Create
- Update
- List
- Delete
ec2:DescribeTransitGatewayRouteTables
ec2:CreateTransitGatewayRouteTable,
ec2:CreateTags,
ec2:DescribeTransitGatewayRouteTables
ec2:DescribeTransitGatewayRouteTables,
ec2:CreateTags,
ec2:DeleteTags
ec2:DescribeTransitGatewayRouteTables
ec2:DeleteTransitGatewayRouteTable,
ec2:DescribeTransitGatewayRouteTables,
ec2:GetTransitGatewayRouteTableAssociations,
ec2:DisassociateTransitGatewayRouteTable