CnsBlockBackingDetails

CnsBlockBackingDetails
CnsBlockBackingDetails

Details for a block type backing for container volume.

This class will be used as input at the time of volume creation and will also be returned as part of query result to give more information about a container volume.

Note: In future, for block volumes the disk format, like thin, lazy-zeroed- thick, eager-zeroed-thick, will be made a part of storage policy. Until then, for block volumes, only the thin type of provisioning will be supported.

This structure may be used only with operations rendered under /vsan.

AllOf
This class requires all of the following:
JSON Example
{
    "_typeName": "string",
    "capacityInMb": 0,
    "backingDiskId": "string",
    "backingDiskUrlPath": "string",
    "backingDiskPath": "string",
    "backingDiskObjectId": "string",
    "usedCapacityInMb": 0,
    "aggregatedSnapshotCapacityInMb": 0
}
string
backingDiskId
Optional

At the time of creation this field would identify the existing disk that should be used to back the container volume.

This field is optional and when this and backingDiskPath are not specified, a new disk will be created to back the volume.

When this filed is present, capacityInMb and storage policy fields will be ignored.

string
backingDiskUrlPath
Optional

At the time of creation this field would identify the URL path to an existing disk that should be used to back the container volume.

This field should be set in create request when the client wants to register an existing disk as a CNS block volume. If this disk is already registered as CNS block volume, then the server will throw CnsAlreadyRegisteredFault CNS fault with the CNS volume ID set.

This field is optional and when this and backingDiskId are not specified, a new disk will be created to back the volume.

When this field is present, capacityInMb and storage policy fields will be ignored.

Note that this field will not be set in the query API result. But in future release of CNS, it may be set.

This field must be in the following format: Format: https://<vc_ip>/folder/<vm_vmdk_path>?dcPath=<datacenterPath>& dsName=<datastoreName>

Ex: https://10.192.255.221/folder/34a9c05d-5f03-e254-e692-02004479cb91/ vm2_1.vmdk?dcPath=/Folder-1/Datacenter-1&dsName=vsanDatastore

This is for a 34a9c05d-5f03-e254-e692-02004479cb91/vm2_1.vmdk file under datacenter "Datacenter-1" with path "/Folder-1/Datacenter-1" and datastore "vsanDatastore".

string
backingDiskPath
Optional

This is file path of the volume.

It's different from backingDiskUrlPath. backingDiskUrlPath is accessible from a web browser, while backingDiskPath is accessible by the file system.

This field is set only in result of query.

string
backingDiskObjectId
Optional

This is the id generated by underlying object storage, such as vsan/vvol.

This field is set only in result of query.

integer As int64 As int64
usedCapacityInMb
Optional

This is the rolled up used capacity of the FCD and its snapshots.

Set to -1 if unknown.

integer As int64 As int64
aggregatedSnapshotCapacityInMb
Optional

This is the rolled up allocated space of the volume's snapshots.

Set to -1 if unknown.