[New Data Source]: Port mappings for custom routing Global Accelerator

[bogatuadrian]

Description

After you create a custom routing Global Accelerator, it is a common practice to use the port mappings generated by the GA, for example as seen in this AWS blog post.

Right now, through Terraform, you can create a custom routing Global Accelerator, but there seems to be no way to get the port mappings information, leaving you with the alternative to run the following command with AWS CLI from Terraform (with something like terraform_data + local-exec; edit: or rather the external module) which is not ideal:

aws globalaccelerator list-custom-routing-port-mappings ...

It would be great to have access to this port mapping through a Terraform data source.

NOTE 1: The required API seems to be available in AWS Go SDK v2: globalaccelerator#Client.ListCustomRoutingPortMappings

NOTE 2: The best practice is to list the port mappings after the Global Accelerator is in a "Deployed" state, in case this poses problems to any potential code that waits for a specific GA state to be ready during an apply.

NOTE 3: There is also another potential data source similar to this one that is more specific: ListCustomRoutingPortMappingsByDestination; you could consider including this one as well.

Requested Resource(s) and/or Data Source(s)

• aws_globalaccelerator_custom_routing_port_mappings

Potential Terraform Configuration

data "aws_globalaccelerator_custom_routing_port_mappings" "this" {
  accelerator_arn = aws_globalaccelerator_custom_routing_accelerator.this.id
}

References

• Go SDK: https://pkg.go.dev/github.com/aws/aws-sdk-go-v2/service/globalaccelerator#Client.ListCustomRoutingPortMappings
• AWS CLI documentation: https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-port-mappings.html
• AWS API documentation: https://docs.aws.amazon.com/global-accelerator/latest/api/API_ListCustomRoutingPortMappings.html

Would you like to implement a fix?

Yes

[github-actions[bot]]

Community Note

Voting for Prioritization

• Please vote on this issue by adding a 👍 reaction to the original post to help the community and maintainers prioritize this request.
• Please see our prioritization guide for information on how we prioritize.
• Please do not leave "+1" or other comments that do not add relevant new information or questions, they generate extra noise for issue followers and do not help prioritize the request.

Volunteering to Work on This Issue

• If you are interested in working on this issue, please leave a comment.
• If this would be your first contribution, please review the contribution guide.