feat(core): add support for AccountIdFromAlias #27642

packages/aws-cdk-lib/core/lib/cfn-fn.ts

@@ -177,6 +177,16 @@ export class Fn {
     return Token.asList(new FnCidr(ipBlock, count, sizeMask));
   }
 
+  /**
+   * The intrinsic function ``Fn::AccountIdfromAlias`` returns the AWS account ID that
+   * corresponds to the provided AWS account alias.
+   * @param alias The user-provided AWS account alias string.
+   * @returns a token represented as a string
+   */
+  public static accountIdFromAlias(alias: string): string {
+    return Token.asString(new FnAccountIdFromAlias(alias));
+  }
+
   /**
    * Given an url, parse the domain name
    * @param url the url to parse
@@ -675,6 +685,21 @@ class FnCidr extends FnBase {
   }
 }
 
+/**
+ * The intrinsic function ``Fn::AccountIdFromAlias`` resolves an AWS account
+ * alias to its account id. This function is typically used to reference another
+ * AWS account within your template.
+ */
+class FnAccountIdFromAlias extends FnBase {
+  /**
+   * Creates an ``FnAccountIdFromAlias`` function.
+   * @param alias The user-provided account alias string.
+   */
+  constructor(alias: string) {
+    super('Fn::AccountIdFromAlias', alias);
+  }
+}
+
 class FnConditionBase extends Intrinsic implements ICfnRuleConditionExpression {
   readonly disambiguator = true;
   constructor(type: string, value: any) {

packages/aws-cdk-lib/core/lib/helpers-internal/cfn-parse.ts

@@ -657,6 +657,10 @@ export class CfnParser {
         }
         return { Condition: condition.logicalId };
       }
+      case 'Fn::AccountIdFromAlias': {
+        const value = this.parseValue(object[key]);
+        return Fn.accountIdFromAlias(value);
+      }
       default:
         if (this.options.context === CfnParsingContext.RULES) {
           return this.handleRulesIntrinsic(key, object);

packages/aws-cdk-lib/core/test/fn.test.ts

@@ -303,6 +303,16 @@ test('Fn.len with resolved value', () => {
   expect(Fn.len(Fn.split('|', 'a|b|c'))).toBe(3);
 });
 
+test('Fn.AccountIdFromAlias', () => {
+  const stack = new Stack();
+  const token = Fn.accountIdFromAlias('test-aws-account-alias');
+
+  expect(stack.resolve(token)).toEqual({
+    'Fn::AccountIdFromAlias':
+      'test-aws-account-alias',
+  });
+});
+
 function stringListToken(o: any): string[] {
   return Token.asList(new Intrinsic(o));
 }