Get L2 Network Extensions
Get list of extended networks
Retrieves a comprehensive list of all Layer 2 network extensions managed by this HCX Manager. Returns detailed information about each extended network including configuration, operational status, appliance assignments, feature settings, and health indicators. This API provides visibility into all active network extensions regardless of which site or service mesh they belong to, making it ideal for monitoring and inventory purposes across the entire HCX deployment.
Request
URI
GET
https://{server}/hybridity/api/l2NetworkExtensions
COPY
Authentication
This operation uses the following authentication methods.
Responses
200
Successfully retrieved list of network extensions.
Returns
l2NetworkExtensionsListResponse
of type(s)
application/json
{
"items": [
{
"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"
}
]
}
array of
object
items
Optional
items
400
Bad Request - Invalid query parameters or malformed 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
500
Internal Server Error
Returns
errorResponse
of type(s)
application/json
{
"errors": [
{
"code": "string",
"message": "string"
}
]
}
array of
object
errors
Optional
errors
Code Samples
COPY
curl -H 'Authorization: <value>' https://{api_host}/hybridity/api/l2NetworkExtensions