Create Network Connector

Creates a network connector.

Request

URI

POST <network service endpoint>/v2.0/network_connectors

Example:

POST http://192.168.122.1:9696/v2.0/network_connectors

Headers

  • X-Auth-Token: token delivered by identity service
  • Content-Type: application/json

Body Syntax


{
	"network_connector" : {
		"name" : "connector1",
		"network_connector_pool_id" : "78380271-954a-4c1a-a76d-43033c7fc9bf",
		"tenant_id" : "29320d5e-dd29-425c-b386-3cbb2754ad03"
	}
}

Parameters

  • name:

    name for network connector

    • Type: String
    • Constraints: Up to 255 characters in length
    • Constraints: a-z, A-Z, 0-9, and _-
    • Required: Yes
  • network_connector_pool_id:

    A network connector pool id for this network connector. When this value not specified and only one pool exists, use it.

    • Type: String
    • Required: No
  • tenant_id:

    The tenant's ID to which this network connector belongs.

    This parameter is restricted for project in which requester joins.

    • Type: String
    • Required: No

Response

Status Code

  • 201

Headers

  • Content-Type: application/json

Body

Example:


{
	"network_connector" : {
		"id" : "07993b1c-79e1-4cf6-a663-dc42b9ce37d4",
		"name" : "connector1",
		"network_connector_pool_id" : "78380271-954a-4c1a-a76d-43033c7fc9bf",
		"network_connector_endpoints" : [],
		"tenant_id" : "29320d5e-dd29-425c-b386-3cbb2754ad03"
	}
}

Elements

  • id:

    ID for this network connector

    • Type: String
  • name:

    name for network connector

    • Type: String
  • network_connector_pool_id:

    A network connector pool id for this network connector.

    • Type: String
  • network_connector_endpoints:

    ID of network connector endpoints belonging to this network connector. Immediate after creation, this value must be empty array.

    • Type: Array of String
  • tenant_id:

    tenant's ID to which this network connector belongs

    • Type: String

Errors

  • 400: Invalid parameter in request body
  • 401: Token is not specified or not authorized.
  • 403: Token is not permitted to operate.
  • 404: Network Connector Pool not found.
  • 409: Operation conflicts with another one.
  • 503: No resource remains in the network connector pool