Create Host Switch Profile

Create Host Switch Profile

Creates a hostswitch profile. The resource_type is required. For uplink profiles, the teaming and policy parameters are required. By default, the mtu is 1600 and the transport_vlan is 0. The supported MTU range is 1280 through 9000.

Request
URI
POST
https://nsxmanager.your.domain/api/v1/host-switch-profiles
COPY
Request Body
BaseHostSwitchProfile of type(s) application/json
Optional
{
    "_self": {
        "rel": "string"
    },
    "_system_owned": false,
    "display_name": "string",
    "description": "string",
    "required_capabilities": [
        "string"
    ],
    "_revision": 0,
    "tags": [
        {
            "scope": "string",
            "tag": "string"
        }
    ],
    "_schema": "string",
    "_create_time": 0,
    "_links": [
        {
            "action": "string",
            "href": "string",
            "rel": "string"
        }
    ],
    "resource_type": "string",
    "_last_modified_time": 0,
    "_last_modified_user": "string",
    "id": "string",
    "_create_user": "string"
}
_self
Optional

_self

boolean
_system_owned
Optional

Indicates system owned resource

string
display_name
Optional

Defaults to ID if not set

string
description
Optional

description

array of string
required_capabilities
Optional

required_capabilities

integer As int64 As int64
_revision
Optional

The _revision property describes the current revision of the resource. To prevent clients from overwriting each other's changes, PUT operations must include the current _revision of the resource, which clients should obtain by issuing a GET operation. If the _revision provided in a PUT request is missing or stale, the operation will be rejected.

array of Tag
tags
Optional

tags

string
_schema
Optional

_schema

integer As int64 As int64
_create_time
Optional

Timestamp of resource creation

_links
Optional

The server will populate this field when returing the resource. Ignored on PUT and POST.

string
resource_type
Required

Supported HostSwitch profiles.

Possible values are : UplinkHostSwitchProfile, LldpHostSwitchProfile,
integer As int64 As int64
_last_modified_time
Optional

Timestamp of last modification

string
_last_modified_user
Optional

ID of the user who last modified this resource

string
id
Optional

id

string
_create_user
Optional

ID of the user who created this resource

Authentication
This operation uses the following authentication methods.
Responses
201

Resource created successfully

Returns BaseHostSwitchProfile of type(s) application/json
{
    "_self": {
        "rel": "string"
    },
    "_system_owned": false,
    "display_name": "string",
    "description": "string",
    "required_capabilities": [
        "string"
    ],
    "_revision": 0,
    "tags": [
        {
            "scope": "string",
            "tag": "string"
        }
    ],
    "_schema": "string",
    "_create_time": 0,
    "_links": [
        {
            "action": "string",
            "href": "string",
            "rel": "string"
        }
    ],
    "resource_type": "string",
    "_last_modified_time": 0,
    "_last_modified_user": "string",
    "id": "string",
    "_create_user": "string"
}
_self
Optional

_self

boolean
_system_owned
Optional

Indicates system owned resource

string
display_name
Optional

Defaults to ID if not set

string
description
Optional

description

array of string
required_capabilities
Optional

required_capabilities

integer As int64 As int64
_revision
Optional

The _revision property describes the current revision of the resource. To prevent clients from overwriting each other's changes, PUT operations must include the current _revision of the resource, which clients should obtain by issuing a GET operation. If the _revision provided in a PUT request is missing or stale, the operation will be rejected.

array of Tag
tags
Optional

tags

string
_schema
Optional

_schema

integer As int64 As int64
_create_time
Optional

Timestamp of resource creation

_links
Optional

The server will populate this field when returing the resource. Ignored on PUT and POST.

string
resource_type
Required

Supported HostSwitch profiles.

Possible values are : UplinkHostSwitchProfile, LldpHostSwitchProfile,
integer As int64 As int64
_last_modified_time
Optional

Timestamp of last modification

string
_last_modified_user
Optional

ID of the user who last modified this resource

string
id
Optional

id

string
_create_user
Optional

ID of the user who created this resource


default

Unexpected error

Returns ApiError of type(s) application/json
{
    "module_name": "string",
    "error_message": "string",
    "error_code": 0
}
string
module_name
Optional

module_name

string
error_message
Optional

error_message

integer As int64 As int64
error_code
Optional

error_code


Network Transport Operations
POST
Create Bridge Cluster
POST
Create Bridge Endpoint
POST
Create Cluster Profile
POST
Create Edge Cluster
POST
Create Host Switch Profile
POST
Create Transport Node
POST
Create Transport Zone
POST
Create Transport Zone Profile
DELETE
Delete Bridge Cluster
DELETE
Delete Bridge Endpoint
DELETE
Delete Cluster Profile
DELETE
Delete Edge Cluster
DELETE
Delete Host Switch Profile
DELETE
Delete Transport Node
DELETE
Delete Transport Zone
DELETE
Delete Transport Zone Profile
GET
Get Bridge Cluster
GET
Get Bridge Cluster Status
GET
Get Bridge Endpoint
GET
Get Bridge Endpoint Statistics
GET
Get Bridge Endpoint Status
GET
Get Cluster Profile
GET
Get Host Switch Profile
GET
Get Transport Node
GET
Get Transport Node State
GET
Get Transport Zone
GET
Get Transport Zone Profile
GET
Get Transport Zone Status
GET
List Bridge Clusters
GET
List Bridge Endpoints
GET
List Cluster Profiles
GET
List Edge Clusters
GET
List Host Switch Profiles
GET
List Neighbor Properties
GET
List Transport Nodes
GET
List Transport Nodes By State
GET
List Transport Zone Profiles
GET
List Transport Zones
GET
Read Edge Cluster
GET
Read Neighbor Properties
POST
Replace Edge Cluster Member Transport Node
POST
Resync Transport Node
PUT
Update Bridge Cluster
PUT
Update Bridge Endpoint
PUT
Update Cluster Profile
PUT
Update Edge Cluster
PUT
Update Host Switch Profile
PUT
Update Transport Node
PUT
Update Transport Zone
PUT
Update Transport Zone Profile