VMCheckPoints
Applies To: System Center 2016 - Service Provider Foundation, System Center Technical Preview
VMCheckPoints
Reads, creates, updates, or deletes virtual machine check points.
HTTP Verbs
| GET | POST | PUT | DELETE |
|---|---|---|---|
| Yes | Yes | Yes | Yes |
GET
Gets either the specified checkpoint, all checkpoints, or all checkpoints of a specific virtual machine.
Entity Properties
| Name | Type | Mandatory | Description |
|---|---|---|---|
| StampId | Edm.Guid | Yes | The identifier of the stamp to restrict the query to |
| ID | Edm.Guid | No | The checkpoint identifier |
| VMId | Edm.Guid | No | The identifier of the virtual machine |
POST
Creates a new checkpoint of the specified virtual machine
Entity Properties
| Name | Type | Mandatory | Description |
|---|---|---|---|
| StampId | Edm.Guid | Yes | The identifier of the stamp to restrict the query to |
| VMId | Edm.Guid | Yes | The identifier of the virtual machine to create a checkpoint of |
| Confirm | Edm.Boolean | No | The value True must be provided in this property to create a new checkpoint. |
| Name | Edm.String | No | The name of the checkpoint |
| Description | Edm.String | No | The description of the checkpoint |
PUT
Updates the specified checkpoint.
Entity Properties
| Name | Type | Mandatory | Description |
|---|---|---|---|
| StampId | Edm.Guid | Yes | The identifier of the stamp to restrict the query to |
| ID | Edm.Guid | Yes | The identifier of the checkpoint to update |
| Name | Edm.String | No | The name of the checkpoint |
| Description | Edm.String | No | The description of the checkpoint |
| VMCheckPointAction | Edm.String | No | The action that the checkpoint performs. The only value supported is Restore. If this property is set, the virtual machine is rolled back to this checkpoint. |
DELETE
Deletes the specified checkpoint.
Entity Properties
| Name | Type | Mandatory | Description |
|---|---|---|---|
| StampId | Edm.Guid | Yes | The identifier of the stamp to restrict the query to |
| ID | Edm.Guid | Yes | The identifier of the checkpoint to delete |