Create Edge
Provision a new Edge, or invoke an action on a set of existing Edges.
The logicalId GUID for the target enterprise
A comma-separated list of field names corresponding to linked resources. Where supported, the server will resolve resource attributes for the specified resources.
An action to be applied to the list of specified edges.
Edge provision request schema
"EdgePostSchema Object"Request successfully processed
{
"_href": "string",
"activationKey": "string",
"activationKeyExpires": "string",
"activationState": "string",
"activationTime": "string",
"alertsEnabled": false,
"bastionState": "string",
"buildNumber": "string",
"created": "string",
"customInfo": "string",
"description": "string",
"deviceFamily": "string",
"deviceId": "string",
"dnsName": "string",
"edgeState": "string",
"edgeStateTime": "string",
"endpointPkiMode": "string",
"factoryBuildNumber": "string",
"factorySoftwareVersion": "string",
"platformBuildNumber": "string",
"platformFirmwareVersion": "string",
"modemBuildNumber": "string",
"modemFirmwareVersion": "string",
"lteRegion": "string",
"haLastContact": "string",
"haPreviousState": "string",
"haSerialNumber": "string",
"haState": "string",
"isLive": false,
"lastContact": "string",
"logicalId": "string",
"modelNumber": "string",
"modified": "string",
"name": "string",
"operatorAlertsEnabled": false,
"selfMacAddress": "string",
"serialNumber": "string",
"serviceState": "string",
"serviceUpSince": "string",
"softwareUpdated": "string",
"softwareVersion": "string",
"systemUpSince": "string",
"links": [
{
"_href": "string",
"created": "string",
"logicalId": "string",
"internalId": "string",
"interface": "string",
"macAddress": "string",
"ipAddress": "string",
"ipV6Address": "string",
"netmask": "string",
"networkSide": "string",
"networkType": "string",
"displayName": "string",
"userOverride": false,
"isp": "string",
"org": "string",
"lat": "number",
"lon": "number",
"lastActive": "string",
"state": "string",
"backupState": "string",
"linkMode": "string",
"lastEvent": "string",
"lastEventState": "string",
"alertsEnabled": false,
"operatorAlertsEnabled": false,
"serviceState": "string",
"modified": "string"
}
],
"site": {
"_href": "string",
"created": "string",
"name": "string",
"contactName": "string",
"contactPhone": "string",
"contactMobile": "string",
"contactEmail": "string",
"streetAddress": "string",
"streetAddress2": "string",
"city": "string",
"state": "string",
"country": "string",
"postalCode": "string",
"lat": "number",
"lon": "number",
"timezone": "string",
"locale": "string",
"shippingSameAsLocation": false,
"shippingContactName": "string",
"shippingAddress": "string",
"shippingAddress2": "string",
"shippingCity": "string",
"shippingState": "string",
"shippingCountry": "string",
"shippingPostalCode": "string",
"modified": "string"
},
"enterprise": {
"_href": "string",
"created": "string",
"alertsEnabled": false,
"operatorAlertsEnabled": false,
"endpointPkiMode": "string",
"name": "string",
"domain": "string",
"prefix": "string",
"logicalId": "string",
"accountNumber": "string",
"description": "string",
"contactName": "string",
"contactPhone": "string",
"contactMobile": "string",
"contactEmail": "string",
"streetAddress": "string",
"streetAddress2": "string",
"city": "string",
"state": "string",
"postalCode": "string",
"country": "string",
"lat": "number",
"lon": "number",
"timezone": "string",
"locale": "string",
"modified": "string",
"gatewayPool": {
"_href": "string"
},
"bastionState": "string"
},
"haMode": "string",
"standbySystemUpSince": "string",
"standbyServiceUpSince": "string",
"standbySoftwareVersion": "string",
"standbyFactorySoftwareVersion": "string",
"standbyFactoryBuildNumber": "string",
"standbyBuildNumber": "string",
"standbyModelNumber": "string",
"standbyDeviceId": "string"
}_href
activationKey
activationKeyExpires
activationState
activationTime
alertsEnabled
bastionState
buildNumber
created
customInfo
description
deviceFamily
deviceId
dnsName
edgeState
edgeStateTime
endpointPkiMode
factoryBuildNumber
factorySoftwareVersion
platformBuildNumber
platformFirmwareVersion
modemBuildNumber
modemFirmwareVersion
lteRegion
haLastContact
haPreviousState
haSerialNumber
haState
isLive
This field is deprecated. Please use "edgeState" to get updated edge status calculated by the Orchestrator.
logicalId
modelNumber
modified
name
operatorAlertsEnabled
selfMacAddress
serialNumber
serviceState
serviceUpSince
softwareUpdated
softwareVersion
systemUpSince
links
site
enterprise
haMode
standbySystemUpSince
standbyServiceUpSince
standbySoftwareVersion
standbyFactorySoftwareVersion
standbyFactoryBuildNumber
standbyBuildNumber
standbyModelNumber
standbyDeviceId
Asynchronous action enqueued
"AsyncOperationEnqueued Object"status
operationId
ValidationError
"ValidationError Object"A unique error code
The name of the property to which the error applies, if applicable
A detailed description of the error condition intended for developers of API clients, which may include recommendations for resolution
A non-technical description of the error condition
A link to applicable external documentation
A list of property-specific errors
Unauthorized
"UnAuthorized Object"A unique error code
The name of the property to which the error applies, if applicable
A detailed description of the error condition intended for developers of API clients, which may include recommendations for resolution
A non-technical description of the error condition
A link to applicable external documentation
Resource not found
"ResourceNotFoundError Object"A unique error code
The name of the property to which the error applies, if applicable
A detailed description of the error condition intended for developers of API clients, which may include recommendations for resolution
A non-technical description of the error condition
A link to applicable external documentation
UnsupportedMediaTypeError
"UnsupportedMediaTypeError Object"A unique error code
The name of the property to which the error applies, if applicable
A detailed description of the error condition intended for developers of API clients, which may include recommendations for resolution
A non-technical description of the error condition
A link to applicable external documentation
DataValidationError
"DataValidationError Object"A unique error code
The name of the property to which the error applies, if applicable
A detailed description of the error condition intended for developers of API clients, which may include recommendations for resolution
A non-technical description of the error condition
A link to applicable external documentation
Rate Limit Exceeded
"RateLimitExceededError Object"A unique error code
The name of the property to which the error applies, if applicable
A detailed description of the error condition intended for developers of API clients, which may include recommendations for resolution
A non-technical description of the error condition
A link to applicable external documentation
Internal server error
"InternalServerError Object"A unique error code
The name of the property to which the error applies, if applicable
A detailed description of the error condition intended for developers of API clients, which may include recommendations for resolution
A non-technical description of the error condition
A link to applicable external documentation
curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/api/sdwan/v2/enterprises/{enterpriseLogicalId}/edges/