Get L2 Network Extension
Get details of provided extensionId
Retrieves detailed configuration and operational status for a specific Layer 2 network extension identified by its extensionId (also known as stretchId). This API provides comprehensive information about a single extended network including all configuration parameters, operational state, health metrics, appliance assignments, and feature settings. Use this endpoint to monitor the status of a specific extension or retrieve its configuration for troubleshooting purposes.
Request
URI
GET
https://{server}/hybridity/api/l2NetworkExtensions/{extensionId}
COPY
Path Parameters
string
extensionId
Required
Unique identifier of the network extension (stretch ID).
Authentication
This operation uses the following authentication methods.
Responses
200
OK
Returns
l2NetworkExtensionGetResponse
of type(s)
application/json
{
"edgeId": "string",
"vlanId": "string",
"gateway": "string",
"netmask": "string",
"networkId": "string",
"stretchId": "string",
"applianceId": "string",
"networkName": "string",
"networkType": "string",
"dvsId": "string",
"dvsName": "string",
"applianceType": "string",
"isDeleted": false,
"cloudNetworkId": "string",
"cloudNetworkName": "string",
"clusterId": "string",
"endpointId": "string",
"resourceId": "string",
"creationDate": "string",
"endpointName": "string",
"endpointType": "string",
"resourceName": "string",
"resourceType": "string",
"source": {
"endpointId": "string",
"endpointType": "string",
"endpointName": "string",
"resourceId": "string",
"resourceType": "string",
"resourceName": "string"
},
"features": {
"proximityRouting": false,
"egressOptimization": false,
"mobilityOptimizedNetworking": false
},
"destination": {
"endpointId": "string",
"endpointType": "string",
"endpointName": "string",
"resourceId": "string",
"resourceType": "string",
"resourceName": "string"
},
"sourceNetwork": {
"networkId": "string",
"networkType": "string",
"networkName": "string",
"gatewayId": "string",
"accessMode": "string",
"gatewayName": "string",
"layer2Id": "string",
"isDistributedRouter": false,
"trunkMode": false,
"isNsxT": false,
"logicalSwitchId": "string",
"vcGuid": "string",
"dvsType": "string",
"transportZoneId": "string",
"transportZoneName": "string",
"transportZonePath": "string",
"transportZoneType": "string",
"resourceBackingDvpgId": "string",
"vdrMac": "string",
"dvsId": "string",
"dvsName": "string"
},
"operationStatus": {
"jobId": "string",
"state": "string",
"taskId": "string",
"message": "string",
"progress": "string",
"taskStatus": "string",
"statusMessage": "string"
},
"sourceAppliance": {
"applianceId": "string",
"applianceName": "string",
"applianceType": "string",
"clusterId": "string",
"haConfig": {
"haGroupId": "string",
"partnerApplianceId": "string",
"haGroupName": "string"
}
},
"destinationNetwork": {
"networkId": "string",
"networkType": "string",
"networkName": "string",
"gatewayId": "string",
"accessMode": "string",
"gatewayName": "string",
"layer2Id": "string",
"isDistributedRouter": false,
"trunkMode": false,
"isNsxT": false,
"logicalSwitchId": "string",
"vcGuid": "string",
"dvsType": "string",
"transportZoneId": "string",
"transportZoneName": "string",
"transportZonePath": "string",
"transportZoneType": "string",
"resourceBackingDvpgId": "string",
"vdrMac": "string",
"dvsId": "string",
"dvsName": "string"
},
"destinationAppliance": {
"applianceId": "string",
"applianceName": "string",
"applianceType": "string",
"clusterId": "string",
"haConfig": {
"haGroupId": "string",
"partnerApplianceId": "string",
"haGroupName": "string"
}
},
"vdrMacs": {
"vdrMACAddressUsedOnExtension": "string",
"currentVDRMACOnNSX": "string"
},
"code": "string",
"message": "string"
}
string
edgeId
Optional
edgeId
string
vlanId
Optional
vlanId
string
gateway
Optional
gateway
string
netmask
Optional
netmask
string
networkId
Optional
networkId
string
stretchId
Optional
stretchId
string
applianceId
Optional
applianceId
string
networkName
Optional
networkName
string
networkType
Optional
networkType
string
dvsId
Optional
dvsId
string
dvsName
Optional
dvsName
string
applianceType
Optional
applianceType
boolean
isDeleted
Optional
isDeleted
string
cloudNetworkId
Optional
cloudNetworkId
string
cloudNetworkName
Optional
cloudNetworkName
string
clusterId
Optional
clusterId
string
endpointId
Optional
endpointId
string
resourceId
Optional
resourceId
string
creationDate
Optional
creationDate
string
endpointName
Optional
endpointName
string
endpointType
Optional
endpointType
string
resourceName
Optional
resourceName
string
resourceType
Optional
resourceType
object
source
Optional
source
object
features
Optional
features
object
destination
Optional
destination
object
sourceNetwork
Optional
sourceNetwork
object
operationStatus
Optional
operationStatus
object
sourceAppliance
Optional
sourceAppliance
object
destinationNetwork
Optional
destinationNetwork
object
destinationAppliance
Optional
destinationAppliance
object
vdrMacs
Optional
vdrMacs
string
code
Optional
code
string
message
Optional
message
400
Bad Request
Returns
errorResponse
of type(s)
application/json
{
"errors": [
{
"code": "string",
"message": "string"
}
]
}
array of
object
errors
Optional
errors
401
Unauthorized
Operation doesn't return any data structure
403
Forbidden
Operation doesn't return any data structure
404
Not Found
Returns
errorResponse
of type(s)
application/json
{
"errors": [
{
"code": "string",
"message": "string"
}
]
}
array of
object
errors
Optional
errors
500
Internal Server Error
Returns
errorResponse
of type(s)
application/json
"errorResponse Object"
array of
object
errors
Optional
errors
Code Samples
COPY
curl -H 'Authorization: <value>' https://{api_host}/hybridity/api/l2NetworkExtensions/{extensionId}