"aws {rds,docdb} describe-db-engine-versions" showing the wrong returns

guessi commented 2 months ago

Describe the bug

Result of aws rds describe-db-engine-versions should not contains result for Amazon DocumentDB.
Result of aws docdb describe-db-engine-versions should not contains result for Amazon RDS.
Command below should not work
- aws docdb describe-db-engine-versions --engine aurora-mysql ---> mixing results for DocDB and RDS altogether.
- aws rds describe-db-engine-versions --engine docdb ---> mixing results for RDS and DocDB altogether.

Expected Behavior

Command for Product A should not returns result for Product B.

Current Behavior

Commands below showing the same result

$ aws rds describe-db-engine-versions --output json | jq -r '[.DBEngineVersions[].Engine] | sort | unique'
[
  "aurora-mysql",
  "aurora-postgresql",
  "custom-sqlserver-ee",
  "custom-sqlserver-se",
  "custom-sqlserver-web",
  "db2-ae",
  "db2-se",
  "docdb",
  "mariadb",
  "mysql",
  "neptune",
  "postgres",
  "sqlserver-ee",
  "sqlserver-ex",
  "sqlserver-se",
  "sqlserver-web"
]

$ aws docdb describe-db-engine-versions --output json | jq -r '[.DBEngineVersions[].Engine] | sort | unique'
[
  "aurora-mysql",
  "aurora-postgresql",
  "custom-sqlserver-ee",
  "custom-sqlserver-se",
  "custom-sqlserver-web",
  "db2-ae",
  "db2-se",
  "docdb",
  "mariadb",
  "mysql",
  "neptune",
  "postgres",
  "sqlserver-ee",
  "sqlserver-ex",
  "sqlserver-se",
  "sqlserver-web"
]

Reproduction Steps

Just execute the commands provided.

Possible Solution

No response

Additional Information/Context

No response

CLI version used

latest (aws-cli/2.15.36 Python/3.11.9 Darwin/23.4.0 source/x86_64 prompt/off)

Environment details (OS name and version, etc.)

see above info

tim-finnigan commented 2 months ago

Thank you for reporting this issue. For more context, those AWS CLI commands for rds and docdb correspond to the upstream service APIs:

Because service APIs are used across the CLI/SDKs, I will transfer this issue to our cross-SDK repository for tracking and raise this issue with the service teams. Thanks! (ref: P126233940 / P126234294)

tim-finnigan commented 2 months ago

Thanks for your patience. We heard back form the service teams who noted that this is the expected behavior. From the RDS side, they noted that DocDB is an RDS engine, so from that perspective this works as intended. And for DocDB, to view the engine versions for a specified engine you can use the --engine parameter:

aws docdb describe-db-engine-versions \
    --engine docdb

If you believe the documentation could better clarify this behavior, please feel free to reach out via the Provide feedback links in the API documentation pages to connect with the appropriate team. Any updates to the API documentation will be reflected in the CLI/SDK documentation.

github-actions[bot] commented 2 months ago

This issue is now closed.

Comments on closed issues are hard for our team to see. If you need more assistance, please either tag a team member or open a new issue that references this one. If you wish to keep having a conversation with other community members under this issue feel free to do so.

aws / aws-sdk