Getting information about a specific snapshot group

Execution permission

Storage Administrator (View Only)

Request line

GET base-URL/simple/v1/objects/snapshot-groups/object-ID

Request message

Object ID

Specify a value for the name that was obtained by getting the list of snapshot group names.

Attribute	Type	Description
name	string	(Required) Snapshot group name

Note:

Do not specify the following snapshot group names:

• Names that include a slash (/) or backslash (\)
• Names consisting of only a period (.)

You can get information about these snapshot groups by running the API request for getting snapshot information with the query parameter snapshotGroupName specified.

Query parameters

With each request, you can obtain information for a maximum of 1000 snapshot groups. To obtain information for more than 1000 snapshot groups, execute the API request several times by using a combination of the count and startId parameters. By specifying the count parameter, you can also filter the snapshot group information to obtain.

Parameter	Type	Filter Condition
startSnapshotId	string	(Optional) Specify the ID of the snapshot from which to obtain information. If this parameter is omitted, "0,0" is assumed.
count	int	(Optional) Specify the number of snapshot groups for which you want to obtain information by using a value in the range from 1 through 1000. If this parameter is omitted, 1000 is assumed.

Body

None.

Response message

Body

The following is an example of the output when getting information about the snapshot group with the name snapshotGroup:

{
  "name": "snapshotGroup",
  "snapshots": [
    {
      "masterVolumeId": 100,
      "snapshotId": 3
    },
    {
      "masterVolumeId": 100,
      "snapshotId": 4
    }
  ],
  "count": 2,
  "totalCount": 2,
  "hasNext": false
}

Attribute	Type	Description
name	string	Snapshot group name
snapshots	object[]	The following information about the snapshot is obtained: masterVolumeId (int) Master volume ID of the snapshot snapshotId (int) Snapshot ID The mirror unit number is obtained.

Status codes

See HTTP status codes.

Coding example

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3f9f04ea8bd8f09847fac48d3" -X GET https://192.0.2.100/ConfigurationManager/simple/v1/objects/snapshot-groups/snapshotGroup