EC2 / Client / create_local_gateway_route_table

create_local_gateway_route_table#

EC2.Client.create_local_gateway_route_table(**kwargs)#

Creates a local gateway route table.

Request Syntax

response = client.create_local_gateway_route_table(
    LocalGatewayId='string',
    Mode='direct-vpc-routing'|'coip',
    TagSpecifications=[
        {
            'ResourceType': 'capacity-reservation'|'client-vpn-endpoint'|'customer-gateway'|'carrier-gateway'|'coip-pool'|'dedicated-host'|'dhcp-options'|'egress-only-internet-gateway'|'elastic-ip'|'elastic-gpu'|'export-image-task'|'export-instance-task'|'fleet'|'fpga-image'|'host-reservation'|'image'|'import-image-task'|'import-snapshot-task'|'instance'|'instance-event-window'|'internet-gateway'|'ipam'|'ipam-pool'|'ipam-scope'|'ipv4pool-ec2'|'ipv6pool-ec2'|'key-pair'|'launch-template'|'local-gateway'|'local-gateway-route-table'|'local-gateway-virtual-interface'|'local-gateway-virtual-interface-group'|'local-gateway-route-table-vpc-association'|'local-gateway-route-table-virtual-interface-group-association'|'natgateway'|'network-acl'|'network-interface'|'network-insights-analysis'|'network-insights-path'|'network-insights-access-scope'|'network-insights-access-scope-analysis'|'placement-group'|'prefix-list'|'replace-root-volume-task'|'reserved-instances'|'route-table'|'security-group'|'security-group-rule'|'snapshot'|'spot-fleet-request'|'spot-instances-request'|'subnet'|'subnet-cidr-reservation'|'traffic-mirror-filter'|'traffic-mirror-session'|'traffic-mirror-target'|'transit-gateway'|'transit-gateway-attachment'|'transit-gateway-connect-peer'|'transit-gateway-multicast-domain'|'transit-gateway-policy-table'|'transit-gateway-route-table'|'transit-gateway-route-table-announcement'|'volume'|'vpc'|'vpc-endpoint'|'vpc-endpoint-connection'|'vpc-endpoint-service'|'vpc-endpoint-service-permission'|'vpc-peering-connection'|'vpn-connection'|'vpn-gateway'|'vpc-flow-log'|'capacity-reservation-fleet'|'traffic-mirror-filter-rule'|'vpc-endpoint-connection-device-type'|'verified-access-instance'|'verified-access-group'|'verified-access-endpoint'|'verified-access-policy'|'verified-access-trust-provider'|'vpn-connection-device-type'|'vpc-block-public-access-exclusion'|'ipam-resource-discovery'|'ipam-resource-discovery-association',
            'Tags': [
                {
                    'Key': 'string',
                    'Value': 'string'
                },
            ]
        },
    ],
    DryRun=True|False
)

Parameters:

LocalGatewayId (string) –
[REQUIRED]

The ID of the local gateway.
Mode (string) – The mode of the local gateway route table.
TagSpecifications (list) –
The tags assigned to the local gateway route table.
- (dict) –
  
  The tags to apply to a resource when the resource is being created. When you specify a tag, you must specify the resource type to tag, otherwise the request will fail.
  
  Note
  The Valid Values lists all the resource types that can be tagged. However, the action you’re using might not support tagging all of these resource types. If you try to tag a resource type that is unsupported for the action you’re using, you’ll get an error.
  - ResourceType (string) –
    
    The type of resource to tag on creation.
  - Tags (list) –
    
    The tags to apply to the resource.
    - (dict) –
      
      Describes a tag.
      - Key (string) –
        
        The key of the tag.
        
        Constraints: Tag keys are case-sensitive and accept a maximum of 127 Unicode characters. May not begin with aws:.
      - Value (string) –
        
        The value of the tag.
        
        Constraints: Tag values are case-sensitive and accept a maximum of 256 Unicode characters.
DryRun (boolean) – Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

Return type:

dict

Returns:

Response Syntax

{
    'LocalGatewayRouteTable': {
        'LocalGatewayRouteTableId': 'string',
        'LocalGatewayRouteTableArn': 'string',
        'LocalGatewayId': 'string',
        'OutpostArn': 'string',
        'OwnerId': 'string',
        'State': 'string',
        'Tags': [
            {
                'Key': 'string',
                'Value': 'string'
            },
        ],
        'Mode': 'direct-vpc-routing'|'coip',
        'StateReason': {
            'Code': 'string',
            'Message': 'string'
        }
    }
}

Response Structure

(dict) –
- LocalGatewayRouteTable (dict) –
  
  Information about the local gateway route table.
  - LocalGatewayRouteTableId (string) –
    
    The ID of the local gateway route table.
  - LocalGatewayRouteTableArn (string) –
    
    The Amazon Resource Name (ARN) of the local gateway route table.
  - LocalGatewayId (string) –
    
    The ID of the local gateway.
  - OutpostArn (string) –
    
    The Amazon Resource Name (ARN) of the Outpost.
  - OwnerId (string) –
    
    The ID of the Amazon Web Services account that owns the local gateway route table.
  - State (string) –
    
    The state of the local gateway route table.
  - Tags (list) –
    
    The tags assigned to the local gateway route table.
    - (dict) –
      
      Describes a tag.
      - Key (string) –
        
        The key of the tag.
        
        Constraints: Tag keys are case-sensitive and accept a maximum of 127 Unicode characters. May not begin with aws:.
      - Value (string) –
        
        The value of the tag.
        
        Constraints: Tag values are case-sensitive and accept a maximum of 256 Unicode characters.
  - Mode (string) –
    
    The mode of the local gateway route table.
  - StateReason (dict) –
    
    Information about the state change.
    - Code (string) –
      
      The reason code for the state change.
    - Message (string) –
      
      The message for the state change.
      - Server.InsufficientInstanceCapacity: There was insufficient capacity available to satisfy the launch request.
      - Server.InternalError: An internal error caused the instance to terminate during launch.
      - Server.ScheduledStop: The instance was stopped due to a scheduled retirement.
      - Server.SpotInstanceShutdown: The instance was stopped because the number of Spot requests with a maximum price equal to or higher than the Spot price exceeded available capacity or because of an increase in the Spot price.
      - Server.SpotInstanceTermination: The instance was terminated because the number of Spot requests with a maximum price equal to or higher than the Spot price exceeded available capacity or because of an increase in the Spot price.
      - Client.InstanceInitiatedShutdown: The instance was shut down using the shutdown -h command from the instance.
      - Client.InstanceTerminated: The instance was terminated or rebooted during AMI creation.
      - Client.InternalError: A client error caused the instance to terminate during launch.
      - Client.InvalidSnapshot.NotFound: The specified snapshot was not found.
      - Client.UserInitiatedHibernate: Hibernation was initiated on the instance.
      - Client.UserInitiatedShutdown: The instance was shut down using the Amazon EC2 API.
      - Client.VolumeLimitExceeded: The limit on the number of EBS volumes or total storage was exceeded. Decrease usage or request an increase in your account limits.