Openstack Service (2.3.0)

Download OpenAPI specification:Download

This is the spec that defines the API provided by the application to provide APIs that act as proxy for openstack neutron APIS

Network

getNetwork

Get one or All Networks

query Parameters
net_id
string

Network-id of the Neutron Network to retrieve

Responses

createNetwork

Request Body schema: application/json

Create Network

name
required
string
net_id
string
description
string
Array of objects (Segment)
tenant_name
string

Unique Name of the tenant

admin_state_up
boolean
mtu
integer
enable_bd
boolean
Default: "false"

Responses

Request samples

Content type
application/json
{
  • "name": "GREEN_NETWORK",
  • "net_id": "123e4567-e89b-12d3-a456-426655440012",
  • "description": "Bengaluru DC IP Network",
  • "tenant_name": "Customer-A",
  • "segments":
    [
    ],
  • "admin_state_up": true,
  • "mtu": 1400
}

deleteNetwork

Delete Network

query Parameters
net_id
string

Network ID to be deleted

Responses

Subnet

getSubnet

Get All Subnets

query Parameters
subnet_id
string

ID of the Subnet to retrieve

Responses

createSubnet

Request Body schema: application/json

Create Subnet

name
required
string
description
string

Description of the Subnet

net_id
required
string
subnet_id
string
segment_id
string
ip_version
integer <uint8>
cidr
string
gateway_ip
string
ipv6_address_mode
string

The IPv6 address modes specifies mechanisms for assigning IP addresses

ipv6_ra_mode
string

The IPv6 router advertisement specifies whether the networking service should transmit ICMPv6 packets, for a subnet.

Responses

Request samples

Content type
application/json
{
  • "name": "MY_SUBNET",
  • "description": "MY_GREEN_SUBNET",
  • "net_id": "123e4567-e89b-12d3-a456-426655440012",
  • "subnet_id": "b0e7435c-1512-45fb-aa9e-9a7c5932fb30",
  • "segment_id": "1",
  • "ip_version": "4",
  • "cidr": "10.56.4.0/22",
  • "gateway_ip": "10.56.4.1",
  • "ipv6_address_mode": "slaac",
  • "ipv6_ra_mode": "slaac"
}

deleteSubnet

Delete Subnet by subnet UUID

query Parameters
subnet_id
string

subnet UUID

Responses

Subnet Setting

updateSubnetSetting

Request Body schema: application/json

Update Subnet Settings

name
required
string
subnet_id
string
net_id
required
string
gateway_ip
required
string

Responses

Request samples

Content type
application/json
{
  • "name": "MY_SUBNET",
  • "net_id": "123e4567-e89b-12d3-a456-426655440012",
  • "gateway_ip": "10.56.4.1"
}

Port Channel

getPortchannel

Get specified or all Port-channel details.

query Parameters
name
string

Unique name of the Port-channel to be fetched.

tenant_name
required
string

tenant to which this port channel belongs.

Responses

Tenant

getTenant

This api will fetch the configured details like l2VNI, l3VNI and its assets.

query Parameters
name
string

Name of the tenant to retrieve

Responses

cleanupTenant

This API will cleanup all openstack assets associated to a tenant

query Parameters
name
string

Name of the tenant to cleanup

Responses

Port

getPort

Get specified or all Ports

query Parameters
port_id
string

Neutron port-id of the Port to retrieve

Responses

createPort

Request Body schema: application/json

Create a new Port

name
required
string
port_id
required
string
net_id
string
dns_domain
string
dns_name
string
device_owner
string
Array of objects (SwitchInformation)

Responses

Request samples

Content type
application/json
{
  • "name": "Private-Port",
  • "port_id": "Ethernet 0/1",
  • "net_id": "123e4567-e89b-12d3-a456-426655440012",
  • "dns_domain": "my-domain.org",
  • "dns_name": "myport",
  • "device_owner": "baremetal:none",
  • "switch_information":
    [
    ]
}

deletePort

Delete Ports by neutron port id

query Parameters
port_id
required
string

Port ID to be deleted

Responses

Port Setting

updatePortSetting

Request Body schema: application/json

Update Port Setting.

name
required
string
device_owner
required
string

Responses

Request samples

Content type
application/json
{
  • "name": "Private-port",
  • "device_owner": "baremetal:none"
}

Router

getRouter

Get specified or all Routers

query Parameters
router_id
string

router-id of the Router

Responses

createRouter

Request Body schema: application/json

Create Router with a specified Neutron UUID

name
required
string
router_id
required
string
tenant_name
string

Unique Name of the tenant

Responses

Request samples

Content type
application/json
{
  • "name": "ROUTER-1",
  • "router_id": "f8a44de0-fc8e-45df-93c7-f79bf3b01c95",
  • "tenant_name": "Customer-A"
}

deleteRouter

Delete specified router on router-id

query Parameters
router_id
string

The ID of the router to be deleted

Responses

Router Interface

getRouterInterfaces

Get all Router Interfaces

query Parameters
router_id
string

router-id of the Router

Responses

addInterfaceToRouter

Request Body schema: application/json

Add a Router Interface to a Router

router_id
required
string
subnet_id
string

Responses

Request samples

Content type
application/json
{
  • "router_id": "f8a44de0-fc8e-45df-93c7-f79bf3b01c95",
  • "subnet_id": "45a44de0-fc8e-45df-93c7-f79bf3b01c95"
}

deleteInterfaceFromRouter

Request Body schema: application/json

Delete Router Interface from Router

router_id
required
string
subnet_id
string

Responses

Request samples

Content type
application/json
{
  • "router_id": "f8a44de0-fc8e-45df-93c7-f79bf3b01c95",
  • "subnet_id": "45a44de0-fc8e-45df-93c7-f79bf3b01c95"
}

Debug Delete Oss Asset

debugDeleteOssAsset

This API will delete openstack asset

Request Body schema: application/json

Ids of the Oss sset to delete

operation
string
Enum: "network-delete" "network-interface-delete" "router-delete" "router-interface-delete"
net_id
string
port_id
string
router_id
string
subnet_id
string

Responses

Request samples

Content type
application/json
{
  • "operation": "network-delete",
  • "net_id": "123e4567-e89b-12d3-a456-426655440012",
  • "port_id": "123e4567-e89b-12d3-a456-426655440010",
  • "router_id": "f8a44de0-fc8e-45df-93c7-f79bf3b01c95",
  • "subnet_id": "45a44de0-fc8e-45df-93c7-f79bf3b01c95"
}

Trouble Shooting

Get execution details

Get the detailed output of the given execution ID

query Parameters
id
required
string

Execution ID

Responses

Get Execution List

Get the list of all the previous executions

query Parameters
limit
required
integer
Default: 10

Limit the number of executions that will be sent in the response. Default is 10

status
string
Default: "all"

Filter the executions based on the status(failed/succeeded/all)

Responses

deleteExecutions

This API will delete the execution entries older than specific number of days

query Parameters
days_older_by
required
integer
Default: 30

Deletes execution entries older than specified number of days

Responses

Neutron EFA Sync Lock

Take an EFA lock from neutron

Request Body schema: application/json

Takes EFA Lock From Neutron

region
required
string
requester
required
string
request_id
string

Responses

Request samples

Content type
application/json
{
  • "region": "RegionOne",
  • "requester": "controller-1",
  • "request_id": "123e4567-e89b-12d3-a456-426614174000"
}

Neutron EFA Sync UnLock

Release EFA lock from neutron

Request Body schema: application/json

Releases EFA Lock From Neutron

region
required
string
requester
required
string
request_id
string

Responses

Request samples

Content type
application/json
{
  • "region": "RegionOne",
  • "requester": "controller-1",
  • "request_id": "123e4567-e89b-12d3-a456-426614174000"
}