Skip to content

What IS the principal? The cert? And Arn? this should be more descriptive and there should be an example. #7089

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jknotamzn opened this issue May 17, 2025 · 2 comments
Assignees
Labels
documentation This is a problem with documentation. p3 This is a minor priority issue

Comments

@jknotamzn
Copy link

Describe the issue

principal | Required | String | undefined | The principal.

Links

https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/iot/command/ListPrincipalThingsCommand/

@jknotamzn jknotamzn added documentation This is a problem with documentation. needs-triage This issue or PR still needs to be triaged. labels May 17, 2025
@aBurmeseDev aBurmeseDev self-assigned this May 20, 2025
@aBurmeseDev
Copy link
Contributor

Hi @jknotamzn - thanks for checking in.

Principal is mentioned in the docs description, second sentence. Does that help?

A principal can be X.509 certificates, IAM users, groups, and roles, Amazon Cognito identities or federated identities.

Image

@aBurmeseDev aBurmeseDev added response-requested Waiting on additional info and feedback. Will move to \"closing-soon\" in 7 days. p3 This is a minor priority issue and removed needs-triage This issue or PR still needs to be triaged. labels May 20, 2025
@jknotamzn
Copy link
Author

So is it an Arn then?

"The principal." should be "The principal's ARN"
"The Things." should be "An array of thing names" or "An array of thing ARNs"

Just seems that the documentation for much of the IoT stuff is lacking in this way, its very vague.

@github-actions github-actions bot removed the response-requested Waiting on additional info and feedback. Will move to \"closing-soon\" in 7 days. label May 21, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation This is a problem with documentation. p3 This is a minor priority issue
Projects
None yet
Development

No branches or pull requests

2 participants