[{"label":"Latest (V1)","version":"latest"}]
horizon-cloud-nextgen

Create

Description

Created a new UAG deployment: initiates the deployment process

Request

Request

URL

URL


post
https://cloud.vmwarehorizon.com/admin/v2/uag-deployments
Copy

Request Body

Request Body

UAGDeploymentCreateTOV2 of mimetype application/json Required

newUAGDeployment

{
    "description": "UAG Deployment description",
    "fqdn": "www.example.com",
    "name": "My UAG Deployment",
    "numberOfGateways": 2,
    "orgId": "0123456789",
    "providerInstanceId": "0123456789",
    "type": "EXTERNAL | INTERNAL | INTERNAL_AND_EXTERNAL"
}
string
description Optional

User defined description for this UAG deployment


string
fqdn Optional

Admin-defined FQDN of the UAG cluster


infrastructure Optional

Other infrastructure resources for the deployment. The keys in this map and the interpretation of the values depend on the provider type.


string
name Optional

User defined name for this UAG deployment


integer as int32
numberOfGateways Optional

Number of Gateways needed in the UAG deployment cluster


string
orgId Optional

Org ID that owns this record


string
providerInstanceId Optional

Provider instance to where this UAG deployment is deployed


proxyConfiguration Optional

map of string
resourceTags Optional

Resource tags that are added to UAG deployment


sslCertificate Optional

string
type Optional

UAG deployment type

Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

201 Created

Returns UAGDeploymentTOV2 of type */*

Successfully create UAG Deployment

{
    "edgeDeploymentId": "1234",
    "fqdn": "www.example.com",
    "location": "US",
    "name": "My Instance Name",
    "numberOfGateways": 2,
    "orgId": "0123456789",
    "providerInstanceId": "0123456789",
    "providerLabel": "AZURE",
    "status": "PENDING",
    "type": "EXTERNAL | INTERNAL | INTERNAL_AND_EXTERNAL"
}
string as date-time
createdAt Optional

Record creation timestamp


string
description Optional

string
edgeDeploymentId Optional

Edge Deployment id


array of ErrorDetail
errorDetails Optional

List of Error Details


string
fqdn Optional

Admin-defined FQDN of the UAG cluster


array of UAGVmDetailsTO
gateways Optional

List of UAG VMs and their details which are deployed


HDC
hdc Optional

string
id Optional

infrastructure Optional

Other infrastructure resources for the deployment. The keys in this map and the interpretation of the values depend on the provider type.


loadBalancer Optional

string
location Optional

location


string
name Optional

User defined name for this instance


integer as int32
numberOfGateways Optional

Number of Gateways needed in the UAG deployment cluster


string
orgId Optional

Org ID that owns this record


string
passwordCredentialId Optional

CredentialId where the Gateway password is stored.


privateLoadBalancer Optional

string
providerInstanceId Optional

Provider instance to where this UAG deployment is deployed


string
providerLabel Optional

Provider label (provider of which this is an instance)


proxyConfiguration Optional

reportedProperties Optional

map of string
resourceTags Optional

Resource tags that are added to UAG deployment


string
sslCertificateCredentialId Optional

CredentialId where the SSL certificate is stored.


sslCertificateTO Optional

string
status Optional

The configured status of the UAG Cluster deployment

Possible values are: DELETEDDELETE_PENDINGDELETINGDELETION_FAILEDDEPLOYINGFAILEDPARTIALLY_READYPENDINGREADYUPDATE_FAILEDUPDATE_PENDINGUPDATINGUPGRADE_FAILEDUPGRADE_PENDINGUPGRADING


string
type Optional

UAG deployment type


string as date-time
updatedAt Optional

Record updated timestamp


integer as int64
version Optional

Record version (internal)

Errors

Errors

ErrorResponse
400

Bad Request


ErrorResponse
401

Unauthorized


ErrorResponse
403

Forbidden


ErrorResponse
404

Not Found


ErrorResponse
409

Conflict


ErrorResponse
423

Provider disabled


ErrorResponse
500

Unexpected internal server error

Code Samples

Code Samples

cURL Command

curl -X POST -H "Content-Type: application/json" -d '{"description":"UAG Deployment description","fqdn":"www.example.com","name":"My UAG Deployment","numberOfGateways":2,"orgId":"0123456789","providerInstanceId":"0123456789","type":"EXTERNAL | INTERNAL | INTERNAL_AND_EXTERNAL"}' https://cloud.vmwarehorizon.com/admin/v2/uag-deployments
Vendor Extensions

Vendor Extensions

This operation contains the following vendor extensions defined in the spec:
x-codegen-request-body-name: newUAGDeployment


Feedback

Was this page helpful?