As a cloud administrator, you can use the custom naming allocation helper to generate custom names for your resources in Automation Assembler. You can use the custom naming allocation helper with any resource type.

After you define custom naming templates in Automation Assembler, you can use the custom naming allocation helper to reference the custom naming templates in the Design canvas. See Custom resource naming for more information.

These use cases demonstrate how to use the custom naming allocation helper with the Generic resource type and the Machine resource type. The Generic resource type covers all possible resources and is linked exclusively to the custom naming allocation helper.

Note:

When you create a custom naming template with the Generic resource type, you must use the custom naming allocation helper to generate a custom name for your resource. If you do not add the allocation helper, a name will not be generated for the resource.

Before you begin

You must set up a cloud account and build your resource infrastructure before you can use allocation helpers. See Adding cloud accounts and Building your resource infrastructure for more information.

Create a Generic naming template

You must create a custom naming template to use the custom naming allocation helper. In this example, you create a Generic, organization-level naming template for your deployments. Organization-level naming templates are applied to all deployments by default.

You can also create project-level naming templates. See Custom resource naming for more information.

To create an organization-level naming template:

  1. Select Infrastructure > Administration > Custom Names and click New Custom Name.
  2. Enter a name and description for the custom naming template.
  3. Select Organization as the scope.
  4. Click New Naming Template and configure the following options.
    Option Value
    Resource type Generic
    Template name my-custom template

    The template name is a user-defined string and serves as an identifier for the given template.

    The template name must be specified if the resource type is Generic.

    If you choose Machine as the resource type, you do not need to reference the template name because you can only create one template of type Machine per project.
    Template format resource-${#####}
    Starting counter value 1
    Increment step 1

    With this configuration, the deployments in the assigned projects will increment from this starting point.

    In this example, where the starting counter is 1 and the increment is 1, the first deployment is numbered as 2. If you need the deployment to start at 1, then set the starting counter to zero and the increment step to 1.
  5. Click Add.
  6. If needed, add additional custom naming templates.
  7. Click Create.