feat(cfn-custom-resource): Add optional 'reason' field for detailed failure reporting

[phipag]

Duplicate of #1801 for v2 branch.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[github-actions]

💾 Artifacts Size Report

Module	Version	Size (KB)
powertools-common	2.0.0-SNAPSHOT	13.75
powertools-serialization	2.0.0-SNAPSHOT	22.88
powertools-logging	2.0.0-SNAPSHOT	38.88
powertools-logging-log4j	2.0.0-SNAPSHOT	28.06
powertools-logging-logback	2.0.0-SNAPSHOT	21.86
powertools-tracing	2.0.0-SNAPSHOT	19.10
powertools-metrics	2.0.0-SNAPSHOT	18.48
powertools-parameters	2.0.0-SNAPSHOT	17.41
powertools-validation	2.0.0-SNAPSHOT	19.79
powertools-cloudformation	2.0.0-SNAPSHOT	16.76
powertools-idempotency-core	2.0.0-SNAPSHOT	34.57
powertools-idempotency-dynamodb	2.0.0-SNAPSHOT	12.40
powertools-large-messages	2.0.0-SNAPSHOT	17.41
powertools-batch	2.0.0-SNAPSHOT	21.42
powertools-parameters-ssm	2.0.0-SNAPSHOT	10.65
powertools-parameters-secrets	2.0.0-SNAPSHOT	9.85
powertools-parameters-dynamodb	2.0.0-SNAPSHOT	11.90
powertools-parameters-appconfig	2.0.0-SNAPSHOT	11.40