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
-
Acquire a consumer to use as a template. Issue a request in the following format:
GET http://host:port/Analytics/version/objects/Groups
-
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.
-
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