Private Wireless Gateways

Private Wireless Gateways operations

Create a Private Wireless Gateway

Asynchronously create a Private Wireless Gateway for SIM cards for a previously created network.

SecuritybearerAuth
Request
Request Body schema: application/json
required
network_id
required
string <uuid>

The identification of the related network resource.

name
required
string

The private wireless gateway name.

Responses
202

Successful response

Response Schema: application/json
object (PrivateWirelessGateway)
id
string <uuid>

Identifies the resource.

network_id
string <uuid>

The identification of the related network resource.

record_type
string
created_at
string

ISO 8601 formatted date-time indicating when the resource was created.

updated_at
string

ISO 8601 formatted date-time indicating when the resource was updated.

name
string

The private wireless gateway name.

region_code
string
Default: "ashburn-va"

The geographical region where the Private Wireless Gateway is deployed to.

object (PrivateWirelessGatewayStatus)

The current status or failure details of the Private Wireless Gateway.

ip_range
string
Default: null

IP block used to assign IPs to the SIM cards in the Private Wireless Gateway.

Array of objects (PWGAssignedResourcesSummary)

A list of the resources that have been assigned to the Private Wireless Gateway

422

Unprocessable entity. Check the 'detail' field in response for details.

Response Schema: application/json
Array of objects (Error)
Array
code
required
string <int>
title
required
string
detail
string
object
meta
object
default

Unexpected error

Response Schema: application/json
Array of objects (Error)
Array
code
required
string <int>
title
required
string
detail
string
object
meta
object
post/private_wireless_gateways
Request samples
application/json
{
  • "network_id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
  • "name": "My private wireless gateway"
}
Response samples
application/json
{
  • "data": {
    • "id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
    • "network_id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
    • "record_type": "private_wireless_gateway",
    • "created_at": "2018-02-02T22:25:27.521Z",
    • "updated_at": "2018-02-02T22:25:27.521Z",
    • "name": "My private wireless gateway",
    • "region_code": "ashburn-va",
    • "status": {
      • "value": "provisioned",
      • "error_description": null,
      • "error_code": null
      },
    • "ip_range": "100.64.1.0/24",
    • "assigned_resources": [
      • {
        • "record_type": "sim_card_group",
        • "count": 1
        }
      ]
    }
}

Get all Private Wireless Gateways

Get all Private Wireless Gateways belonging to the user.

SecuritybearerAuth
Request
query Parameters
page[number]
integer >= 1
Default: 1

The page number to load

page[size]
integer [ 1 .. 250 ]
Default: 20

The size of the page

filter[name]
string

The name of the Private Wireless Gateway.

Example: filter[name]=my private gateway
filter[ip_range]
string

The IP address range of the Private Wireless Gateway.

Example: filter[ip_range]=192.168.0.0/24
filter[region_code]
string

The name of the region where the Private Wireless Gateway is deployed.

Example: filter[region_code]=ashburn-va
filter[created_at]
string

Private Wireless Gateway resource creation date.

Example: filter[created_at]=2018-02-02T22:25:27.521Z
filter[updated_at]
string

When the Private Wireless Gateway was last updated.

Example: filter[updated_at]=2018-02-02T22:25:27.521Z
Responses
200

Successful response

Response Schema: application/json
Array of objects (PrivateWirelessGateway)
object (PaginationMeta)
default

Unexpected error

Response Schema: application/json
Array of objects (Error)
Array
code
required
string <int>
title
required
string
detail
string
object
meta
object
get/private_wireless_gateways
Request samples 
Response samples 
application/json
{
  • "data": [
    • {
      • "id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
      • "network_id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
      • "record_type": "private_wireless_gateway",
      • "created_at": "2018-02-02T22:25:27.521Z",
      • "updated_at": "2018-02-02T22:25:27.521Z",
      • "name": "My private wireless gateway",
      • "region_code": "ashburn-va",
      • "status": {
        • "value": "provisioned",
        • "error_description": null,
        • "error_code": null
        },
      • "ip_range": "100.64.1.0/24",
      • "assigned_resources": [
        • {
          • "record_type": "sim_card_group",
          • "count": 1
          }
        ]
      }
    ],
  • "meta": {
    • "total_pages": 3,
    • "total_results": 55,
    • "page_number": 2,
    • "page_size": 25
    }
}
Get a Private Wireless Gateway
Retrieve information about a Private Wireless Gateway.


SecuritybearerAuth 
Request 
path Parameters
id
required
string <uuid> 
Identifies the resource.


 
 Example:  6a09cdc3-8948-47f0-aa62-74ac943d6c58
Responses 
200
Successful response


Response Schema: application/json
object (PrivateWirelessGateway) 
 
id
string <uuid> 
Identifies the resource.


 
network_id
string <uuid> 
The identification of the related network resource.


 
record_type
string
 
created_at
string
ISO 8601 formatted date-time indicating when the resource was created.


 
updated_at
string
ISO 8601 formatted date-time indicating when the resource was updated.


 
name
string
The private wireless gateway name.


 
region_code
string
 Default:  "ashburn-va"
The geographical region where the Private Wireless Gateway is deployed to.


 
object (PrivateWirelessGatewayStatus) 
The current status or failure details of the Private Wireless Gateway.


 
ip_range
string
 Default:  null
IP block used to assign IPs to the SIM cards in the Private Wireless Gateway.


 
Array of objects (PWGAssignedResourcesSummary) 
A list of the resources that have been assigned to the Private Wireless Gateway


 
404
Resource not found


Response Schema: application/json
code
required
string <int> 
 
title
required
string
 
detail
string
 
object
 
meta
object
 
default
Unexpected error


Response Schema: application/json
Array of objects (Error) 
 
 Array 
code
required
string <int> 
 
title
required
string
 
detail
string
 
object
 
meta
object
 
get/private_wireless_gateways/{id}
Request samples 
Response samples 
application/json
{
  • "data": {
    • "id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
    • "network_id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
    • "record_type": "private_wireless_gateway",
    • "created_at": "2018-02-02T22:25:27.521Z",
    • "updated_at": "2018-02-02T22:25:27.521Z",
    • "name": "My private wireless gateway",
    • "region_code": "ashburn-va",
    • "status": {
      • "value": "provisioned",
      • "error_description": null,
      • "error_code": null
      },
    • "ip_range": "100.64.1.0/24",
    • "assigned_resources": [
      • {
        • "record_type": "sim_card_group",
        • "count": 1
        }
      ]
    }
}
Delete a Private Wireless Gateway
Deletes the Private Wireless Gateway.


SecuritybearerAuth 
Request 
path Parameters
id
required
string <uuid> 
Identifies the resource.


 
 Example:  6a09cdc3-8948-47f0-aa62-74ac943d6c58
Responses 
200
Successful response


Response Schema: application/json
object (PrivateWirelessGateway) 
 
id
string <uuid> 
Identifies the resource.


 
network_id
string <uuid> 
The identification of the related network resource.


 
record_type
string
 
created_at
string
ISO 8601 formatted date-time indicating when the resource was created.


 
updated_at
string
ISO 8601 formatted date-time indicating when the resource was updated.


 
name
string
The private wireless gateway name.


 
region_code
string
 Default:  "ashburn-va"
The geographical region where the Private Wireless Gateway is deployed to.


 
object (PrivateWirelessGatewayStatus) 
The current status or failure details of the Private Wireless Gateway.


 
ip_range
string
 Default:  null
IP block used to assign IPs to the SIM cards in the Private Wireless Gateway.


 
Array of objects (PWGAssignedResourcesSummary) 
A list of the resources that have been assigned to the Private Wireless Gateway


 
404
Resource not found


Response Schema: application/json
code
required
string <int> 
 
title
required
string
 
detail
string
 
object
 
meta
object
 
default
Unexpected error


Response Schema: application/json
Array of objects (Error) 
 
 Array 
code
required
string <int> 
 
title
required
string
 
detail
string
 
object
 
meta
object
 
delete/private_wireless_gateways/{id}
Request samples 
Response samples 
application/json
{
  • "data": {
    • "id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
    • "network_id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
    • "record_type": "private_wireless_gateway",
    • "created_at": "2018-02-02T22:25:27.521Z",
    • "updated_at": "2018-02-02T22:25:27.521Z",
    • "name": "My private wireless gateway",
    • "region_code": "ashburn-va",
    • "status": {
      • "value": "provisioned",
      • "error_description": null,
      • "error_code": null
      },
    • "ip_range": "100.64.1.0/24",
    • "assigned_resources": [
      • {
        • "record_type": "sim_card_group",
        • "count": 1
        }
      ]
    }
}