Update
PUT v1/snapshot_collections/id
Description
Update a snapshot collection.
Normal Response Codes
200
HTTP Error Codes
400 401 403 404 409 500 503
Detail Codes
Request
| Parameter | Type | JSON Type | Description | Mandatory | Deprecated |
|---|---|---|---|---|---|
| id | NsObjectID | string | Identifier for snapshot collection. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'. | true | |
| name | NsVolSnapName | string | Name of snapshot collection. String of up to 215 alphanumeric, hyphenated, colon, or period-separated characters; but cannot begin with hyphen, colon or period. This type is used for object sets containing volumes, snapshots, snapshot collections and protocol endpoints. | false | |
| description | NsDescription | string | Text description of snapshot collection. String of up to 255 printable ASCII characters. Example: '99.9999% availability'. | false | |
| replicate | NsBoolean | boolean | True if this snapshot collection has been marked for replication. Possible values: 'true', 'false'. | false | |
| metadata | NsKeyValues | Array of NsKeyValue | Key-value pairs that augment a snapshot collection's attributes. List of key-value pairs. Keys must be unique and non-empty. When creating an object, values must be non-empty. When updating an object, an empty value causes the corresponding key to be removed. | false |
JSON Request
{
"data" : {
"name" : "snapcoll0.4960602191544121",
"description" : "V4IASnM9A8OdGduTVd0j2Nrj9ploIGTPaSpuUCZQhHWWHJPqnYC5vQvr2ghcryOc"
}
}
Response
| Parameter | Type | JSON Type | Description | Deprecated |
|---|---|---|---|---|
| id | NsObjectID | string | Identifier for snapshot collection. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'. | |
| name | NsVolSnapName | string | Name of snapshot collection. String of up to 215 alphanumeric, hyphenated, colon, or period-separated characters; but cannot begin with hyphen, colon or period. This type is used for object sets containing volumes, snapshots, snapshot collections and protocol endpoints. | |
| description | NsDescription | string | Text description of snapshot collection. String of up to 255 printable ASCII characters. Example: '99.9999% availability'. | |
| volcoll_name | NsObjectName | string | Volume collection name. String of up to 64 alphanumeric characters, - and . and : are allowed after first character. Example: 'myobject-5'. | |
| volcoll_id | NsObjectID | string | Parent volume collection ID. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'. | |
| origin_name | NsObjectName | string | Origination group name/ID. String of up to 64 alphanumeric characters, - and . and : are allowed after first character. Example: 'myobject-5'. | |
| is_replica | NsBoolean | boolean | Mark or unmark specified snapshot collection for replication. When marking for replication, the snapshot collection must have been created by an existing replicating protection schedule and no newer snapshot collection for this volume collection should have already started to replicate. Often used to replicate a snapshot collection from previously downstream partner to another partner. Possible values: 'true', 'false'. | |
| is_complete | NsBoolean | boolean | Is complete. Possible values: 'true', 'false'. | |
| is_manual | NsBoolean | boolean | Is manual. Possible values: 'true', 'false'. | |
| is_external_trigger | NsBoolean | boolean | Is externally triggered. Possible values: 'true', 'false'. | |
| is_unmanaged | NsBoolean | boolean | Is snapshot collection unmanaged, so that it will not be automatically deleted. Possible values: 'true', 'false'. | |
| repl_status | NsSnapReplStatus | string enum | Replication status. Possible values: 'complete', 'in_progress', 'pending'. | |
| repl_start_time | NsTime | number | Replication start time. Seconds since last epoch i.e. 00:00 January 1, 1970. Example: '3400'. | |
| repl_complete_time | NsTime | number | Replication complete time. Seconds since last epoch i.e. 00:00 January 1, 1970. Example: '3400'. | |
| repl_bytes_transferred | NsUnsignedLong | number | Number of bytes transferred after replication completes. Unsigned 64-bit integer. Example: 1234. | |
| creation_time | NsTime | number | Time when this snapshot collection was created. Seconds since last epoch i.e. 00:00 January 1, 1970. Example: '3400'. | |
| last_modified | NsTime | number | Time when this snapshot collection was last modified. Seconds since last epoch i.e. 00:00 January 1, 1970. Example: '3400'. | |
| online_status | NsOnlineStatus | string enum | Online status of snapcoll. This is based on the online status of the individual snapshots. Online status based on that of the constituent entities. Possible values: 'online', 'offline' or 'partial'. | |
| snapshots_list | NsSnapshotListFromSnapshotCollections | Array of NsSnapshotFromSnapshotCollections | List of snapshots in the snapshot collection. Snapshot list as presented in snapshot collections object set. | |
| replicate | NsBoolean | boolean | True if this snapshot collection has been marked for replication. Possible values: 'true', 'false'. | |
| allow_writes | NsBoolean | boolean | Allow applications to write to created snapshot(s). Mandatory and must be set to 'true' for VSS application synchronized snapshots. Possible values: 'true', 'false'. | |
| sched_id | NsObjectID | string | ID of protection schedule of snapshot collection. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'. | |
| sched_name | NsObjectName | string | Name of protection schedule of snapshot collection. String of up to 64 alphanumeric characters, - and . and : are allowed after first character. Example: 'myobject-5'. | |
| metadata | NsKeyValues | Array of NsKeyValue | Key-value pairs that augment a snapshot collection's attributes. List of key-value pairs. Keys must be unique and non-empty. When creating an object, values must be non-empty. When updating an object, an empty value causes the corresponding key to be removed. |
JSON Response
{
"data" : {
"repl_bytes_transferred" : 0,
"repl_status" : null,
"is_complete" : true,
"repl_start_time" : 0,
"replicate" : false,
"volcoll_id" : "0700000000000004d300000000000000000000000b",
"metadata" : null,
"creation_time" : 1474185091,
"id" : "0500000000000004d3000000000000000000000006",
"repl_complete_time" : 0,
"is_replica" : false,
"volcoll_name" : "volcoll0.74726980810712",
"sched_id" : "",
"is_unmanaged" : true,
"last_modified" : 1474185092,
"name" : "snapcoll0.4960602191544121",
"description" : "V4IASnM9A8OdGduTVd0j2Nrj9ploIGTPaSpuUCZQhHWWHJPqnYC5vQvr2ghcryOc",
"origin_name" : "g1a1",
"sched_name" : "",
"is_manual" : true,
"online_status" : "offline",
"snapshots_list" : [
{
"snap_name" : "snapcoll0.496060219154412",
"snapcoll_id" : "0500000000000004d3000000000000000000000006",
"schedule_name" : "",
"name" : "snapcoll0.496060219154412",
"vol_id" : "0600000000000004d300000000000000000000000b",
"snap_id" : "0400000000000004d3000000000000000c00000006",
"vol_name" : "vol10.725545841881562",
"id" : "0400000000000004d3000000000000000c00000006",
"snapcoll_name" : "snapcoll0.4960602191544121",
"schedule_id" : ""
},
{
"snap_name" : "snapcoll0.496060219154412",
"snapcoll_id" : "0500000000000004d3000000000000000000000006",
"schedule_name" : "",
"name" : "snapcoll0.496060219154412",
"vol_id" : "0600000000000004d300000000000000000000000c",
"snap_id" : "0400000000000004d3000000000000000d00000006",
"vol_name" : "vol20.422463494995331",
"id" : "0400000000000004d3000000000000000d00000006",
"snapcoll_name" : "snapcoll0.4960602191544121",
"schedule_id" : ""
}
],
"is_external_trigger" : false
}
}