[New/Enhanced Resource]: Amazon Connect Available Phone Numbers

[schuylr]

Description

Terraform operators will want the ability to pick specific phone numbers from a list for "vanity" purposes i.e. 555-ANY-CORP or convenient patterns i.e. 555-123-4567 - if they're able to find it from a list. This proposed resource data source would provide operators with a point-in-time snapshot of available phone numbers that could then be referenced into a soon-to-be-implemented aws_connect_phone_number resource from #26364

This resource will also be a dependency on another iteration of aws_connect_phone_number that will allow for operators to provide a choice from the given pool of available numbers directly into a ClaimPhoneNumber API request.

This issue also tracks the enhancement of the aws_connect_phone_number resource to allow for direct input of phone_number from the aws_connect_available_phone_numbers resource.

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

aws_connect_available_phone_numbers
aws_connect_phone_number (enhancement)

Potential Terraform Configuration

resource "aws_connect_instance" "test" {
  identity_management_type = "CONNECT_MANAGED"
  inbound_calls_enabled    = true
  instance_alias           = "friendly-name-connect"
  outbound_calls_enabled   = true
}

resource "aws_connect_available_phone_numbers" "test" {
  phone_number_country_code = "US"
  phone_number_prefix       = "+1555"
  phone_number_type         = "DID"
  target_arn                = aws_connect_instance.test.arn
}

resource "aws_connect_phone_number" "test" {
  phone_number = aws_connect_available_phone_numbers.test[0].phone_number
  target_arn   = aws_connect_instance.test.arn
}

References

https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html
https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html

Would you like to implement a fix?

Yes

[github-actions]

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.

[github-actions]

Marking this issue as stale due to inactivity. This helps our maintainers find and focus on the active issues. If this issue receives no comments in the next 30 days it will automatically be closed. Maintainers can also remove the stale label.

If this issue was automatically closed and you feel this issue should be reopened, we encourage creating a new issue linking back to this one for added context. Thank you!

[github-actions]

I'm going to lock this issue because it has been closed for 30 days ⏳. This helps our maintainers find and focus on the active issues.
If you have found a problem that seems similar to this, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.