Aliases

An alias in webMethods API Gateway holds stage-specific property values that multiple policy configurations can share. Aliases that the policy configurations reference are substituted during runtime. Changing an alias value affects all referencing policies. Aliases that are referenced through a name therefore alias names must be unique within an webMethods API Gateway. The corresponding alias value is substituted in place of an alias name during runtime. Thus, the same alias can be referred to in multiple policies and the change in a particular alias might affect all the policy properties.

Aliases have optional stage information, in addition to a name and value, which allows to define stage-specific aliases in a multi-stage environment. For details about stage-specific aliases, see Promoting assets. An alias definition without stage information applies to the webMethods API Gateway instance where the alias is defined.

Not all policies support the full set of aliases that are available in webMethods API Gateway. Some aliases are applicable only with certain policies and for certain policy parameters. For details, see Supported alias and policy combinations .

You can create six types of alias:

• Simple alias
• Endpoint alias
• HTTP transport security alias
• SOAP message security alias
• webMethods IS Service alias
• XSLT Transformation alias