Search
K
Cipherscale API

List Network Resources

Retrieves a paginated list of all network resources for the tenant with advanced filtering and sorting capabilities. Supports filtering by resource type, gateway associations, protocols, and other criteria to help manage complex network topologies.

get
https://public-api.cipherscale.com/qa/tenants/resources

Query Parameters

sortstring

Sort order in format “field:direction”. Sortable fields: id, name. Direction: asc, desc

Example:-name

limitnumber
offsetnumber
filter[policies.id]string

Filter resources by policy ID (UUID format)

Example:123e4567-e89b-12d3-a456-426614174000

filter[gateways.id]string

Filter resources by gateway ID (UUID format)

Example:123e4567-e89b-12d3-a456-426614174000

filter[addresses.protocols.id]string

Filter resources by protocol ID in addresses (UUID format)

Example:123e4567-e89b-12d3-a456-426614174000

filter[type]string

Filter resources by type

Allowed values:PRIVATESAASINTERNET

filter[name]string

Filter resources by name

Example:Resource Name

filter[id]string

Filter resources by ID (UUID format)

Example:123e4567-e89b-12d3-a456-426614174000

page[offset]number

Number of resources to skip (minimum: 0)

Example:0

page[limit]number

Number of resources to return per page (minimum: 1)

Example:10

Response

application/json

Successfully retrieved resources

PaginatedDto

PaginatedDtoobject
get/tenants/resources
 
application/json

Update Network Resource

Modifies the configuration of an existing network resource including its name, description, and other properties. Changes may affect access policies and user permissions.

patch
https://public-api.cipherscale.com/qa/tenants/resources/{id}

Path Parameters

idstring(uuid)required

The unique identifier (UUID) of the resource to update

Body

application/json

UpdateResourceDto

namestringrequired
descriptionstring

Response

Successfully updated the resource

patch/tenants/resources/{id}

Body

{ "name": "name" }
 

Get Resource Details

Retrieves comprehensive information about a specific network resource including its configuration, associated addresses, protocols, gateway connections, and load balancing settings.

get
https://public-api.cipherscale.com/qa/tenants/resources/{id}

Path Parameters

idstring(uuid)required

The unique identifier (UUID) of the resource

Response

application/json

Successfully retrieved the resource

ResourceDto

idstring(uuid)required
createdAtstring(date-time)required
updatedAtstring(date-time)required
namestringrequired
typestringrequired

Allowed values:PRIVATESAASINTERNET

loadBalancingModestringrequired

Allowed values:MANUALAUTOMATIC

Default:MANUAL

statusstring

Allowed values:ONLINEOFFLINE

descriptionstring
addressesarray[object]required
Show Child Parameters
gatewaysarray[object]required

Network gateway configuration and status information

Show Child Parameters
get/tenants/resources/{id}
 
application/json

Remove Network Resource

Permanently removes a network resource from the tenant. The resource must not be linked to any active policies before deletion. This operation will also disconnect all associated gateway connections.

delete
https://public-api.cipherscale.com/qa/tenants/resources/{id}

Path Parameters

idstring(uuid)required

The unique identifier (UUID) of the resource to delete

Response

Successfully deleted the resource

delete/tenants/resources/{id}
 

Configure Resource Load Balancing

Configures load balancing settings for a resource, determining how traffic is distributed across multiple gateways. Supports both manual gateway selection and automatic load balancing algorithms.

post
https://public-api.cipherscale.com/qa/tenants/resources/{id}/loadBalancing

Path Parameters

idstring(uuid)required

The unique identifier (UUID) of the resource

Body

application/json

ApplyLoadBalancingDto

loadBalancingModestringrequired

Allowed values:MANUALAUTOMATIC

Default:MANUAL

gatewaysarray[string]required

Response

Successfully applied load balancing configuration

post/tenants/resources/{id}/loadBalancing

Body

{ "loadBalancingMode": "MANUAL", "gateways": [ "[]" ] }