Skip to content

Commit 2316877

Browse files
authored
chore(stepfunctions-tasks): validate cases of action and parameters in CallAwsService (#27635)
This PR adds the following validations in CallAwsService. - `action` must be camelCase. - parameter names in `parameters` must be PascalCase. See the doc: https://docs.aws.amazon.com/step-functions/latest/dg/supported-services-awssdk.html > The API action will always be camel case, and parameter names will be Pascal case. For example, you could use Step Functions API action startSyncExecution and specify its parameter as StateMachineArn. CloudFormation fails with a following error if there are not these validations. ``` Deployment failed: Error: The stack named aws-stepfunctions-tasks-call-aws-service-logs-integ failed to deploy: UPDATE_ROLLBACK_COMPLETE: Resource handler returned message: "Invalid State Machine Definition: 'SCHEMA_VALIDATION_FAILED: The resource provided arn:aws:states:::aws-sdk:cloudwatchlogs:CreateLogStream is not recognized. The value is not a valid resource ARN, or the resource is not available in this region. at /States/SendTaskSuccess/Resource' (Service: AWSStepFunctions; Status Code: 400; Error Code: InvalidDefinition; Request ID: xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx; Proxy: null)" (RequestToken: xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx, HandlerErrorCode: InvalidRequest) ``` I think it is a good thing to make these errors in the synth phase, since there were actually cases of confusion as follows. #27623 (comment) I also thought to not validate but translate to camel (or pascal) cases. However I thought it would allow input that violates the explanation defined in the API documentation, so I decided not to. On the other hands, the `action` is also used for IAM actions so the IAM actions will be to camel cases (like `logs:createLogStream`). But I allowed it because IAM actions are case insensitive. If a translation is a better way to do it rather than the validation, I will consider that as well. https://github.com/aws/aws-cdk/blob/09c809b52fd2eeb27ac5bbc91d425ecf54e31bf9/packages/aws-cdk-lib/aws-stepfunctions-tasks/lib/aws-sdk/call-aws-service.ts#L92-L94 ---- *By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*
1 parent 039071d commit 2316877

File tree

2 files changed

+33
-0
lines changed

2 files changed

+33
-0
lines changed

packages/aws-cdk-lib/aws-stepfunctions-tasks/lib/aws-sdk/call-aws-service.ts

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -79,6 +79,15 @@ export class CallAwsService extends sfn.TaskStateBase {
7979
if (this.props.integrationPattern === sfn.IntegrationPattern.RUN_JOB) {
8080
throw new Error('The RUN_JOB integration pattern is not supported for CallAwsService');
8181
}
82+
if (!Token.isUnresolved(this.props.action) && !this.props.action.startsWith(this.props.action[0]?.toLowerCase())) {
83+
throw new Error(`action must be camelCase, got: ${this.props.action}`);
84+
}
85+
if (this.props.parameters) {
86+
const invalidKeys = Object.keys(this.props.parameters).filter(key => !key.startsWith(key[0]?.toUpperCase()));
87+
if (invalidKeys.length) {
88+
throw new Error(`parameter names must be PascalCase, got: ${invalidKeys.join(', ')}`);
89+
}
90+
}
8291

8392
const iamServiceMap: Record<string, string> = {
8493
sfn: 'states',

packages/aws-cdk-lib/aws-stepfunctions-tasks/test/aws-sdk/call-aws-service.test.ts

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -161,6 +161,30 @@ test('throws with invalid integration pattern', () => {
161161
})).toThrow(/The RUN_JOB integration pattern is not supported for CallAwsService/);
162162
});
163163

164+
test('throws if action is not camelCase', () => {
165+
expect(() => new tasks.CallAwsService(stack, 'GetObject', {
166+
service: 's3',
167+
action: 'GetObject',
168+
parameters: {
169+
Bucket: 'my-bucket',
170+
Key: sfn.JsonPath.stringAt('$.key'),
171+
},
172+
iamResources: ['*'],
173+
})).toThrow(/action must be camelCase, got: GetObject/);
174+
});
175+
176+
test('throws if parameters has keys as not PascalCase', () => {
177+
expect(() => new tasks.CallAwsService(stack, 'GetObject', {
178+
service: 's3',
179+
action: 'getObject',
180+
parameters: {
181+
bucket: 'my-bucket',
182+
key: sfn.JsonPath.stringAt('$.key'),
183+
},
184+
iamResources: ['*'],
185+
})).toThrow(/parameter names must be PascalCase, got: bucket, key/);
186+
});
187+
164188
test('can pass additional IAM statements', () => {
165189
// WHEN
166190
const task = new tasks.CallAwsService(stack, 'DetectLabels', {

0 commit comments

Comments
 (0)