Vslm V Storage Object Manager Vslm Query Changed Disk Areas

Vslm V Storage Object Manager Vslm Query Changed Disk Areas

Get a list of areas of a virtual disk that have been modified since a well-defined point in the past.

The beginning of the change interval is identified by "changeId", while the end of the change interval is implied by the snapshot ID passed in.

Note that the result of this function may contain "false positives" (i.e: flag areas of the disk as modified that are not). However, it is guaranteed that no changes will be missed.

Required privileges: System.View

Request
URI
POST
https://{vcenter-host}/sdk/vim25/{release}/vslm/VslmVStorageObjectManager/{moId}/VslmQueryChangedDiskAreas
COPY
Path Parameters
string
moId
Required

The unique identifier for the managed object to which the method attaches; the serialized managed object reference for a request has the form moType/moId, in this case VslmVStorageObjectManager/{moId}.

string
release
Required

The vSphere release schema. The current specification covers vSphere 8.0.3.0 APIs.


Request Body
VslmQueryChangedDiskAreasRequestType of type(s) application/json
Required

Show optional properties

{
    "id": {
        "id": "string"
    },
    "snapshotId": {
        "id": "string"
    },
    "startOffset": 0,
    "changeId": "string"
}
{
    "id": {
        "_typeName": "string",
        "id": "string"
    },
    "snapshotId": {
        "_typeName": "string",
        "id": "string"
    },
    "startOffset": 0,
    "changeId": "string"
}
id
Required

This data object type describes an identifier class which is globally unique to identify the associated object.

snapshotId
Required

This data object type describes an identifier class which is globally unique to identify the associated object.

integer As int64 As int64
startOffset
Required

Start Offset in bytes at which to start computing changes. Typically, callers will make multiple calls to this function, starting with startOffset 0 and then examine the "length" property in the returned DiskChangeInfo structure, repeatedly calling queryChangedDiskAreas until a map for the entire virtual disk has been obtained.

string
changeId
Required

Identifier referring to a point in the past that should be used as the point in time at which to begin including changes to the disk in the result. A typical use case would be a backup application obtaining a changeId from a virtual disk's backing info when performing a backup. When a subsequent incremental backup is to be performed, this change Id can be used to obtain a list of changed areas on disk.

Authentication
This operation uses the following authentication methods.
Responses
200

Returns a data structure specifying extents of the virtual disk that have changed since the thime the changeId string was obtained.

Returns DiskChangeInfo of type(s) application/json
This response body class contains all of the following: DataObject
{
    "_typeName": "string",
    "startOffset": 0,
    "length": 0,
    "changedArea": [
        {
            "_typeName": "string",
            "start": 0,
            "length": 0
        }
    ]
}
integer As int64 As int64
startOffset
Required

Start offset (in bytes) of disk area described by this data structure.

integer As int64 As int64
length
Required

Length (in bytes) of disk area described by this data structure.

changedArea
Optional

Modified disk areas.

Might be empty if no parts of the disk between startOffset and startOffset + length were modified.


500

InvalidDatastore: If the operation cannot be performed on the datastore.

NotFound: If specified virtual storage object or snapshot cannot be found.

FileFault: if the virtual disk files cannot be accessed/queried.

InvalidState: if change tracking is not supported for this particular disk.

InvalidArgument: if startOffset is beyond the end of the virtual disk or changeId is invalid.

Returns MethodFault of type(s) application/json
This response body class contains all of the following: Any
{
    "_typeName": "string",
    "faultCause": "MethodFault Object",
    "faultMessage": [
        {
            "_typeName": "string",
            "key": "string",
            "arg": [
                {
                    "_typeName": "string",
                    "key": "string",
                    "value": {
                        "_typeName": "string"
                    }
                }
            ],
            "message": "string"
        }
    ]
}
faultCause
Optional

The base data object type for all the object model faults that an application might handle.

faultMessage
Optional

Message which has details about the error Message can also contain a key to message catalog which can be used to generate better localized messages.


Storage Lifecycle Management Operations
POST
Vslm V Storage Object Manager Vslm Attach Disk Task
POST
Vslm V Storage Object Manager Vslm Attach Tag To V Storage Object
POST
Vslm V Storage Object Manager Vslm Clear V Storage Object Control Flags
POST
Vslm V Storage Object Manager Vslm Clone V Storage Object Task
POST
Vslm V Storage Object Manager Vslm Create Disk Task
POST
Vslm V Storage Object Manager Vslm Create Disk From Snapshot Task
POST
Vslm V Storage Object Manager Vslm Create Snapshot Task
POST
Vslm V Storage Object Manager Vslm Delete Snapshot Task
POST
Vslm V Storage Object Manager Vslm Delete V Storage Object Task
POST
Vslm V Storage Object Manager Vslm Detach Tag From V Storage Object
POST
Vslm V Storage Object Manager Vslm Extend Disk Task
POST
Vslm V Storage Object Manager Vslm Inflate Disk Task
POST
Vslm V Storage Object Manager Vslm List Tags Attached To V Storage Object
POST
Vslm V Storage Object Manager Vslm List V Storage Object For Spec
POST
Vslm V Storage Object Manager Vslm List V Storage Objects Attached To Tag
POST
Vslm V Storage Object Manager Vslm Query Changed Disk Areas
POST
Vslm V Storage Object Manager Vslm Query Global Catalog Sync Status
POST
Vslm V Storage Object Manager Vslm Query Global Catalog Sync Status For Datastore
POST
Vslm V Storage Object Manager Vslm Reconcile Datastore Inventory Task
POST
Vslm V Storage Object Manager Vslm Register Disk
POST
Vslm V Storage Object Manager Vslm Relocate V Storage Object Task
POST
Vslm V Storage Object Manager Vslm Rename V Storage Object
POST
Vslm V Storage Object Manager Vslm Retrieve Snapshot Details
POST
Vslm V Storage Object Manager Vslm Retrieve Snapshot Info
POST
Vslm V Storage Object Manager Vslm Retrieve V Storage Infrastructure Object Policy
POST
Vslm V Storage Object Manager Vslm Retrieve V Storage Object
POST
Vslm V Storage Object Manager Vslm Retrieve V Storage Object Associations
POST
Vslm V Storage Object Manager Vslm Retrieve V Storage Object Metadata
POST
Vslm V Storage Object Manager Vslm Retrieve V Storage Object Metadata Value
POST
Vslm V Storage Object Manager Vslm Retrieve V Storage Objects
POST
Vslm V Storage Object Manager Vslm Retrieve V Storage Object State
POST
Vslm V Storage Object Manager Vslm Revert V Storage Object Task
POST
Vslm V Storage Object Manager Vslm Schedule Reconcile Datastore Inventory
POST
Vslm V Storage Object Manager Vslm Set V Storage Object Control Flags
POST
Vslm V Storage Object Manager Vslm Update V Storage Infrastructure Object Policy Task
POST
Vslm V Storage Object Manager Vslm Update Vstorage Object Crypto Task
POST
Vslm V Storage Object Manager Vslm Update V Storage Object Metadata Task
POST
Vslm V Storage Object Manager Vslm Update Vstorage Object Policy Task