Create
POST v1/snapshot_collections
Description
Create a snapshot collection. VSS application-synchronized snapshot collection must specify the 'allow_writes' parameter ans set it to 'true'.
Normal Response Codes
201
HTTP Error Codes
202 400 401 404 409 500 501 503
Detail Error Codes
Request
| Parameter | Type | JSON Type | Description | Default | Mandatory | Deprecated |
|---|---|---|---|---|---|---|
| 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. | Yes | ||
| description | NsDescription | string | Text description of snapshot collection. String of up to 255 printable ASCII characters. Example: '99.9999% availability'. | '' | No | |
| volcoll_id | NsObjectID | string | Parent volume collection ID. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'. | Yes | ||
| is_external_trigger | NsBoolean | boolean | Is externally triggered. Possible values: 'true', 'false'. | 'false' | No | |
| replicate | NsBoolean | boolean | True if this snapshot collection has been marked for replication. Possible values: 'true', 'false'. | 'false' | No | |
| start_online | NsBoolean | boolean | Start with snapshot set online. Possible values: 'true', 'false'. | 'false' | No | |
| 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'. | 'false' | No | |
| disable_appsync | NsBoolean | boolean | Do not perform application synchronization for this snapshot, create a crash-consistent snapshot instead. Possible values: 'true', 'false'. | 'false' | No | |
| snap_verify | NsBoolean | boolean | Run verification tool on this snapshot. This option can only be used with a volume collection that has application synchronization. Possible values: 'true', 'false'. | 'false' | No | |
| skip_db_consistency_check | NsBoolean | boolean | Skip consistency check for database files on this snapshot. This option only applies to volume collections with application synchronization set to VSS, application ID set to MS Exchange 2010 or later with Database Availability Group (DAG), snap_verify option set to true, and disable_appsync option set to false. Possible values: 'true', 'false'. | 'false' | No |
JSON Request
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'. | |
| 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'. | |
| 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'. |
JSON Response