custom_routing_port_mappings_by_destinations
Creates, updates, deletes, gets or lists a custom_routing_port_mappings_by_destinations resource.
Overview
| Name | custom_routing_port_mappings_by_destinations |
| Type | Resource |
| Id | aws.globalaccelerator.custom_routing_port_mappings_by_destinations |
Fields
The following fields are returned by SELECT queries:
- list_custom_routing_port_mappings_by_destination
| Name | Datatype | Description |
|---|---|---|
accelerator_arn | string | The Amazon Resource Name (ARN) of the custom routing accelerator that you have port mappings for. |
accelerator_socket_addresses | array | The IP address/port combinations (sockets) that map to a given destination socket address. |
destination_socket_address | object | An IP address/port combination. |
destination_traffic_state | string | Indicates whether or not a port mapping destination can receive traffic. The value is either ALLOW, if traffic is allowed to the destination, or DENY, if traffic is not allowed to the destination. (ALLOW, DENY) |
endpoint_group_arn | string | The Amazon Resource Name (ARN) of the endpoint group. |
endpoint_group_region | string | The Amazon Web Services Region for the endpoint group. |
endpoint_id | string | The ID for the virtual private cloud (VPC) subnet. |
ip_address_type | string | The IP address type that an accelerator supports. For a custom routing accelerator, the value must be IPV4. (IPV4, DUAL_STACK) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list_custom_routing_port_mappings_by_destination | select | region | List the port mappings for a specific EC2 instance (destination) in a VPC subnet endpoint. The response is the mappings for one destination IP address. This is useful when your subnet endpoint has mappings that span multiple custom routing accelerators in your account, or for scenarios where you only want to list the port mappings for a specific destination instance. |
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 |
|---|---|---|
region | string | AWS region (default: us-east-1) |
SELECT examples
- list_custom_routing_port_mappings_by_destination
List the port mappings for a specific EC2 instance (destination) in a VPC subnet endpoint. The response is the mappings for one destination IP address. This is useful when your subnet endpoint has mappings that span multiple custom routing accelerators in your account, or for scenarios where you only want to list the port mappings for a specific destination instance.
SELECT
accelerator_arn,
accelerator_socket_addresses,
destination_socket_address,
destination_traffic_state,
endpoint_group_arn,
endpoint_group_region,
endpoint_id,
ip_address_type
FROM aws.globalaccelerator.custom_routing_port_mappings_by_destinations
WHERE region = '{{ region }}' -- required
;