d/docdb_engine_version: New data source

[YakDriver]

Community Note

• Please vote on this pull request by adding a 👍 reaction to the original pull request comment 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 pull request followers and do not help prioritize the request

Closes #15255
Relates #15228, #15259

Release note for CHANGELOG:

d/docdb_engine_version: New data source

The output from acceptance testing (GovCloud):

--- PASS: TestAccAWSDocDBEngineVersionDataSource_basic (15.96s)
--- PASS: TestAccAWSDocDBEngineVersionDataSource_preferred (17.53s)
--- PASS: TestAccAWSDocDBEngineVersionDataSource_defaultOnly (17.53s)

The output from acceptance testing (commercial):

--- PASS: TestAccAWSDocDBEngineVersionDataSource_basic (11.66s)
--- PASS: TestAccAWSDocDBEngineVersionDataSource_preferred (12.77s)
--- PASS: TestAccAWSDocDBEngineVersionDataSource_defaultOnly (12.77s)

[YakDriver]

Should we note an AWS bug in the docs? This seems to uncover a bug in the AWS API. If DBParameterGroupFamily is set to a valid value, AWS does not return any versions. This holds true for AWS SDK Go and the AWS CLI:

% aws docdb describe-db-engine-versions --engine docdb \
 --query "DBEngineVersions[] [Engine, EngineVersion, DBParameterGroupFamily]" \
 --output text | sort -u
docdb	3.6.0	docdb3.6
% aws docdb describe-db-engine-versions --db-parameter-group-family docdb3.6
{
    "DBEngineVersions": []
}
% aws docdb describe-db-engine-versions --db-parameter-group-family docdb3.6 --engine docdb
{
    "DBEngineVersions": []
}
% aws docdb describe-db-engine-versions --db-parameter-group-family docdb3.6 --engine docdb --engine-version 3.6.0
{
    "DBEngineVersions": []
}
% aws docdb describe-db-engine-versions --engine docdb --engine-version 3.6.0 
{
    "DBEngineVersions": [
        {
            "Engine": "docdb",
            "EngineVersion": "3.6.0",
            "DBParameterGroupFamily": "docdb3.6",
            "DBEngineDescription": "Amazon DocumentDB (with MongoDB compatibility)",
            "DBEngineVersionDescription": "Amazon DocumentDB (with MongoDB compatibility)",
            "ValidUpgradeTarget": [],
            "ExportableLogTypes": [
                "audit",
                "profiler"
            ],
            "SupportsLogExportsToCloudwatchLogs": true
        }
    ]
}

[bflad]

Looks good! Similar comments as #15228 🚀

Output from acceptance testing:

--- PASS: TestAccAWSDocDBEngineVersionDataSource_defaultOnly (14.08s)
--- PASS: TestAccAWSDocDBEngineVersionDataSource_basic (14.11s)
--- PASS: TestAccAWSDocDBEngineVersionDataSource_preferred (14.28s)

[ghost]

This has been released in version 3.8.0 of the Terraform AWS provider. Please see the Terraform documentation on provider versioning or reach out if you need any assistance upgrading.

For further feature requests or bug reports with this functionality, please create a new GitHub issue following the template for triage. Thanks!

[ghost]

I'm going to lock this issue because it has been closed for 30 days ⏳. This helps our maintainers find and focus on the active issues.

If you feel this issue should be reopened, we encourage creating a new issue linking back to this one for added context. Thanks!