fix(scheduler): scheduleName returns undefined when imported from ARN (#36400)

mazyu36 · web-flow · commit 752bd9b7c31d · 2026-01-20T09:54:35.000Z
### Issue # (if applicable) Closes #36361. ### Reason for this change When importing a schedule using `Schedule.fromScheduleArn()`, the `scheduleName` property returns `undefined` instead of the actual schedule name. ### Description of changes Fixed the ARN parsing logic in `Schedule.fromScheduleArn()` to correctly extract the schedule name from the resource path. AWS Scheduler ARNs have the format `arn:aws:scheduler:region:account:schedule/GROUP/NAME`, and the previous implementation only captured the group name. ### Describe any new or updated permissions being added No new or updated permissions. ### Description of how you validated changes Added unit tests to verify correct parsing and error handling. ### Checklist - [x] My code adheres to the [CONTRIBUTING GUIDE](https://github.com/aws/aws-cdk/blob/main/CONTRIBUTING.md) and [DESIGN GUIDELINES](https://github.com/aws/aws-cdk/blob/main/docs/DESIGN_GUIDELINES.md) ---- *By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*
diff --git a/packages/aws-cdk-lib/aws-scheduler/lib/schedule.ts b/packages/aws-cdk-lib/aws-scheduler/lib/schedule.ts
@@ -255,9 +255,18 @@ export class Schedule extends Resource implements ISchedule {
    * Import an existing schedule using the ARN.
    */
   public static fromScheduleArn(scope: Construct, id: string, scheduleArn: string): ISchedule {
+    // Format: arn:aws:scheduler:region:account:schedule/SCHEDULE-GROUP/SCHEDULE-NAME
+    const parsedName = Arn.split(scheduleArn, ArnFormat.SLASH_RESOURCE_NAME).resourceName?.split('/')[1];
+
+    if (!parsedName) {
+      throw new UnscopedValidationError(`Invalid schedule ARN format. Expected: arn:<partition>:scheduler:<region>:<account>:schedule/<group-name>/<schedule-name>, got: ${scheduleArn}`);
+    }
+
+    const scheduleName = parsedName;
+
     class Import extends Resource implements ISchedule {
       public readonly scheduleArn = scheduleArn;
-      public readonly scheduleName = Arn.split(scheduleArn, ArnFormat.SLASH_RESOURCE_NAME).resourceName!.split('/')[1];
+      public readonly scheduleName = scheduleName;
       public get scheduleRef(): ScheduleReference {
         return {
           scheduleArn: this.scheduleArn,
diff --git a/packages/aws-cdk-lib/aws-scheduler/test/schedule.test.ts b/packages/aws-cdk-lib/aws-scheduler/test/schedule.test.ts
@@ -260,4 +260,30 @@ describe('Schedule', () => {
       });
     });
   });
+
+  describe('fromScheduleArn', () => {
+    test('correctly parses schedule name from ARN', () => {
+      // WHEN
+      const importedSchedule = Schedule.fromScheduleArn(
+        stack,
+        'ImportedSchedule',
+        'arn:aws:scheduler:us-east-1:123456789012:schedule/my-schedule-group/my-schedule-name',
+      );
+
+      // THEN
+      expect(importedSchedule.scheduleName).toEqual('my-schedule-name');
+      expect(importedSchedule.scheduleArn).toEqual('arn:aws:scheduler:us-east-1:123456789012:schedule/my-schedule-group/my-schedule-name');
+    });
+
+    test('throws error for invalid ARN format', () => {
+      // WHEN/THEN
+      expect(() => {
+        Schedule.fromScheduleArn(
+          stack,
+          'ImportedSchedule',
+          'arn:aws:scheduler:us-east-1:123456789012:schedule/invalid',
+        );
+      }).toThrow('Invalid schedule ARN format. Expected: arn:<partition>:scheduler:<region>:<account>:schedule/<group-name>/<schedule-name>, got: arn:aws:scheduler:us-east-1:123456789012:schedule/invalid');
+    });
+  });
 });
