Creating a resource group

REST API Reference Guide for Virtual Storage Platform 5000, Virtual Storage Platform E Series, and Virtual Storage Platform G/F Series

Version

93-07-0x

90-09-0x

88-08-10

Audience

anonymous

Part Number

MK-98RD9014-17

The following request creates resource groups. To add a resource group to a virtual storage machine, you must also specify the virtualStorageDeviceId attribute.

Note:

If you locked any resources of the target storage system by using the REST API, you will not be able to use this API function. In such cases, unlock the resources before running the API function.

Execution permission

Security Administrator (View & Modify)

Request line

POST base-URL/v1/objects/resource-groups

Request message

Object ID: None.

Query parameters: None.

Body

{
  "resourceGroupName":"devResourceGroup",
  "virtualStorageDeviceId":"900000050001"
}

Attribute	Type	Description
resourceGroupName	string	(Required) Resource group name Specify a name consisting of 1 to 32 characters.
virtualStorageDeviceId	string	(Optional) Storage device ID of the virtual storage machine This attribute cannot be specified at the same time as the `virtualStorageId` attribute. If this attribute is omitted, the default storage device ID (the same storage device ID as that of the target physical storage system) will be set.
virtualStorageId	int	(Optional) ID of the virtual storage machine that corresponds to the resource group This attribute cannot be specified at the same time as the `virtualStorageDeviceId` attribute. If this attribute is omitted, `0` will be set.

Attribute

Type

Description

resourceGroupName

string

(Required) Resource group name

Specify a name consisting of 1 to 32 characters.

virtualStorageDeviceId

string

(Optional) Storage device ID of the virtual storage machine

This attribute cannot be specified at the same time as the virtualStorageId attribute.

If this attribute is omitted, the default storage device ID (the same storage device ID as that of the target physical storage system) will be set.

virtualStorageId

int

(Optional) ID of the virtual storage machine that corresponds to the resource group

This attribute cannot be specified at the same time as the virtualStorageDeviceId attribute.

If this attribute is omitted, 0 will be set.

Response message

Body

A job object is returned. For details on attributes other than affectedResources, see the description on job objects.

Attribute	Description
affectedResources	URL of the created resource group

Status codes

For details on the status codes of the request for this operation, see the description on HTTP status codes.

Coding example

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X POST --data-binary @./InputParameters.json https://192.0.2.100/ConfigurationManager/v1/objects/resource-groups