Update documentation for aws_ram_principal_association

[nikolaifa]

Community Note

• Please vote on this issue by adding a 👍 reaction to the original issue to help the community and maintainers prioritize this request
• 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
• If you are interested in working on this issue or have submitted a pull request, please leave a comment

Terraform CLI and Terraform AWS Provider Version

Affected Resource(s)

• aws_ram_principal_association

Terraform Configuration Files

Importing the resource per documentation (using an id for the principal)
terraform import aws_ram_principal_association.example arn:aws:ram:eu-west-1:123456789012:resource-share/73da1ab9-b94a-4ba3-8eb4-45917f7f4b12,123456789012

Results in Cannot import non-existent remote object. Cross account references might be the issue?
E.g.
referring to an organization, as the principal, which was in my case, per the AWS ARN, in another account.

The import worked when I imported with the principal ARN instead of the ID. I suggest updating the document advising the use of ARN instead of ID. Also testing whether this is a common issue for the resource.

[kautkata]

CLI command for principals ARN identification

aws --profile <profile name>--region <region> ram list-principals --resource-owner SELF