Network Extension Transition Eligibility

Get list of appliances eligible for transition of extended networks

Determines which Network Extension (NE) appliances or HA groups are eligible as targets for transitioning existing network extensions. Network extension transition allows moving active Layer 2 extensions from one NE appliance/HA group to another without disrupting the extended network or migrated VMs. This API evaluates appliance compatibility, capacity, and configuration to identify valid transition targets.

Request

URI

POST

https://{server}/hybridity/api/l2NetworkExtensions/transition/eligible-targets

COPY

Request Body

Request specifying either extension IDs or cluster IDs to check for transition eligibility. Can optionally filter by target appliance type. The response identifies compatible target appliances/HA groups for each queried entity.

networkExtensionTransitionEligibilityRequest of type(s) application/json

Required

{
    "clusters": [
        {
            "id": "string",
            "targetApplianceType": "string"
        }
    ],
    "extensions": [
        {
            "id": "string",
            "targetApplianceType": "string"
        }
    ],
    "targetApplianceType": "string"
}

array of object

clusters

Optional

clusters

array of object

extensions

Optional

extensions

string

targetApplianceType

Optional

targetApplianceType

Authentication

This operation uses the following authentication methods.

x-hm-authorization

VCF_SSO_TOKEN

Responses

202

Accepted

Returns networkExtensionTransitionEligibilityPostResponse of type(s) application/json

{
    "eligible_entities": [
        {
            "networkName": "string",
            "stretchId": "string",
            "currentClusterId": "string",
            "currentApplianceId": "string",
            "currentApplianceName": "string",
            "currentHAGroupId": "string",
            "currentHAGroupName": "string",
            "errors": [
                {
                    "code": "string",
                    "message": "string"
                }
            ],
            "eligibleServiceMeshes": [
                {
                    "id": "string",
                    "name": "string",
                    "eligibleAppliances": [
                        {
                            "clusterId": "string",
                            "applianceId": "string",
                            "applianceName": "string",
                            "haGroupId": "string",
                            "haGroupName": "string",
                            "extensionsCount": 0,
                            "extensionCapacity": 0,
                            "bridgeType": "string",
                            "applianceType": "string"
                        }
                    ]
                }
            ]
        }
    ],
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

array of object

eligible_entities

Optional

eligible_entities

array of object

errors

Optional

errors

207

Multi-Status

Returns networkExtensionTransitionEligibilityPostResponse of type(s) application/json

{
    "eligible_entities": [
        {
            "networkName": "string",
            "stretchId": "string",
            "currentClusterId": "string",
            "currentApplianceId": "string",
            "currentApplianceName": "string",
            "currentHAGroupId": "string",
            "currentHAGroupName": "string",
            "errors": [
                {
                    "code": "string",
                    "message": "string"
                }
            ],
            "eligibleServiceMeshes": [
                {
                    "id": "string",
                    "name": "string",
                    "eligibleAppliances": [
                        {
                            "clusterId": "string",
                            "applianceId": "string",
                            "applianceName": "string",
                            "haGroupId": "string",
                            "haGroupName": "string",
                            "extensionsCount": 0,
                            "extensionCapacity": 0,
                            "bridgeType": "string",
                            "applianceType": "string"
                        }
                    ]
                }
            ]
        }
    ],
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

array of object

eligible_entities

Optional

eligible_entities

array of object

errors

Optional

errors

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

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 -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{}' https://{api_host}/hybridity/api/l2NetworkExtensions/transition/eligible-targets

On This Page

Description

Request

Request Body

Authentication

Response

202 Response Body

207 Response Body

Errors

L2 Network Extensions Operations

POST

Validate L2 Network Extensions