Open RobbertDM opened 2 months ago
Thanks @RobbertDM for reporting this issue. The documentation for the AWS CLI (and SDKs) is largely auto-generated by the service teams. For example the create-replication-task command documentation includes the text "See also: AWS API Documentation", which links to the API docs, where you can also find references to the documented examples in SDKs.
We generally recommend using the Provide feedback links at the bottom of those API documentation pages to send feedback to the appropriate team. But in this case I can go ahead and transfer the issue to our cross-SDK repository and reach out to the documentation team internally to fix the documentation. Once the API documentation is fixed then it will get updated in the CLI/SDK documentation. Thanks again for bringing this to our attention! (ref: P127042364)
Describe the issue
For some DMS resources, you can pass
--resource-identifier (string)
, so that the ARN gets a friendly name instead of a randomly generated string. The description for each of these is:Which seems to be written for
create-endpoint
, but that's not even correct since the ARN mentioned isarn:aws:dms:eu-west-1:012345678901:rep:Example-App-ARN1
, which is aReplicationInstance
's ARN. Endpoints haveendpoint
in the ARN, replication instances haverep
and tasks havetask
.BTW, I have spent some time trying to find where I could contribute to the docs myself, but I cannot find where the docs are generated from. I guess the docs at the URLs referenced below are not open to contributions?
Links
https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/create-replication-task.html https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/create-replication-instance.html https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/create-endpoint.html