Create Block Device

Create Block Device

Following disk custom properties can be passed while creating a block device:

1. dataStore: Defines name of the datastore in which the disk has to be provisioned. 

2. storagePolicy: Defines name of the storage policy in which the disk has to be provisioned. If name of the datastore is specified in the custom properties then, datastore takes precedence.

3. provisioningType: Defines the type of provisioning. For eg. thick/thin. 

4. resourceGroupName: Defines the Azure resource group name where the disk needs to be provisioned.
Request
URI
POST
https://vra-interop-222-139.lvn.broadcom.net/iaas/api/block-devices
COPY
Query Parameters
string
apiVersion
Optional

The version of the API in yyyy-MM-dd format (UTC). For versioning information refer to /iaas/api/about


Request Body

Disk Specification instance

BlockDeviceSpecification of type(s) application/json
Required

Show optional properties

{
    "name": "string",
    "projectId": "e058",
    "capacityInGB": 78
}
{
    "name": "string",
    "projectId": "e058",
    "deploymentId": "123e4567-e89b-12d3-a456-426655440000",
    "customProperties": {
        "customProperties": "string"
    },
    "description": "string",
    "capacityInGB": 78,
    "encrypted": true,
    "persistent": true,
    "sourceReference": "ami-0d4cfd66",
    "diskContentBase64": "dGVzdA",
    "constraints": [
        {
            "mandatory": false,
            "expression": "ha:strong"
        }
    ],
    "tags": [
        {
            "key": "location",
            "value": "SOF"
        }
    ]
}
string
name
Required

A human-friendly name used as an identifier in APIs that support this option.

string
projectId
Required

The id of the project the current user belongs to.

string
deploymentId
Optional

The id of the deployment that is associated with this resource

object
customProperties
Optional

Additional custom properties that may be used to extend this resource.

string
description
Optional

A human-friendly description.

integer As int32 As int32
capacityInGB
Required

Capacity of the block device in GB.

boolean
encrypted
Optional

Indicates whether the block device should be encrypted or not.

boolean
persistent
Optional

Indicates whether the block device survives a delete action.

string
sourceReference
Optional

Reference to URI using which the block device has to be created.

string
diskContentBase64
Optional

Content of a disk, base64 encoded.

array of object
constraints
Optional

Constraints that are used to drive placement policies for the block device that is produced from this specification. Constraint expressions are matched against tags on existing placement targets.

array of object
tags
Optional

A set of tag keys and optional values that should be set on any resource that is produced from this specification.

Authentication
This operation uses the following authentication methods.
Responses
202

Accepted

Returns RequestTracker of type(s) application/json
"RequestTracker Object"
integer As int32 As int32
progress
Required

Progress of the request as percentage.

string
message
Optional

Status message of the request.

string
status
Required

Status of the request.

Possible values are : FINISHED, INPROGRESS, FAILED,
array of string
resources
Optional

Collection of resources.

string
name
Optional

Name of the operation.

string
id
Required

ID of this request.

string
selfLink
Required

Self link of this request.

string
deploymentId
Optional

ID of the deployment, this request is connected to.


400

Forbidden

Returns ServiceErrorResponse of type(s) application/json
"ServiceErrorResponse Object"
string
message
Optional

message

string
messageId
Optional

messageId

array of string
stackTrace
Optional

stackTrace

integer As int32 As int32
statusCode
Optional

statusCode

integer As int32 As int32
errorCode
Optional

errorCode

array of string
details
Optional

details

string
serverErrorId
Optional

serverErrorId

string
documentKind
Optional

documentKind

integer As int32 As int32
internalErrorCode
Optional

internalErrorCode


403

Invalid Request - bad data

Returns ServiceErrorResponse of type(s) application/json
"ServiceErrorResponse Object"
string
message
Optional

message

string
messageId
Optional

messageId

array of string
stackTrace
Optional

stackTrace

integer As int32 As int32
statusCode
Optional

statusCode

integer As int32 As int32
errorCode
Optional

errorCode

array of string
details
Optional

details

string
serverErrorId
Optional

serverErrorId

string
documentKind
Optional

documentKind

integer As int32 As int32
internalErrorCode
Optional

internalErrorCode


Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"capacityInGB:"integer","name:"string","projectId:"string"}' https://{api_host}/iaas/api/block-devices