Documentation unclear in https://www.vaultproject.io/api/auth/aws/index.html#create-role

I am new to Vault but starting to figure it out.
I am looking at this https://www.vaultproject.io/api/auth/aws/index.html#create-role

It does not document all the properties (or perhaps you call them constraints) on /auth/aws/role/:role

For example, the property ‘polices’ is not enumerated (although it is in the sample POST). But then there is enumerated a property called ‘token_policies’ and it isnt clear if that different then ‘policies’.

Am I missing something? Can I do a PR to fix it and will anyone care enought to review it?

thx

Generally values that are not documented are deprecated. E.g. token_policies is the new name for policies, but we keep backwards compatibility.

Sometimes they are docs bugs though :slight_smile: Just depends on the specifics.

1 Like