Attach Machine Disk

Attach Machine Disk

Attach a disk to a machine.

Request
URI
POST
https://vra-interop-222-139.lvn.broadcom.net/iaas/api/machines/{id}/disks
COPY
Path Parameters
string
id
Required

The ID of the machine.

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

DiskAttachmentSpecification of type(s) application/json
Required

Show optional properties

{
    "blockDeviceId": "1298765"
}
{
    "name": "string",
    "description": "string",
    "blockDeviceId": "1298765",
    "scsiController": "SCSI_Controller_0, SCSI_Controller_1, SCSI_Controller_2, SCSI_Controller_3",
    "unitNumber": "0",
    "diskAttachmentProperties": {
        "scsiController": "SCSI_Controller_0",
        "unitNumber": "2"
    }
}
string
name
Optional

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

string
description
Optional

A human-friendly description.

string
blockDeviceId
Required

The id of the existing block device

string
scsiController
Optional

Deprecated: The SCSI controller to be assigned

string
unitNumber
Optional

Deprecated: The Unit Number to be assigned

object
diskAttachmentProperties
Optional

Disk Attachment specific properties

Authentication
This operation uses the following authentication methods.
Responses
200

Successful operation

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

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


403

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


404

Not found

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 '{"blockDeviceId:"string"}' https://{api_host}/iaas/api/machines/{id}/disks
On This Page
Compute Operations
GET
Get Machine Disks
POST
Attach Machine Disk
GET
Get Machine Disk
DELETE
Delete Machine Disk