VMCheckPoint
Applies To: System Center 2016 - Service Provider Foundation, System Center Technical Preview
VMCheckpoint
Gets, creates, updates, or deletes checkpoints of virtual machines in Virtual Machine Manager (VMM).
HTTP Verbs
| GET | POST | PUT | DELETE |
|---|---|---|---|
| Yes | Yes | Yes | Yes |
GET
Gets the specified checkpoint.
Entity Properties
| Name | Type | Mandatory | Description |
|---|---|---|---|
| StampId | Edm.Guid | Yes | The identifier of the stamp that restricts the query. |
| ID | Edm.Guid | No | The identifier of the checkpoint to retrieve. |
| VMId | Edm.Guid | No | The identifier of the virtual machine that contains the checkpoint. |
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 that restricts the query. |
| VMId | Edm.Guid | Yes | The identifier of the virtual machine to create a checkpoint of. |
| Confirm | Edm.Boolean | No | You must set this value to True 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 that restricts the query. |
| ID | Edm.Guid | No | The identifier of the checkpoint to update. |
| Description | Edm.String | No | The description of the checkpoint. |
| Name | Edm.String | No | The name 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 that restricts the query. |
| ID | Edm.Guid | No | The identifier of the checkpoint to delete. |