1.8.6 Creating a consumer

This section describes the format of the request to be used for creating a consumer and the method for creating a request body.

Procedure

1. Acquire a consumer to use as a template. Issue a request in the following format:

   GET http://host:port/Analytics/version/objects/Groups

2. Edit the consumer (Groups resource) that you acquired in step 1 according to the table below.

   Table 1‒9: Changes to the Groups resource

   Member to change	Whether the change is required	Description
   name	Required	Change the name to the name of the consumer that you want to create. You must specify a name that is not already registered.
   description	Optional	Enter a description of the consumer.
   templateCreatorType	Required	Specify User.
   gradeKey	Required	Specify the ID to identify the grade. To acquire the ID to identify the grade, see 2.10.3 Obtaining Grade List.
   urls	Optional	The URL that can be specified for the consumer.
   vmAutoAssignment	Optional	Specify whether to automatically assign, to the consumer, virtual machines on a hypervisor when that hypervisor is assigned to the consumer. To assign virtual machines on a hypervisor, specify true. If nothing is specified, false is assumed.
   applicationAssignFollow	Optional	Specify whether to automatically assign, to the consumer, any applications on a virtual machine or virtual host when that virtual machine or virtual host is assigned to the consumer. To assign applications on a virtual machine or virtual host, specify true. If nothing is specified, false is assumed.

3. Issue a request in the following format. In the request body, specify the consumer you edited in step 2.

   POST http://host:port/Analytics/version/objects/Groups

To Page Top