Network > Transit Hub > API v2 Guide

To use the API, API endpoint and token are required. Refer to API usage preparations to prepare the information required to use the API.

For Transit Hub API, the network type endpoint is used. For more details, see serviceCatalog from the response of token issuance.

Type Region Endpoint
network Korea (Pangyo) Region
Korea (Pyeongchon) Region
https://kr1-api-network-infrastructure.nhncloudservice.com
https://kr2-api-network-infrastructure.nhncloudservice.com

In each API response, you may find fields that are not specified within this guide. Those fields are for NHN Cloud internal usage, so refrain from using them because they may be changed without prior notice.

Transit Hub

View Transit Hubs

GET /v2.0/gateways/transithubs
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
id Query UUID - Transit hub ID to query
String Query Token ID - Transit hub name to query

Response

Format Description Description Header
transithubs String nodegroups.uuid List of transit hub information objects
transithubs.id String UUID Transit Hub ID
transithubs.tenant_id String Token ID Tenant ID
transithubs.name String Token ID Transit Hub Name
transithubs.description String Token ID Transit Hub description
transithubs.multicast_enable String Boolean Whether to enable multicast feature
transithubs.default_association_enable String Boolean Whether to enable the default routing table association feature
transithubs.default_propagation_enable String Boolean Whether to enable the default routing table propagation feature
Example
{
  "transithubs": [
    {
      "status": "ACTIVE",
      "description": null,
      "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "created_at": "2024-02-12 22:19:05",
      "multicast_enable": true,
      "updated_at": "2024-02-12 22:19:05",
      "default_propagation_enable": true,
      "default_association_enable": true,
      "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
      "name": "thub"
    }
  ]
}

View Transit Hub

GET /v2.0/gateways/transithubs/{transitHubId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
transitHubId O UUID Response Transit Hub ID

Response

Format Description Description Header
transithub String Object Transit hub information object
transithub.id String UUID Transit Hub ID
transithub.tenant_id String Token ID Tenant ID
transithub.name String Token ID Transit Hub Name
transithub.description String Token ID Transit Hub description
transithub.multicast_enable String Boolean Whether to enable multicast feature
transithub.default_association_enable String Boolean Whether to enable the default routing table association feature
transithub.default_propagation_enable String Boolean Whether to enable the default routing table propagation feature
Example
{
  "transithub": {
    "status": "ACTIVE",
    "description": null,
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "created_at": "2024-02-12 22:19:05",
    "multicast_enable": true,
    "updated_at": "2024-02-12 22:19:05",
    "default_propagation_enable": true,
    "default_association_enable": true,
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
    "name": "thub"
  }
}

Create Transit Hub

POST /v2.0/gateways/transithubs
X-Auth-Token: {tokenId}

Request

Format Description Description tokenId Header
String O Token ID Response Token ID
transithub String Object Response Transit hub information object
transithub.name String Token ID - Transit Hub Name
transithub.description String Token ID - Transit Hub description
transithub.multicast_enable String Boolean Response Whether to enable multicast feature
transithub.default_association_enable String Boolean Response Whether to enable the default routing table association feature
transithub.default_propagation_enable String Boolean Response Whether to enable the default routing table propagation feature
Example
{
  "transithub": {
    "default_propagation_enable": true,
    "default_association_enable": true,
    "multicast_enable": true,
    "name": "thub",
    "description": "test"
  }
}

Response

Format Description Description Header
transithub String Object Transit hub information object
transithub.id String UUID Transit Hub ID
transithub.tenant_id String Token ID Tenant ID
transithub.name String Token ID Transit Hub Name
transithub.description String Token ID Transit Hub description
transithub.multicast_enable String Boolean Whether to enable multicast feature
transithub.default_association_enable String Boolean Whether to enable the default routing table association feature
transithub.default_propagation_enable String Boolean Whether to enable the default routing table propagation feature
Example
{
  "transithub": {
    "status": "ACTIVE",
    "description": null,
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "created_at": "2024-02-12 22:19:05",
    "multicast_enable": true,
    "updated_at": "2024-02-12 22:19:05",
    "default_propagation_enable": true,
    "default_association_enable": true,
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
    "name": "thub"
  }
}

Modify Transit Hub

PUT /v2.0/gateways/transithubs/{transitHubId}
X-Auth-Token: {tokenId}

Request

Format Description Description tokenId Header
String O Token ID Response Token ID
transitHubId O UUID Response Transit Hub ID
transithub String Object Response Transit hub information object
transithub.name String Token ID - Transit Hub Name
transithub.description String Token ID - Transit Hub description
Example
{
  "transithub": {
    "name": "thub1",
    "description": "test1"
  }
}

Response

Format Description Description Header
transithub String Object Transit hub information object
transithub.id String UUID Transit Hub ID
transithub.tenant_id String Token ID Tenant ID
transithub.name String Token ID Transit Hub Name
transithub.description String Token ID Transit Hub description
transithub.multicast_enable String Boolean Whether to enable multicast feature
transithub.default_association_enable String Boolean Whether to enable the default routing table association feature
transithub.default_propagation_enable String Boolean Whether to enable the default routing table propagation feature
Example
{
  "transithub": {
    "status": "ACTIVE",
    "description": "test1",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "created_at": "2024-02-12 22:19:05",
    "multicast_enable": true,
    "updated_at": "2024-03-04 01:59:00.961621",
    "default_propagation_enable": true,
    "default_association_enable": true,
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
    "name": "thub1"
  }
}

Delete Transit Hub

DELETE /v2.0/gateways/transithubs/{transitHubId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
transitHubId O UUID Response Transit Hub ID

Response

Stops the specified node group.

Attachment

View Attachments

GET /v2.0/gateways/transithub_attachments
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
id Query UUID - Attachment ID to query
String Query Token ID - Attachment name to query
Resource ID Query UUID - Resource ID to query (VPC)
subnet_id Query UUID - Subnet ID to query
transithub_id Query UUID - Transit hub ID to query

Response

Format Description Description Header
transithub_attachments String nodegroups.uuid List of attachment information objects
transithub_attachments.id String UUID Attachment ID
transithub_attachments.tenant_id String Token ID Tenant ID
transithub_attachments.name String Token ID Attachment name
transithub_attachments.description String Token ID Attachment description
transithub_attachments.resource_id String UUID Resource ID (VPC)
transithub_attachments.subnet_id String UUID Subnet ID
transithub_attachments.transithub_id String UUID Transit Hub ID
Example
{
  "transithub_attachments": [
    {
      "status": "ACTIVE",
      "remote": false,
      "name": "thub-attachment",
      "resource_id": "8eabc2c1-78a2-41e2-b03d-c1021042701f",
      "subnet_id": "4263b32d-4bc5-45cc-bb3e-fded960e8f46",
      "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "created_at": "2024-02-13 01:22:09",
      "updated_at": "2024-02-13 01:22:11",
      "resource_cidr": "172.16.0.0/12",
      "transithub_id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
      "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "port_id": "eecaf943-fdcc-40da-bda2-45949026f668",
      "id": "23fc5818-c667-4e90-b50b-70b9e8727f49",
      "description": null
    }
  ]
}

View Attachment

GET /v2.0/gateways/transithub_attachments/{attachmentId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
attachmentId O UUID Response Attachment ID

Response

Format Description Description Header
transithub_attachment String Object Attachment information object
transithub_attachment.id String UUID Attachment ID
transithub_attachment.tenant_id String Token ID Tenant ID
transithub_attachment.name String Token ID Attachment name
transithub_attachment.description String Token ID Attachment description
transithub_attachment.resource_id String UUID Resource ID (VPC)
transithub_attachment.subnet_id String UUID Subnet ID
transithub_attachment.transithub_id String UUID Transit Hub ID
Example
{
  "transithub_attachment": {
    "status": "ACTIVE",
    "remote": false,
    "name": "thub-attachment",
    "resource_id": "8eabc2c1-78a2-41e2-b03d-c1021042701f",
    "subnet_id": "4263b32d-4bc5-45cc-bb3e-fded960e8f46",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "created_at": "2024-02-13 01:22:09",
    "updated_at": "2024-02-13 01:22:11",
    "resource_cidr": "172.16.0.0/12",
    "transithub_id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "port_id": "eecaf943-fdcc-40da-bda2-45949026f668",
    "id": "23fc5818-c667-4e90-b50b-70b9e8727f49",
    "description": null
  }
}

Create Attachment

POST /v2.0/gateways/transithub_attachments
X-Auth-Token: {tokenId}

Request

Format Description Description tokenId Header
String O Token ID Response Token ID
transithub_attachment String Object Response Load Balancer Information object
transithub_attachment.name String Token ID - Attachment name
transithub_attachment.description String Token ID - Attachment description
transithub_attachment.resource_id String UUID Response Resource ID (VPC)
transithub_attachment.subnet_id String UUID Response Subnet ID
transithub_attachment.transithub_id String UUID Response Transit hub ID where the attachment will be registered
Example
{
  "transithub_attachment": {
    "resource_id": "8eabc2c1-78a2-41e2-b03d-c1021042701f",
    "subnet_id": "4263b32d-4bc5-45cc-bb3e-fded960e8f46",
    "transithub_id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
    "name": "thub-attachment",
    "description": null
  }
}

Response

Format Description Description Header
transithub_attachment String Object Attachment information object
transithub_attachment.id String UUID Attachment ID
transithub_attachment.tenant_id String Token ID Tenant ID
transithub_attachment.name String Token ID Attachment name
transithub_attachment.description String Token ID Attachment description
transithub_attachment.resource_id String UUID Resource ID (VPC)
transithub_attachment.subnet_id String UUID Subnet ID
transithub_attachment.transithub_id String UUID Transit Hub ID
Example
{
  "transithub_attachment": {
    "status": "ACTIVE",
    "remote": false,
    "name": "thub-attachment",
    "resource_id": "8eabc2c1-78a2-41e2-b03d-c1021042701f",
    "subnet_id": "4263b32d-4bc5-45cc-bb3e-fded960e8f46",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "created_at": "2024-02-13 01:22:09",
    "updated_at": "2024-02-13 01:22:11",
    "resource_cidr": "172.16.0.0/12",
    "transithub_id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "port_id": "eecaf943-fdcc-40da-bda2-45949026f668",
    "id": "23fc5818-c667-4e90-b50b-70b9e8727f49",
    "description": null
  }
}

Modify Attachment

PUT /v2.0/gateways/transithub_attachments/{attachmentId}
X-Auth-Token: {tokenId}

Request

Format Description Description tokenId Header
String O Token ID Response Token ID
attachmentId O UUID Response Attachment ID
transithub_attachment String Object Response Attachment information object
transithub_attachment.name String Token ID - Attachment name
transithub_attachment.description String Token ID - Attachment description
Example
{
  "transithub_attachment": {
    "name": "thub-attachment1",
    "description": "test1"
  }
}

Response

Format Description Description Header
transithub_attachment String Object Attachment information object
transithub_attachment.id String UUID Attachment ID
transithub_attachment.tenant_id String Token ID Tenant ID
transithub_attachment.name String Token ID Attachment name
transithub_attachment.description String Token ID Attachment description
transithub_attachment.resource_id String UUID Resource ID (VPC)
transithub_attachment.subnet_id String UUID Subnet ID
transithub_attachment.transithub_id String UUID Transit Hub ID
Example
{
  "transithub_attachment": {
    "status": "ACTIVE",
    "remote": false,
    "name": "thub-attachment1",
    "resource_id": "8eabc2c1-78a2-41e2-b03d-c1021042701f",
    "subnet_id": "4263b32d-4bc5-45cc-bb3e-fded960e8f46",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "created_at": "2024-02-13 01:22:09",
    "updated_at": "2024-02-13 01:22:11",
    "resource_cidr": "172.16.0.0/12",
    "transithub_id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "port_id": "eecaf943-fdcc-40da-bda2-45949026f668",
    "id": "23fc5818-c667-4e90-b50b-70b9e8727f49",
    "description": "test1"
  }
}

Delete Attachment

DELETE /v2.0/gateways/transithub_attachments/{attachmentId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
attachmentId O UUID Response Attachment ID

Response

Stops the specified node group.

Routing Table

View Routing Tables

GET /v2.0/gateways/transithub_routing_tables
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
id Query UUID - Routing table ID to query
String Query Token ID - Routing table name to query
transithub_id Query UUID - Transit hub ID to query

Response

Format Description Description Header
transithub_routing_tables String nodegroups.uuid List of routing table information objects
transithub_routing_tables.id String UUID Routing table ID
transithub_routing_tables.tenant_id String Token ID Tenant ID
transithub_routing_tables.name String Token ID Routing table name
transithub_routing_tables.description String Token ID Routing table description
transithub_routing_tables.transithub_id String UUID Transit Hub ID
transithub_routing_tables.default_table String Boolean Whether routing table is default table
Example
{
  "transithub_routing_tables": [
    {
      "status": "ACTIVE",
      "description": "",
      "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "created_at": "2024-02-12 22:19:05",
      "updated_at": "2024-02-12 22:19:08",
      "default_table": true,
      "transithub_id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
      "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "id": "f5b96823-260a-415f-a162-d1914341137e",
      "name": "default-9d01afbb-0e"
    }
  ]
}

View Routing Table

GET /v2.0/gateways/transithub_routing_tables/{routingTableId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
routingTableId O UUID Response Routing table ID

Response

Format Description Description Header
transithub_routing_table String Object Routing table information object
transithub_routing_table.id String UUID Routing table ID
transithub_routing_table.tenant_id String Token ID Tenant ID
transithub_routing_table.name String Token ID Routing table name
transithub_routing_table.description String Token ID Routing table description
transithub_routing_table.transithub_id String UUID Transit Hub ID
transithub_routing_table.default_table String Boolean Whether routing table is default table
Example
{
  "transithub_routing_table": {
    "status": "ACTIVE",
    "description": "",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "created_at": "2024-02-12 22:19:05",
    "updated_at": "2024-02-12 22:19:08",
    "default_table": true,
    "transithub_id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "id": "f5b96823-260a-415f-a162-d1914341137e",
    "name": "default-9d01afbb-0e"
  }
}

Create Routing Table

POST /v2.0/gateways/transithub_routing_tables
X-Auth-Token: {tokenId}

Request

Format Description Description tokenId Header
String O Token ID Response Token ID
transithub_routing_table String Object Response Routing table information object
transithub_routing_table.name String Token ID - Routing table name
transithub_routing_table.description String Token ID - Routing table description
transithub_routing_table.transithub_id String UUID Response Transit hub ID where the routing table will be registered
Example
{
  "transithub_routing_table": {
    "transithub_id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
    "name": "thub-routing-table",
    "description": null
  }
}

Response

Format Description Description Header
transithub_routing_table String Object Routing table information object
transithub_routing_table.id String UUID Routing table ID
transithub_routing_table.tenant_id String Token ID Tenant ID
transithub_routing_table.name String Token ID Routing table name
transithub_routing_table.description String Token ID Routing table description
transithub_routing_table.transithub_id String UUID Transit Hub ID
transithub_routing_table.default_table String Boolean Whether routing table is default table
Example
{
  "transithub_routing_table": {
    "status": "BUILD",
    "description": null,
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "created_at": "2024-03-05 22:38:41",
    "updated_at": "2024-03-05 22:38:41",
    "default_table": false,
    "transithub_id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "id": "051eabf3-30f1-4e7a-a9bc-973c64f3c24a",
    "name": "thub-routing-table"
  }
}

Modify Routing Table

PUT /v2.0/gateways/transithub_routing_tables/{routingTableId}
X-Auth-Token: {tokenId}

Request

Format Description Description tokenId Header
String O Token ID Response Token ID
routingTableId O UUID Response Routing table ID
transithub_routing_table String Object Response Routing table information object
transithub_routing_table.name String Token ID - Routing table name
transithub_routing_table.description String Token ID - Routing table description
Example
{
  "transithub_routing_table": {
    "name": "thub-routing-table1",
    "description": "test"
  }
}

Response

Format Description Description Header
transithub_routing_table String Object Routing table information object
transithub_routing_table.id String UUID Routing table ID
transithub_routing_table.tenant_id String Token ID Tenant ID
transithub_routing_table.name String Token ID Routing table name
transithub_routing_table.description String Token ID Routing table description
transithub_routing_table.transithub_id String UUID Transit Hub ID
transithub_routing_table.default_table String Boolean Whether routing table is default table
Example
{
  "transithub_routing_table": {
    "status": "ACTIVE",
    "description": "test",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "created_at": "2024-03-05 22:38:41",
    "updated_at": "2024-03-05 22:40:44.303417",
    "default_table": false,
    "transithub_id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "id": "051eabf3-30f1-4e7a-a9bc-973c64f3c24a",
    "name": "thub-routing-table1"
  }
}

Delete Routing Table

DELETE /v2.0/gateways/transithub_routing_tables/{routingTableId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
routingTableId O UUID Response Routing table ID

Response

Stops the specified node group.

Routing Association

View Routing Associations

GET /v2.0/gateways/transithub_routing_associations
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
id Query UUID - Routing association ID to query
attachment_id Query UUID - Attachment ID to query
routing_table_id Query UUID - Routing table ID to query

Response

Format Description Description Header
transithub_routing_associations String nodegroups.uuid List of routing association information objects
transithub_routing_associations.id String UUID Routing Association ID
transithub_routing_associations.tenant_id String Token ID Tenant ID
transithub_routing_associations.description String Token ID Routing association description
transithub_routing_associations.attachment_id String UUID Attachment ID
transithub_routing_associations.routing_table_id String UUID Routing table ID
Example
{
  "transithub_routing_associations": [
    {
      "status": "ACTIVE",
      "attachment_id": "23fc5818-c667-4e90-b50b-70b9e8727f49",
      "description": "",
      "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "routing_table_id": "f5b96823-260a-415f-a162-d1914341137e",
      "created_at": "2024-02-13 01:22:09",
      "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "id": "56f5c3d2-2a9f-4ada-a358-356c6387de76",
      "updated_at": "2024-02-13 01:22:09"
    }
  ]
}

View Routing Association

GET /v2.0/gateways/transithub_routing_associations/{routingAssociationId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
routingAssociationId O UUID Response Routing Association ID

Response

Format Description Description Header
transithub_routing_association String Object Routing association information object
transithub_routing_association.id String UUID Routing Association ID
transithub_routing_association.tenant_id String Token ID Tenant ID
transithub_routing_association.description String Token ID Routing association description
transithub_routing_association.attachment_id String UUID Attachment ID
transithub_routing_association.routing_table_id String UUID Routing table ID
Example
{
  "transithub_routing_association": {
    "status": "ACTIVE",
    "attachment_id": "23fc5818-c667-4e90-b50b-70b9e8727f49",
    "description": "",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "routing_table_id": "f5b96823-260a-415f-a162-d1914341137e",
    "created_at": "2024-02-13 01:22:09",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "id": "56f5c3d2-2a9f-4ada-a358-356c6387de76",
    "updated_at": "2024-02-13 01:22:09"
  }
}

Create Routing Association

POST /v2.0/gateways/transithub_routing_associations
X-Auth-Token: {tokenId}

Request

Format Description Description tokenId Header
String O Token ID Response Token ID
transithub_routing_association String Object Response Routing association information object
transithub_routing_association.description String Token ID - Routing association description
transithub_routing_association.attachment_id String UUID Response Attachment ID
transithub_routing_association.routing_table_id String UUID Response Transit hub ID where the routing association will be registered
Example
{
  "transithub_routing_association": {
    "routing_table_id": "f5b96823-260a-415f-a162-d1914341137e",
    "attachment_id": "23fc5818-c667-4e90-b50b-70b9e8727f49"
  }
}

Response

Format Description Description Header
transithub_routing_association String Object Routing association information object
transithub_routing_association.id String UUID Routing Association ID
transithub_routing_association.tenant_id String Token ID Tenant ID
transithub_routing_association.description String Token ID Routing association description
transithub_routing_association.attachment_id String UUID Attachment ID
transithub_routing_association.routing_table_id String UUID Routing table ID
Example
{
  "transithub_routing_association": {
    "status": "ACTIVE",
    "attachment_id": "23fc5818-c667-4e90-b50b-70b9e8727f49",
    "description": "",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "routing_table_id": "f5b96823-260a-415f-a162-d1914341137e",
    "created_at": "2024-03-05 22:51:48",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "id": "a5532ee9-1d7b-44bd-a622-85198171ee98",
    "updated_at": "2024-03-05 22:51:48"
  }
}

Delete Routing Association

DELETE /v2.0/gateways/transithub_routing_associations/{routingAssociationId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
routingAssociationId O UUID Response Routing Association ID

Response

Stops the specified node group.

Routing Propagation

View Routing Associations

GET /v2.0/gateways/transithub_routing_propagations
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
id Query UUID - Routing propagation ID to query
attachment_id Query UUID - Attachment ID to query
routing_table_id Query UUID - Routing table ID to query

Response

Format Description Description Header
transithub_routing_propagations String nodegroups.uuid List of routing propagation information objects
transithub_routing_propagations.id String UUID Routing Propagation ID
transithub_routing_propagations.tenant_id String Token ID Tenant ID
transithub_routing_propagations.description String Token ID Routing Propagation description
transithub_routing_propagations.attachment_id String UUID Attachment ID
transithub_routing_propagations.routing_table_id String UUID Routing table ID
Example
{
  "transithub_routing_propagations": [
    {
      "status": "ACTIVE",
      "attachment_id": "23fc5818-c667-4e90-b50b-70b9e8727f49",
      "description": "",
      "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "routing_table_id": "f5b96823-260a-415f-a162-d1914341137e",
      "created_at": "2024-02-13 01:22:09",
      "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "id": "6bf0efaa-6d32-4fef-a341-7662e9bf1eb1",
      "updated_at": "2024-02-13 01:22:09"
    }
  ]
}

View Routing propagation

GET /v2.0/gateways/transithub_routing_propagations/{routingPropagationId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
routingPropagationId O UUID Response Routing Propagation ID

Response

Format Description Description Header
transithub_routing_propagation String Object Routing propagation information object
transithub_routing_propagation.id String UUID Routing Propagation ID
transithub_routing_propagation.tenant_id String Token ID Tenant ID
transithub_routing_propagation.description String Token ID Routing Propagation description
transithub_routing_propagation.attachment_id String UUID Attachment ID
transithub_routing_propagation.routing_table_id String UUID Routing table ID
Example
{
  "transithub_routing_propagation": {
    "status": "ACTIVE",
    "attachment_id": "23fc5818-c667-4e90-b50b-70b9e8727f49",
    "description": "",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "routing_table_id": "f5b96823-260a-415f-a162-d1914341137e",
    "created_at": "2024-02-13 01:22:09",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "id": "6bf0efaa-6d32-4fef-a341-7662e9bf1eb1",
    "updated_at": "2024-02-13 01:22:09"
  }
}

Create Routing Propagation

POST /v2.0/gateways/transithub_routing_propagations
X-Auth-Token: {tokenId}

Request

Format Description Description tokenId Header
String O Token ID Response Token ID
transithub_routing_propagation String Object Response Routing propagation information object
transithub_routing_propagation.description String Token ID - Routing Propagation description
transithub_routing_propagation.attachment_id String UUID Response Attachment ID
transithub_routing_propagation.routing_table_id String UUID Response Transit hub ID where the routing propagation will be registered
Example
{
  "transithub_routing_propagation": {
    "routing_table_id": "f5b96823-260a-415f-a162-d1914341137e",
    "attachment_id": "23fc5818-c667-4e90-b50b-70b9e8727f49"
  }
}

Response

Format Description Description Header
transithub_routing_propagation String Object Routing propagation information object
transithub_routing_propagation.id String UUID Routing Propagation ID
transithub_routing_propagation.tenant_id String Token ID Tenant ID
transithub_routing_propagation.description String Token ID Routing Propagation description
transithub_routing_propagation.attachment_id String UUID Attachment ID
transithub_routing_propagation.routing_table_id String UUID Routing table ID
Example
{
  "transithub_routing_propagation": {
    "status": "ACTIVE",
    "attachment_id": "23fc5818-c667-4e90-b50b-70b9e8727f49",
    "description": "",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "routing_table_id": "f5b96823-260a-415f-a162-d1914341137e",
    "created_at": "2024-03-05 22:56:58",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "id": "d1b54e63-0032-44dc-bb31-22d5723782ee",
    "updated_at": "2024-03-05 22:56:58.825231"
  }
}

Delete Routing Propagation

DELETE /v2.0/gateways/transithub_routing_propagations/{routingPropagationId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
routingPropagationId O UUID Response Routing Propagation ID

Response

Stops the specified node group.

Routing Rule

View Routing Rules

GET /v2.0/gateways/transithub_routing_rules
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
id Query UUID - Routing rule ID to query
Endpoint stage ID Query Enum - Routing rule action to query
One of FORWARD, BLACKHOLE
rule_type Query Enum - Routing rule type to query
Either STATIC or PROPAGATED
attachment_id Query UUID - Attachment ID to query
routing_table_id Query UUID - Routing table ID to query

Response

Format Description Description Header
transithub_routing_rules String nodegroups.uuid List of routing rule information objects
transithub_routing_rules.id String UUID Routing Rule ID
transithub_routing_rules.tenant_id String Token ID Tenant ID
transithub_routing_rules.description String Token ID Routing rule description
transithub_routing_rules.cidr String Token ID Routing rule IP band
transithub_routing_rules.action String Enum Routing rule action
One of FORWARD, BLACKHOLE
transithub_routing_rules.rule_type String Enum Routing rule type
Either STATIC or PROPAGATED
transithub_routing_rules.attachment_id String UUID Attachment ID
transithub_routing_rules.routing_table_id String UUID Routing table ID
transithub_routing_rules.propagation_id String UUID Routing propagation ID, used when routing type is PROPAGATEDby propagation
Example
{
  "transithub_routing_rules": [
    {
      "status": "ACTIVE",
      "rule_type": "PROPAGATED",
      "attachment_id": "ea9bb603-893c-4955-a7bb-64b6438a6f5b",
      "description": "",
      "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "created_at": "2024-02-12 22:35:48",
      "updated_at": "2024-02-12 22:35:48",
      "action": "FORWARD",
      "routing_table_id": "f5b96823-260a-415f-a162-d1914341137e",
      "cidr": "172.16.0.0/12",
      "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "propagation_id": "7a5d3159-a3a6-495b-bb0f-522c4d8a9933",
      "id": "3d10d565-8813-4c3c-9f1c-1af96eee9f14"
    }
  ]
}

View routing rule

GET /v2.0/gateways/transithub_routing_rules/{routingRuleId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
routingRuleId O UUID Response Routing Rule ID

Response

Format Description Description Header
transithub_routing_rule String Object Routing rule information object
transithub_routing_rule.id String UUID Routing Rule ID
transithub_routing_rule.tenant_id String Token ID Tenant ID
transithub_routing_rule.description String Token ID Routing rule description
transithub_routing_rule.cidr String Token ID Routing rule IP band
transithub_routing_rule.action String Enum Routing rule action
One of FORWARD, BLACKHOLE
transithub_routing_rule.rule_type String Enum Routing rule type
Either STATIC or PROPAGATED
transithub_routing_rule.attachment_id String UUID Attachment ID
transithub_routing_rule.routing_table_id String UUID Routing table ID
transithub_routing_rule.propagation_id String UUID Routing propagation ID, used when routing type is PROPAGATEDby propagation
Example
{
  "transithub_routing_rule": {
    "status": "ACTIVE",
    "rule_type": "PROPAGATED",
    "attachment_id": "ea9bb603-893c-4955-a7bb-64b6438a6f5b",
    "description": "",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "created_at": "2024-02-12 22:35:48",
    "updated_at": "2024-02-12 22:35:48",
    "action": "FORWARD",
    "routing_table_id": "f5b96823-260a-415f-a162-d1914341137e",
    "cidr": "172.16.0.0/12",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "propagation_id": "7a5d3159-a3a6-495b-bb0f-522c4d8a9933",
    "id": "3d10d565-8813-4c3c-9f1c-1af96eee9f14"
  }
}

Create Routing Rule

POST /v2.0/gateways/transithub_routing_rules
X-Auth-Token: {tokenId}

Request

Format Description Description tokenId Header
String O Token ID Response Token ID
transithub_routing_rule String Object Response Routing rule information object
transithub_routing_rule.name String Token ID - Routing rule name
transithub_routing_rule.description String Token ID - Routing rule description
transithub_routing_rule.cidr String Token ID Response Routing rule IP band
transithub_routing_rule.action String Enum - Routing rule action
One of FORWARD, BLACKHOLE
If not entered, FORWARD
transithub_routing_rule.attachment_id String UUID Response Attachment ID
transithub_routing_rule.routing_table_id String UUID Response The routing table ID where the routing rule will be registered.
Example
{
  "transithub_routing_rule": {
    "routing_table_id": "e5cb6442-4b5d-4298-84e2-adc9289c650e",
    "cidr": "1.1.1.0/24",
    "attachment_id": "6489cee8-0b5f-4053-b72d-1aa8b2921962"
  }
}

Response

Format Description Description Header
transithub_routing_rule String Object Routing rule information object
transithub_routing_rule.id String UUID Routing Rule ID
transithub_routing_rule.tenant_id String Token ID Tenant ID
transithub_routing_rule.description String Token ID Routing rule description
transithub_routing_rule.cidr String Token ID Routing rule IP band
transithub_routing_rule.action String Enum Routing rule action
One of FORWARD, BLACKHOLE
transithub_routing_rule.rule_type String Enum Routing rule type
Either STATIC or PROPAGATED
transithub_routing_rule.attachment_id String UUID Attachment ID
transithub_routing_rule.routing_table_id String UUID Routing table ID
transithub_routing_rule.propagation_id String UUID Routing propagation ID, used when routing type is PROPAGATEDby propagation
Example
{
  "transithub_routing_rule": {
    "status": "ACTIVE",
    "rule_type": "STATIC",
    "attachment_id": "6489cee8-0b5f-4053-b72d-1aa8b2921962",
    "description": "",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "created_at": "2024-03-06 23:00:05",
    "updated_at": "2024-03-06 23:00:05",
    "action": "FORWARD",
    "routing_table_id": "e5cb6442-4b5d-4298-84e2-adc9289c650e",
    "cidr": "1.1.1.0/24",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "propagation_id": null,
    "id": "3f765a36-bd6a-450a-9e05-366ecb8446c3"
  }
}

Delete Routing Rule

DELETE /v2.0/gateways/transithub_routing_rules/{routingRuleId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
routingRuleId O UUID Response Routing Rule ID

Response

Stops the specified node group.

Multicast Domain

View multicast domains

GET /v2.0/gateways/transithub_multicast_domains
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
id Query UUID - Multicast domain ID to query
String Query Token ID - Multicast domain name to query
transithub_id Query UUID - Transit hub ID to query

Response

Format Description Description Header
transithub_multicast_domains String nodegroups.uuid Multicast domain information objects
transithub_multicast_domains.id String UUID Multicast Domain ID
transithub_multicast_domains.tenant_id String Token ID Tenant ID
transithub_multicast_domains.name String Token ID Multicast domain name
transithub_multicast_domains.description String Token ID Multicast domain description
transithub_multicast_domains.transithub_id String UUID Transit Hub ID
Example
{
  "transithub_multicast_domains": [
    {
      "status": "ACTIVE",
      "description": null,
      "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "created_at": "2024-02-13 01:20:31",
      "updated_at": "2024-02-13 01:20:32",
      "transithub_id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
      "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "id": "d55022de-947f-4db3-a7b0-5a4cee9a2369",
      "name": "thub-domain"
    }
  ]
}

View Multicast Domain

GET /v2.0/gateways/transithub_multicast_domains/{multicastDomainId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
multicastDomainId O UUID Response Multicast Domain ID

Response

Format Description Description Header
String O Token ID Token ID
transithub_multicast_domain String Object Multicast domain information object
transithub_multicast_domain.name String Token ID Multicast domain name
transithub_multicast_domain.description String Token ID Multicast domain description
transithub_multicast_domain.transithub_id String UUID Transit hub ID where multicast domain will be registered
Example
{
  "transithub_multicast_domain": {
    "status": "ACTIVE",
    "description": null,
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "created_at": "2024-02-13 01:20:31",
    "updated_at": "2024-02-13 01:20:32",
    "transithub_id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "id": "d55022de-947f-4db3-a7b0-5a4cee9a2369",
    "name": "thub-domain"
  }
}

Create Multicast Domain

POST /v2.0/gateways/transithub_multicast_domains
X-Auth-Token: {tokenId}

Request

Format Description Description tokenId Header
String O Token ID Response Token ID
transithub_multicast_domain String Object Response Multicast domain information object
transithub_multicast_domain.name String Token ID - Multicast domain name
transithub_multicast_domain.description String Token ID - Multicast domain description
transithub_multicast_domain.transithub_id String UUID Response Transit hub ID where multicast domain will be registered
Example
{
  "transithub_multicast_domain": {
    "transithub_id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
    "name": "thub-domain1"
  }
}

Response

Format Description Description Header
transithub_multicast_domain String Object Multicast domain information object
transithub_multicast_domain.id String UUID Multicast Domain ID
transithub_multicast_domain.tenant_id String Token ID Tenant ID
transithub_multicast_domain.name String Token ID Multicast domain name
transithub_multicast_domain.description String Token ID Multicast domain description
transithub_multicast_domain.transithub_id String UUID Transit Hub ID
Example
{
  "transithub_multicast_domain": {
    "status": "BUILD",
    "description": null,
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "created_at": "2024-03-06 23:03:07",
    "updated_at": "2024-03-06 23:03:07",
    "transithub_id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "id": "fba53b77-431b-466f-8a31-784942649e73",
    "name": "thub-domain1"
  }
}

Modify Multicast Domain

PUT /v2.0/gateways/transithub_multicast_domains/{multicastDomainId}
X-Auth-Token: {tokenId}

Request

Format Description Description tokenId Header
String O Token ID Response Token ID
multicastDomainId O UUID Response Multicast Domain ID
transithub_multicast_domain String Object Response Multicast domain information object
transithub_multicast_domain.name String Token ID - Multicast domain name
transithub_multicast_domain.description String Token ID - Multicast domain description
Example
{
  "transithub_multicast_domain": {
    "name": "thub-domain",
    "description": "test"
  }
}

Response

Format Description Description Header
transithub_multicast_domain String Object Multicast domain information object
transithub_multicast_domain.id String UUID Multicast Domain ID
transithub_multicast_domain.tenant_id String Token ID Tenant ID
transithub_multicast_domain.name String Token ID Multicast domain name
transithub_multicast_domain.description String Token ID Multicast domain description
transithub_multicast_domain.transithub_id String UUID Transit Hub ID
Example
{
  "transithub_multicast_domain": {
    "status": "ACTIVE",
    "description": "test",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "created_at": "2024-03-06 23:03:07",
    "updated_at": "2024-03-06 23:06:18.031473",
    "transithub_id": "9d01afbb-0e95-423e-9360-15a3f2e9a233",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "id": "fba53b77-431b-466f-8a31-784942649e73",
    "name": "thub-domain"
  }
}

Delete Multicast Domain

DELETE /v2.0/gateways/transithub_multicast_domains/{multicastDomainId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
multicastDomainId O UUID Response Multicast Domain ID

Response

Stops the specified node group.

Multicast Association

View multicast domains

GET /v2.0/gateways/transithub_multicast_associations
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
id Query UUID - Multicast association ID to query
String Query Token ID - Multicast association name to query
domain_id Query UUID - Multicast domain ID to query

Response

Format Description Description Header
transithub_multicast_associations String nodegroups.uuid Multicast association information objects
transithub_multicast_associations.id String UUID Multicast association ID
transithub_multicast_associations.tenant_id String Token ID Tenant ID
transithub_multicast_associations.description String Token ID Multicast association description
transithub_multicast_associations.attachment_id String UUID Attachment ID
transithub_multicast_associations.subnet_id String UUID Subnet ID
transithub_multicast_associations.domain_id String UUID Multicast Domain ID
Example
{
  "transithub_multicast_associations": [
    {
      "status": "ACTIVE",
      "attachment_id": "23fc5818-c667-4e90-b50b-70b9e8727f49",
      "description": "",
      "subnet_id": "4263b32d-4bc5-45cc-bb3e-fded960e8f46",
      "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "created_at": "2024-02-13 01:22:37",
      "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "id": "3da29ae0-f544-4b8e-88c4-eb2ef78d0214",
      "updated_at": "2024-02-13 01:22:37",
      "domain_id": "d55022de-947f-4db3-a7b0-5a4cee9a2369"
    }
  ]
}

View Multicast Association

GET /v2.0/gateways/transithub_multicast_associations/{multicastAssociationId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
multicastAssociationId O UUID Response Routing Rule ID

Response

Format Description Description Header
String O Token ID Token ID
transithub_multicast_association String Object Multicast association information object
transithub_multicast_association.id String UUID Multicast association ID
transithub_multicast_association.tenant_id String Token ID Tenant ID
transithub_multicast_association.description String Token ID Multicast association description
transithub_multicast_association.attachment_id String UUID Attachment ID
transithub_multicast_association.subnet_id String UUID Subnet ID
transithub_multicast_association.domain_id String UUID Multicast Domain ID
Example
{
  "transithub_multicast_association": {
    "status": "ACTIVE",
    "attachment_id": "23fc5818-c667-4e90-b50b-70b9e8727f49",
    "description": "",
    "subnet_id": "4263b32d-4bc5-45cc-bb3e-fded960e8f46",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "created_at": "2024-02-13 01:22:37",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "id": "3da29ae0-f544-4b8e-88c4-eb2ef78d0214",
    "updated_at": "2024-02-13 01:22:37",
    "domain_id": "d55022de-947f-4db3-a7b0-5a4cee9a2369"
  }
}

Create Multicast Association

POST /v2.0/gateways/transithub_multicast_associations
X-Auth-Token: {tokenId}

Request

Format Description Description tokenId Header
String O Token ID Response Token ID
transithub_multicast_association String Object Response Multicast association information object
transithub_multicast_association.description String Token ID - Multicast association description
transithub_multicast_association.attachment_id String UUID Response Attachment ID
transithub_multicast_association.domain_id String UUID Response Multicast Domain ID
Example
{
  "transithub_multicast_association": {
    "attachment_id": "23fc5818-c667-4e90-b50b-70b9e8727f49",
    "domain_id": "d55022de-947f-4db3-a7b0-5a4cee9a2369"
  }
}

Response

Format Description Description Header
transithub_multicast_association String Object Multicast association information object
transithub_multicast_association.id String UUID Multicast association ID
transithub_multicast_association.tenant_id String Token ID Tenant ID
transithub_multicast_association.description String Token ID Multicast association description
transithub_multicast_association.attachment_id String UUID Attachment ID
transithub_multicast_association.subnet_id String UUID Subnet ID
transithub_multicast_association.domain_id String UUID Multicast Domain ID
Example
{
  "transithub_multicast_association": {
    "status": "ACTIVE",
    "attachment_id": "23fc5818-c667-4e90-b50b-70b9e8727f49",
    "description": "",
    "subnet_id": "4263b32d-4bc5-45cc-bb3e-fded960e8f46",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "created_at": "2024-03-07 00:22:59",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "id": "4da8461b-6c92-4225-8368-60e1e49e3d92",
    "updated_at": "2024-03-07 00:22:59",
    "domain_id": "d55022de-947f-4db3-a7b0-5a4cee9a2369"
  }
}

Delete Multicast Association

DELETE /v2.0/gateways/transithub_multicast_associations/{multicastAssociationId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
multicastAssociationId O UUID Response Multicast association ID

Response

Stops the specified node group.

Multicast Group

View multicast group

GET /v2.0/gateways/transithub_multicast_groups
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
id Query UUID - Multicast group ID to query
String Query Token ID - Multicast group name to query
domain_id Query UUID - Multicast group ID to query

Response

Format Description Description Header
transithub_multicast_groups String nodegroups.uuid Multicast group information objects
transithub_multicast_groups.id String UUID Multicast Group ID
transithub_multicast_groups.tenant_id String Token ID Tenant ID
transithub_multicast_groups.description String Token ID Multicast group description
transithub_multicast_groups.association_id String UUID Multicast association ID
transithub_multicast_groups.ipaddress String Token ID Multicast group IP address
transithub_multicast_groups.member_type String Token ID Multicast member type
transithub_multicast_groups.source_type String Token ID Multicast source type
transithub_multicast_groups.port_id String UUID Multicast destination port ID
Example
{
  "transithub_multicast_groups": [
    {
      "description": "",
      "updated_at": "2024-03-07 00:28:20",
      "member_type": "STATIC",
      "source_type": null,
      "port_id": "b0ca1c15-13e1-4746-b8e1-9ec8e685d228",
      "ipaddress": "224.0.0.3",
      "id": "ce8c5fef-6859-4e68-8b46-4cd395c44b37",
      "subnet_id": "4263b32d-4bc5-45cc-bb3e-fded960e8f46",
      "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "created_at": "2024-03-07 00:28:20",
      "domain_id": "27d79c71-ccce-4928-af3c-5ffa5c3ed3fd",
      "association_id": "b4ba8acd-34d2-48f9-b2f6-cbfe5e92d0f8",
      "project_id": "5fdb378e72ca4aff9db04f40f7955f0b"
    }
  ]
}

View Multicast Group

GET /v2.0/gateways/transithub_multicast_groups/{multicastGroupId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
multicastGroupId O UUID Response Multicast Group ID

Response

Format Description Description Header
transithub_multicast_group String Object Multicast group information object
transithub_multicast_group.id String UUID Multicast Group ID
transithub_multicast_group.tenant_id String Token ID Tenant ID
transithub_multicast_group.description String Token ID Multicast group description
transithub_multicast_group.association_id String UUID Multicast association ID
transithub_multicast_group.ipaddress String Token ID Multicast group IP address
transithub_multicast_group.member_type String Token ID Multicast member type
transithub_multicast_group.source_type String Token ID Multicast source type
transithub_multicast_group.port_id String UUID Multicast destination port ID
Example
{
  "transithub_multicast_group": {
    "description": "",
    "updated_at": "2024-03-07 00:28:20",
    "member_type": "STATIC",
    "source_type": null,
    "port_id": "b0ca1c15-13e1-4746-b8e1-9ec8e685d228",
    "ipaddress": "224.0.0.3",
    "id": "ce8c5fef-6859-4e68-8b46-4cd395c44b37",
    "subnet_id": "4263b32d-4bc5-45cc-bb3e-fded960e8f46",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "created_at": "2024-03-07 00:28:20",
    "domain_id": "27d79c71-ccce-4928-af3c-5ffa5c3ed3fd",
    "association_id": "b4ba8acd-34d2-48f9-b2f6-cbfe5e92d0f8",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b"
  }
}

Create Multicast Group

POST /v2.0/gateways/transithub_multicast_groups
X-Auth-Token: {tokenId}

Request

Format Description Description tokenId Header
String O Token ID Response Token ID
transithub_multicast_group String Object Response Multicast group information object
transithub_multicast_group.description String Token ID - Multicast group description
transithub_multicast_group.association_id String UUID Response Multicast association ID
transithub_multicast_group.ipaddress String Token ID Response Multicast group IP address
transithub_multicast_group.member_type String Token ID - Multicast member type, enter STATIC if used as a member
Must enter one of the member type and source type
transithub_multicast_group.source_type String Token ID - Multicast source type, enter STATIC if used as a source
Must enter one of the member type and source type
transithub_multicast_group.port_id String UUID Response Multicast destination port ID
Example
{
  "transithub_multicast_group": {
    "association_id": "b4ba8acd-34d2-48f9-b2f6-cbfe5e92d0f8",
    "port_id": "b0ca1c15-13e1-4746-b8e1-9ec8e685d228",
    "ipaddress": "224.0.0.10",
    "member_type": "STATIC"
  }
}

Response

Format Description Description Header
transithub_multicast_group String Object Multicast group information object
transithub_multicast_group.id String UUID Multicast Group ID
transithub_multicast_group.tenant_id String Token ID Tenant ID
transithub_multicast_group.description String Token ID Multicast group description
transithub_multicast_group.association_id String UUID Multicast association ID
transithub_multicast_group.ipaddress String Token ID Multicast group IP address
transithub_multicast_group.member_type String Token ID Multicast member type
transithub_multicast_group.source_type String Token ID Multicast source type
transithub_multicast_group.port_id String UUID Multicast destination port ID
Example
{
  "transithub_multicast_group": {
    "description": "",
    "association_id": "b4ba8acd-34d2-48f9-b2f6-cbfe5e92d0f8",
    "subnet_id": "4263b32d-4bc5-45cc-bb3e-fded960e8f46",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "created_at": "2024-03-07 00:40:19",
    "updated_at": "2024-03-07 00:40:19",
    "member_type": "STATIC",
    "domain_id": "27d79c71-ccce-4928-af3c-5ffa5c3ed3fd",
    "source_type": null,
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "ipaddress": "224.0.0.10",
    "id": "91b281f8-41ab-4d27-8639-da27b23d21db"
  }
}

Delete Multicast Group

DELETE /v2.0/gateways/transithub_multicast_groups/{multicastGroupId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
multicastGroupId O UUID Response Multicast Group ID

Response

Stops the specified node group.

Share Transit Hub

View Sharing Allowed List

GET /v2.0/gateways/transithub_allow_projects
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
id Query UUID - Sharing allowed information ID to query
transithub_id Query UUID - Transit hub ID to query

Response

Format Description Description Header
transithub_allow_projects String nodegroups.uuid Sharing allowed information list
transithub_allow_projects.id String UUID Sharing allowed information ID
transithub_allow_projects.tenant_id String Token ID Tenant ID
transithub_allow_projects.transithub_id String UUID Transit hub ID to share
transithub_allow_projects.transithub_name String Token ID Transit Hub Name
transithub_allow_projects.target_project_id String UUID Project ID to share with
Example
{
  "transithub_allow_projects": [
    {
      "target_project_id": "cd29a534a15e46049b968dd0835b129b",
      "description": "",
      "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "transithub_name": "thub1",
      "transithub_id": "efb688ea-15c2-4d36-b123-6044e3c37d8c",
      "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "id": "186717d3-8e26-40ec-ad00-67a8463ccc4c"
    }
  ]
}

Create sharing allowed information

POST /v2.0/gateways/transithub_allow_projects
X-Auth-Token: {tokenId}

Request

Format Description Description tokenId Header
String O Token ID Response Token ID
transithub_allow_project String Object Response Share sharing allowed information object
transithub_allow_project.transithub_id String UUID Response Transit hub ID to share
transithub_allow_project.target_project_id String UUID Response Project ID to share with
Example
{
  "transithub_allow_project": {
    "target_project_id": "cd29a534a15e46049b968dd0835b129b",
    "transithub_id": "efb688ea-15c2-4d36-b123-6044e3c37d8c"
  }
}

Response

Format Description Description Header
transithub_allow_project String Object Share sharing allowed information object
transithub_allow_project.id String UUID Sharing allowed information ID
transithub_allow_project.tenant_id String Token ID Tenant ID
transithub_allow_project.transithub_id String UUID Transit hub ID to share
transithub_allow_project.transithub_name String Token ID Transit Hub Name
transithub_allow_project.target_project_id String UUID Project ID to share with
Example
{
  "transithub_allow_project": {
    "target_project_id": "cd29a534a15e46049b968dd0835b129b",
    "description": "",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "transithub_name": "dj-thub1",
    "transithub_id": "efb688ea-15c2-4d36-b123-6044e3c37d8c",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "id": "3d962640-385f-4874-8766-aa1b4480e7e4"
  }
}

Delete Sharing Allowed Information

DELETE /v2.0/gateways/transithub_allow_projects/{allowProjectId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
allowProjectId O UUID Response Sharing allowed information ID

Response

Stops the specified node group.

View Shared List

GET /v2.0/gateways/transithub_shared_lists
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
transithub_id Query UUID - Transit hub ID to query

Response

Format Description Description Header
transithub_shared_lists String nodegroups.uuid Shared information list
transithub_shared_lists.id String UUID Shared Information ID
transithub_shared_lists.tenant_id String Token ID Tenant ID
transithub_shared_lists.transithub_id String UUID Shared Transit Hub ID
transithub_shared_lists.transithub_name String Token ID Shared transit hub name
transithub_shared_lists.transithub_project_id String UUID Project ID of the shared transit hub
Example
{
  "transithub_shared_lists": [
    {
      "description": "",
      "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "transithub_project_id": "1fb0cf13afb341b699f74bbbecab2117",
      "transithub_name": "thub",
      "transithub_id": "4050efd6-b6cc-4e2d-9402-dd5e1520872f",
      "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "id": "51c8fd9c-ae82-474f-9664-9fc31c77a563"
    }
  ]
}

Share Multicast Domain

View Sharing Allowed List

GET /v2.0/gateways/transithub_multicast_domain_allow_projects
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
id Query UUID - Sharing allowed information ID to query
domain_id Query UUID - Multicast domain ID to query

Response

Format Description Description Header
transithub_multicast_domain_allow_projects String nodegroups.uuid Sharing allowed information list
transithub_multicast_domain_allow_projects.id String UUID Sharing allowed information ID
transithub_multicast_domain_allow_projects.tenant_id String Token ID Tenant ID
transithub_multicast_domain_allow_projects.domain_id String UUID Multicast domain ID to share
transithub_multicast_domain_allow_projects.domain_name String Token ID Multicast domain name
transithub_multicast_domain_allow_projects.target_project_id String UUID Project ID to share with
Example
{
  "transithub_multicast_domain_allow_projects": [
    {
      "target_project_id": "cd29a534a15e46049b968dd0835b129b",
      "description": "",
      "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "domain_name": "domain1",
      "domain_id": "d55022de-947f-4db3-a7b0-5a4cee9a2369",
      "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "id": "186717d3-8e26-40ec-ad00-67a8463ccc4c"
    }
  ]
}

Create Sharing Allowed Information

POST /v2.0/gateways/transithub_multicast_domain_allow_projects
X-Auth-Token: {tokenId}

Request

Format Description Description tokenId Header
String O Token ID Response Token ID
transithub_multicast_domain_allow_project String Object Response Share sharing allowed information object
transithub_multicast_domain_allow_project.domain_id String UUID Response Multicast domain ID to share
transithub_multicast_domain_allow_project.target_project_id String UUID Response Project ID to share with
Example
{
  "transithub_multicast_domain_allow_project": {
    "target_project_id": "cd29a534a15e46049b968dd0835b129b",
    "domain_id": "efb688ea-15c2-4d36-b123-6044e3c37d8c"
  }
}

Response

Format Description Description Header
transithub_multicast_domain_allow_project String Object Share sharing allowed information object
transithub_multicast_domain_allow_project.id String UUID Sharing allowed information ID
transithub_multicast_domain_allow_project.tenant_id String Token ID Tenant ID
transithub_multicast_domain_allow_project.domain_id String UUID Multicast domain ID to share
transithub_multicast_domain_allow_project.domain_name String Token ID Multicast domain name
transithub_multicast_domain_allow_project.target_project_id String UUID Project ID to share with
Example
{
  "transithub_multicast_domain_allow_project": {
    "target_project_id": "cd29a534a15e46049b968dd0835b129b",
    "description": "",
    "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "domain_name": "domain1",
    "domain_id": "d55022de-947f-4db3-a7b0-5a4cee9a2369",
    "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
    "id": "3d962640-385f-4874-8766-aa1b4480e7e4"
  }
}

Delete Sharing Allowed Information

DELETE /v2.0/gateways/transithub_multicast_domain_allow_projects/{allowProjectId}
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
allowProjectId O UUID Response Sharing allowed information ID

Response

Stops the specified node group.

View Shared List

GET /v2.0/gateways/transithub_multicast_domain_shared_lists
X-Auth-Token: {tokenId}

Request

This API does not require a request body.

Format Description Description tokenId Header
String O Token ID Response Token ID
domain_id Query UUID - Multicast domain ID to query

Response

Format Type Description Header
transithub_multicast_domain_shared_lists String nodegroups.uuid Shared information list
transithub_multicast_domain_shared_lists.id String UUID Shared Information ID
transithub_multicast_domain_shared_lists.tenant_id String Token ID Tenant ID
transithub_multicast_domain_shared_lists.domain_id String UUID Shared multicast domain ID
transithub_multicast_domain_shared_lists.domain_name String Token ID Shared multicast domain name
transithub_multicast_domain_shared_lists.domain_project_id String UUID Project ID of the shared multicast domain
Example
{
  "transithub_multicast_domain_shared_lists": [
    {
      "description": "",
      "tenant_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "domain_project_id": "1fb0cf13afb341b699f74bbbecab2117",
      "domain_name": "domain1",
      "domain_id": "d55022de-947f-4db3-a7b0-5a4cee9a2369",
      "project_id": "5fdb378e72ca4aff9db04f40f7955f0b",
      "id": "51c8fd9c-ae82-474f-9664-9fc31c77a563"
    }
  ]
}
TOP