Cloud.vSphere.Machine

Cloud.vSphere.Machine
Cloud.vSphere.Machine

Request schema for provisioning of a vSphere machine resource

JSON Example
{
    "account": "string",
    "address": "string",
    "attachedDisks": [
        {
            "source": "string"
        }
    ],
    "checkImageSSLCertificate": false,
    "cloudConfig": "string",
    "cloudConfigSettings": {
        "phoneHomeFailOnTimeout": false,
        "phoneHomeShouldWait": false,
        "phoneHomeTimeoutSeconds": 0
    },
    "constraints": [
        {
            "tag": "string"
        }
    ],
    "cpuCount": 0,
    "customizationSpec": "string",
    "flavor": "string",
    "folderName": "string",
    "groupPlacement": "string",
    "image": "string",
    "imageRef": "string",
    "name": "string",
    "networks": [
        {
            "address": "string",
            "assignIPv6Address": false,
            "assignPublicIpAddress": false,
            "assignment": "string",
            "deviceIndex": 0,
            "name": "string",
            "network": "string",
            "tags": [
                {
                    "key": "string",
                    "value": "string"
                }
            ]
        }
    ],
    "osType": "string",
    "ovfProperties": [
        {
            "key": "string",
            "value": "string"
        }
    ],
    "powerState": "string",
    "project": "string",
    "region": "string",
    "remoteAccess": {
        "authentication": "string",
        "password": "string",
        "privateKey": "string",
        "sshKey": "string",
        "username": "string"
    },
    "resourceLeaseDurationSec": 0,
    "retryCount": 0,
    "snapshotLimit": 0,
    "storage": {
        "bootDiskCapacityInGB": 0,
        "constraints": [
            {
                "tag": "string"
            }
        ],
        "maxDiskCapacityInGB": 0
    },
    "tags": [
        {
            "key": "string",
            "value": "string"
        }
    ],
    "totalMemoryMB": 0
}
string
account
Optional

Cloud Account indicates the name of the endpoint used to provision this machine.

string
address
Optional

Machine IP address, populated by discovery or provisioning.

array of object
attachedDisks
Optional

List of disks to attach to the machine.

boolean
checkImageSSLCertificate
Optional

The purpose of this boolean property is whether to skip or validate SSL/TLS certificate when streaming OVF or OVA.

string
cloudConfig
Optional

When provisioning an instance, machine cloud-init startup instructions from user data fields. Sample cloud config instructions:

#cloud-config
repo_update: true
repo_upgrade: all
packages:
- httpd
- mariadb-server

runcmd:
- [ sh, -c, "amazon-linux-extras install -y lamp-mariadb10.2-php7.2 php7.2" ]
- systemctl start httpd
- sudo systemctl enable httpd
object
cloudConfigSettings
Optional

Specify how the provided Cloud Config should be handled

array of object
constraints
Optional

To target the correct resources, blueprint constraints are matched against infrastructure capability tags. Constraints must include the key name. Options include value, negative[!], and hard or soft requirement.

integer
cpuCount
Optional

Number of virtual processors to assign to this machine. The default is 1.

string
customizationSpec
Optional

If machine settings from a vSphere customization spec need to be applied upon creation, the name of the customization spec to use, which must exist on the endpoint. Example customizations include host, network, and licensing settings.

string
flavor
Optional

Generic types of compute resources, mapped in an environment to specific types of compute resources.

string
folderName
Optional

The path to the folder where the virtual machine is provisioned, relative to the datacenter that the resource pool is in.

string
groupPlacement
Optional

Group Placement

string
image
Optional

Generic compute images, mapped in an environment to specific compute resource images.

string
imageRef
Optional

vSphere image used for creating the machine. Examples include templates, OVA or OVF links, snapshots, and content libraries.

string
name
Optional

Machine name.

array of object
networks
Optional

Networks to attach to the machine. Multiple network interfaces are allowed.

string
osType
Optional

Operating system of the machine, populated by discovery or provisioning. Values include WINDOWS and LINUX.

array of object
ovfProperties
Optional

Map of key, value pairs. key is the ovf key for a property in an OVF package. value is the ovf value for a property in an ovf package.

string
powerState
Optional

Machine power state of ON, OFF, GUEST_OFF, UNKNOWN, or SUSPEND.

Possible values are : ON, OFF, SUSPEND, GUEST_OFF,
string
project
Optional

Cloud Assembly project under which the machine is provisioned.

string
region
Optional

Datacenter name where the machine landed.

object
remoteAccess
Optional

Settings to remotely connect to the provisioned machine, by public/private key pair or username/password authentication. vSphere supports key pair but not username/password.

integer
resourceLeaseDurationSec
Optional

Time in seconds SDRS should reserve storage on the datastore

integer
retryCount
Optional

The number of retry attempt if insufficient storage error occurs

integer
snapshotLimit
Optional

Maximum number of snapshots allowed for the machine.

object
storage
Optional

Settings for constraining to the correct storage at provisioning time.

array of object
tags
Optional

Resource categorization, in case-sensitive key names, or in key-value pairs.

integer
totalMemoryMB
Optional

Machine virtual memory size in megabytes. The default is 1024 MB (1GB).