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

Get Edge Deployment By ID

Description

Get a single Edge deployment

Request

Request

URL

URL


get
https://cloud.vmwarehorizon.com/admin/v2/edge-deployments/{id}
Copy

Path Parameters

Path Parameters

string
id Required

Edge deployment ID


Query Parameters

Query Parameters

string
org_id Optional

Filter by orgId: non-super users can only query for their own orgIds


Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK

Returns EdgeDeploymentTOV2 of type */*

Successfully retrieved all edge deployments

{
    "adTwinSyncStatus": "SYNCED",
    "description": "My new edge deployment",
    "fqdn": "edge.example.com",
    "id": "id",
    "location": "US",
    "name": "edge-deployment-1",
    "orgId": "orgId",
    "providerInstanceId": "providerInstanceId",
    "providerLabel": "AZURE|VSPHERE",
    "status": "PENDING"
}
string
adTwinSyncStatus Optional

Edge deployment synchronization status with AD twin

Possible values are: NONESYNCEDSYNC_NEEDED


agentMonitoringConfig Optional

authEngine Optional

string as date-time
createdAt Optional

Record creation timestamp


string
description Optional

The description of the Edge Deployment


edgeGatewayLocation Optional

edgeVmDetails Optional

array of ErrorDetail
errorDetails Optional

Error details in case of Edge VM operation failure


string
fqdn Optional

FQDN with which to resolve the Edge VM management IP


HDC
hdc Optional

string
id Optional

The id of the Edge Deployment


infrastructure Optional

Infrastructure Resources needed by the Edge Deployment such as managementNetwork


string
location Optional

location


string
name Optional

The name of the Edge Deployment


string
orgId Optional

The id of the CSP org


privateEndpointDetails Optional

string
providerInstanceId Optional

The ProviderInstance where the Edge Deployment is deployed


string
providerLabel Optional

The type of the provider edge deployment belongs to


proxyConfiguration Optional

map of string
registeredModules Optional

List of modules registered with the edge deployment


map of string
resourceTags Optional

Resource tags that are added to edge deployment


ssoConfigurations Optional

Edge SSO configuration


string
status Optional

The current status of the Edge Gateway deployment

Possible values are: CONNECT_PENDINGCREATE_ACCEPTEDCREATE_FAILEDCREATE_PENDINGCREATINGDELETEDDELETE_FAILEDDELETE_PENDINGDELETINGFORCE_DELETE_PENDINGFORCE_DELETINGREADYUPDATE_FAILEDUPDATE_PENDINGUPDATING


map of string
twinSyncStatusMap Optional

Edge deployment synchronization status of edge twins

Possible values are: NONESYNCEDSYNC_NEEDED


string as date-time
updatedAt Optional

Record update timestamp


integer as int64
version Optional

Record version (internal)

Errors

Errors

401

Unauthorized


403

Forbidden


404

Not Found


500

Unexpected internal server error

Code Samples

Code Samples

cURL Command

curl https://cloud.vmwarehorizon.com/admin/v2/edge-deployments/{id}


Feedback

Was this page helpful?