CloudWatch Logs describe-deliveries returns only 4 fields, not the 9 in documentation

[RhysRedbearIT]

Describe the issue

Logs describe-deliveries returns only 4 fields, not the 9 in documentation

aws logs describe-deliveries --region us-east-1 --output json
{
"deliveries": [
{
"id": "xxx",
"arn": "arn:aws:logs:us-east-1:xxx8:delivery:xxx",
"deliverySourceName": "CreatedByCloudFront-xxx",
"deliveryDestinationArn": "arn:aws:logs:us-east-1:xxx:delivery-destination:xxx"
},
{
"id": "xxx",
"arn": "arn:aws:logs:us-east-1:xxx:delivery:xxx",
"deliverySourceName": "xxx-cloudfront-xxx",
"deliveryDestinationArn": "arn:aws:logs:us-east-1:xxx:delivery-destination:xxx"
}
]
}

Same issue occurs in Boto3 SDK and AWS API. There is an upstream source for this information that is incorrect for the API call.

Links

https://docs.aws.amazon.com/cli/latest/reference/logs/describe-deliveries.html
boto/boto3#4680
https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeDeliveries.html#API_DescribeDeliveries_ResponseSyntax

[RyanFitzSimmonsAK]

Hi @RhysRedbearIT, thanks for reaching out. The AWS CLI is in the exact same position as Boto3 in terms of being able to change this documentation. The model file refers to a structure with attributes that the operation doesn't actually return, but the CLI has no way to know which ones are or are not returned in real responses. The service team is aware of this, but fixing it would requiring a considerable refactor of the service. Please let me know if you have any follow-up questions.

[RhysRedbearIT]

I'm disappointed to see the documentation bug ticket boto/boto3#4680 closed off with basically 'The documentation is wrong and it won't be fixed'
It sounds like this one is going to get swept under the same rug, and I think by the lack of response from the API feedback they are also not going to fix theirs.
Follow-up question: How many of the leadership principals are broken by ignoring customer requests and leaving things broken because its too hard to fix?