[{"label":"Latest (v1.0)","version":"latest"}]
vmware-sase-platform

Create Edge

Description

Provision a new Edge, or invoke an action on a set of existing Edges.

Request

Request

URL

URL


post
https://{api_host}//api/sdwan/v2/enterprises/{enterpriseLogicalId}/edges
Copy

Path Parameters

Path Parameters

string
enterpriseLogicalId Required

The logicalId GUID for the target enterprise


Query Parameters

Query Parameters

string
action Optional

An action to be applied to the list of specified edges.

Possible values are: blinkLedsreboothardResetshutdownrestartService


string
include Optional

A comma-separated list of field names corresponding to linked resources. Where supported, the server will resolve resource attributes for the specified resources.


Request Body

Request Body

EdgePostSchema of mimetype application/json Optional

Edge provision request schema

This request body class requires only one of the following: BatchEdgeActionPostBodySchema, EdgeProvisionSchema
Response

Response

201 Created Response Body>

Response Body

201 Created

Returns EdgeResource of type application/json

Request successfully processed

{
	"_href": "string",
	"activationKey": "string",
	"activationKeyExpires": "string",
	"activationState": "UNASSIGNED",
	"activationTime": "string",
	"alertsEnabled": false,
	"bastionState": "UNCONFIGURED",
	"buildNumber": "string",
	"created": "string",
	"customInfo": "string",
	"description": "string",
	"deviceFamily": "string",
	"deviceId": "string",
	"dnsName": "string",
	"edgeState": "NEVER_ACTIVATED",
	"edgeStateTime": "string",
	"endpointPkiMode": "CERTIFICATE_DISABLED",
	"enterprise": {
		"_href": "string",
		"accountNumber": "string",
		"alertsEnabled": false,
		"bastionState": "UNCONFIGURED",
		"city": "string",
		"contactEmail": "string",
		"contactMobile": "string",
		"contactName": "string",
		"contactPhone": "string",
		"country": "string",
		"created": "string",
		"description": "string",
		"domain": "string",
		"endpointPkiMode": "CERTIFICATE_DISABLED",
		"gatewayPool": {
			"_href": "string"
		},
		"lat": 0,
		"locale": "string",
		"logicalId": "string",
		"lon": 0,
		"modified": "string",
		"name": "string",
		"operatorAlertsEnabled": false,
		"postalCode": "string",
		"prefix": "string",
		"state": "string",
		"streetAddress": "string",
		"streetAddress2": "string",
		"timezone": "string"
	},
	"factoryBuildNumber": "string",
	"factorySoftwareVersion": "string",
	"haLastContact": "string",
	"haMode": "string",
	"haPreviousState": "UNCONFIGURED",
	"haSerialNumber": "string",
	"haState": "UNCONFIGURED",
	"isLive": false,
	"lastContact": "string",
	"links": [
		{
			"_href": "string"
		}
	],
	"logicalId": "string",
	"lteRegion": "string",
	"modelNumber": "string",
	"modemBuildNumber": "string",
	"modemFirmwareVersion": "string",
	"modified": "string",
	"name": "string",
	"operatorAlertsEnabled": false,
	"platformBuildNumber": "string",
	"platformFirmwareVersion": "string",
	"selfMacAddress": "string",
	"serialNumber": "string",
	"serviceState": "IN_SERVICE",
	"serviceUpSince": "string",
	"site": {
		"_href": "string",
		"city": "string",
		"contactEmail": "string",
		"contactMobile": "string",
		"contactName": "string",
		"contactPhone": "string",
		"country": "string",
		"created": "string",
		"lat": 0,
		"locale": "string",
		"lon": 0,
		"modified": "string",
		"name": "string",
		"postalCode": "string",
		"shippingAddress": "string",
		"shippingAddress2": "string",
		"shippingCity": "string",
		"shippingContactName": "string",
		"shippingCountry": "string",
		"shippingPostalCode": "string",
		"shippingSameAsLocation": false,
		"shippingState": "string",
		"state": "string",
		"streetAddress": "string",
		"streetAddress2": "string",
		"timezone": "string"
	},
	"softwareUpdated": "string",
	"softwareVersion": "string",
	"standbyBuildNumber": "string",
	"standbyDeviceId": "string",
	"standbyFactoryBuildNumber": "string",
	"standbyFactorySoftwareVersion": "string",
	"standbyModelNumber": "string",
	"standbyServiceUpSince": "string",
	"standbySoftwareVersion": "string",
	"standbySystemUpSince": "string",
	"systemUpSince": "string"
}
string
_href Optional

string
activationKey Optional

string as date-time
activationKeyExpires Optional

string
activationState Optional

Possible values are: UNASSIGNEDPENDINGACTIVATEDREACTIVATION_PENDING


string as date-time
activationTime Optional

boolean
alertsEnabled Optional

string
bastionState Optional

Possible values are: UNCONFIGUREDSTAGE_REQUESTEDUNSTAGE_REQUESTEDSTAGEDUNSTAGEDPROMOTION_REQUESTEDPROMOTION_PENDINGPROMOTED


string
buildNumber Optional

string as date-time
created Optional

string
customInfo Optional

string
description Optional

string
deviceFamily Optional

string
deviceId Optional

string
dnsName Optional

string
edgeState Optional

Possible values are: NEVER_ACTIVATEDDEGRADEDOFFLINEDISABLEDEXPIREDCONNECTED


string as date-time
edgeStateTime Optional

string
endpointPkiMode Optional

Possible values are: CERTIFICATE_DISABLEDCERTIFICATE_OPTIONALCERTIFICATE_REQUIRED


enterprise Optional

string
factoryBuildNumber Optional

string
factorySoftwareVersion Optional

string as date-time
haLastContact Optional

string
haMode Optional

string
haPreviousState Optional

Possible values are: UNCONFIGUREDPENDING_INITPENDING_CONFIRMATIONPENDING_CONFIRMEDPENDING_DISSOCIATIONREADYFAILED


string
haSerialNumber Optional

string
haState Optional

Possible values are: UNCONFIGUREDPENDING_INITPENDING_CONFIRMATIONPENDING_CONFIRMEDPENDING_DISSOCIATIONREADYFAILED


boolean
isLive Optional

string as date-time
lastContact Optional

This field is deprecated. Please use “edgeState” to get updated edge status calculated by the Orchestrator.


array of BaseApiResource
links Optional

string
logicalId Optional

string
lteRegion Optional

string
modelNumber Optional

string
modemBuildNumber Optional

string
modemFirmwareVersion Optional

string as date-time
modified Optional

string
name Optional

boolean
operatorAlertsEnabled Optional

string
platformBuildNumber Optional

string
platformFirmwareVersion Optional

string
selfMacAddress Optional

string
serialNumber Optional

string
serviceState Optional

Possible values are: IN_SERVICEOUT_OF_SERVICEPENDING_SERVICE


string as date-time
serviceUpSince Optional

site Optional

string as date-time
softwareUpdated Optional

string
softwareVersion Optional

string
standbyBuildNumber Optional

string
standbyDeviceId Optional

string
standbyFactoryBuildNumber Optional

string
standbyFactorySoftwareVersion Optional

string
standbyModelNumber Optional

string as date-time
standbyServiceUpSince Optional

string
standbySoftwareVersion Optional

string as date-time
standbySystemUpSince Optional

string as date-time
systemUpSince Optional

202 Accepted Response Body>

Response Body

202 Accepted

Returns AsyncOperationEnqueued of type application/json

Asynchronous action enqueued

{
	"operationId": "string",
	"status": "ACCEPTED"
}
string
operationId Optional

string
status Optional

Possible values are: ACCEPTEDDONEERROR

Errors

Errors

ValidationError
400

ValidationError


UnAuthorized
401

Unauthorized


ResourceNotFoundError
404

Resource not found


UnsupportedMediaTypeError
415

UnsupportedMediaTypeError


DataValidationError
422

DataValidationError


RateLimitExceededError
429

Rate Limit Exceeded


InternalServerError
500

Internal server error

Code Samples

Code Samples

cURL Command

curl -X POST -H "Content-Type: application/json" -d '{}' https://{api_host}/api/sdwan/v2/enterprises/{enterpriseLogicalId}/edges


Feedback

Was this page helpful?