Skip to main content
A newer release of this product is available.

Create a new broadcast domain

Contributors
PDFs

POST /network/ethernet/broadcast-domains

Introduced In: 9.6

Creates a new broadcast domain.

Required properties

  • name - Name of the broadcast-domain to create.

  • mtu - Maximum transmission unit (MTU) of the broadcast domain.

  • ipspace.name or ipspace.uuid - IPspace the broadcast domain belongs to.

Default property values

If not specified in POST, the following default property values are assigned:

  • ipspace - Default

  • network port broadcast-domain create

Parameters

Name Type In Required Description

return_records

boolean

query

False

The default is false. If set to true, the records are returned.

  • Default value:

Request Body

Name Type Description

_links

_links

ipspace

ipspace

Applies to both SVM and cluster-scoped objects. Either the UUID or name is supplied on input.

mtu

integer

Maximum transmission unit, largest packet size on this network

name

string

Name of the broadcast domain, scoped to its IPspace

ports

array[ports]

Ports that belong to the broadcast domain

uuid

string

Broadcast domain UUID
Example request 
{
  "_links": {
    "self": {
      "href": "/api/resourcelink"
    }
  },
  "ipspace": {
    "_links": {
      "self": {
        "href": "/api/resourcelink"
      }
    },
    "name": "exchange",
    "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
  },
  "mtu": "1500",
  "name": "bd1",
  "ports": {
    "_links": {
      "self": {
        "href": "/api/resourcelink"
      }
    },
    "name": "e1b",
    "node": {
      "name": "node1"
    },
    "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
  },
  "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
}

Response

Status: 201, Created

Error

Status: Default

ONTAP Error Response Codes

Error Code Description

1377267

The specified IPspace does not exist.

1967082

The specified ipspace.name does not match the IPspace name of ipspace.uuid.

1967102

A POST operation might have left the configuration in an inconsistent state. Check the configuration.

53281982

The specified broadcast domain name is reserved by the system.
Name Type Description

error

error
Example error 
{
  "error": {
    "arguments": {
      "code": "string",
      "message": "string"
    },
    "code": "4",
    "message": "entry doesn't exist",
    "target": "uuid"
  }
}

Definitions

See Definitions

href

Name Type Description

href

string

_links

Name Type Description

self

href

ipspace

Applies to both SVM and cluster-scoped objects. Either the UUID or name is supplied on input.

Name Type Description

_links

_links

name

string

IPspace name

uuid

string

IPspace UUID

node

Name Type Description

name

string

Name of node on which the port is located.

ports

Port UUID along with readable names

Name Type Description

_links

_links

name

string

node

node

uuid

string

broadcast_domain

Set of ports that will receive a broadcast Ethernet packet from any of them

Name Type Description

_links

_links

ipspace

ipspace

Applies to both SVM and cluster-scoped objects. Either the UUID or name is supplied on input.

mtu

integer

Maximum transmission unit, largest packet size on this network

name

string

Name of the broadcast domain, scoped to its IPspace

ports

array[ports]

Ports that belong to the broadcast domain

uuid

string

Broadcast domain UUID

error_arguments

Name Type Description

code

string

Argument code

message

string

Message argument

error

Name Type Description

arguments

array[error_arguments]

Message arguments

code

string

Error code

message

string

Error message

target

string

The target parameter that caused the error.