N1 Service Provisioning System 4.1 Reference Guide

ID Substitution Using NM:

Most of the objects that you create have ID numbers associated with them. This ID number is a unique identifier for an entity, such as a user account or a component, in the repository.

ID numbers are useful because they are unique, but they can be cumbersome to enter as the argument to a command. To use names rather than ID numbers, you can use the tag NM: to introduce the name of an object on a command line..

Table 4–6 provides a complete listing of all supported NM: mappings.

To use the object name rather than the full ID number, use the following syntax to represent an object ID in any CLI command:


NM:<host|user|user group name|host type name|etc.>

with no spaces.

You can also use the NM: syntax to identify components and plans. You may optionally specify a version number in addition to the name itself:


plan = NM:<plan name>[:<version>]

For example:


NM:simplePlan
NM:simplePlan:1.0

If you do not specify a version number, the N1 Service Provisioning System software uses the latest version of the component or plan.