Openportal Remote Allocations
Operations Summary
| Method | Endpoint | Description |
|---|---|---|
| Core CRUD | ||
| GET | /api/openportal-remote-allocations/ |
List Openportal Remote Allocations |
| GET | /api/openportal-remote-allocations/{uuid}/ |
Retrieve |
| POST | /api/openportal-remote-allocations/ |
Create |
| POST | /api/openportal-remote-allocations/{uuid}/pull/ |
Synchronize resource state |
| POST | /api/openportal-remote-allocations/{uuid}/unlink/ |
Unlink resource |
| PUT | /api/openportal-remote-allocations/{uuid}/ |
Update |
| PATCH | /api/openportal-remote-allocations/{uuid}/ |
Partial Update |
| DELETE | /api/openportal-remote-allocations/{uuid}/ |
Delete |
| Other Actions | ||
| POST | /api/openportal-remote-allocations/{uuid}/set_erred/ |
Mark resource as ERRED |
| POST | /api/openportal-remote-allocations/{uuid}/set_limits/ |
Set limits |
| POST | /api/openportal-remote-allocations/{uuid}/set_ok/ |
Mark resource as OK |
Core CRUD
List Openportal Remote Allocations
1 2 3 4 | |
1 2 3 4 5 6 7 8 9 10 11 12 | |
- Model Source:
CoreStates - Model Source:
RemoteAllocationFieldEnum - API Source:
openportal_remote_allocations_list
1 2 3 4 5 6 7 8 9 10 | |
| Name | Type | Description |
|---|---|---|
backend_id |
string | Backend ID |
can_manage |
boolean | Can manage |
customer |
string (uuid) | Customer UUID |
customer_abbreviation |
string | Customer abbreviation |
customer_name |
string | Customer name |
customer_native_name |
string | Customer native name |
customer_uuid |
string (uuid) | Customer UUID |
description |
string | Description |
external_ip |
string | External IP |
field |
array | |
is_active |
boolean | |
name |
string | Name |
name_exact |
string | Name (exact) |
page |
integer | A page number within the paginated result set. |
page_size |
integer | Number of results to return per page. |
project |
string (uuid) | Project UUID |
project_name |
string | Project name |
project_uuid |
string (uuid) | Project UUID |
service_settings_name |
string | Service settings name |
service_settings_uuid |
string (uuid) | Service settings UUID |
state |
array | State |
uuid |
string (uuid) | UUID |
200 -
The response body is an array of objects, where each object has the following structure:
| Field | Type | Description |
|---|---|---|
url |
string (uri) | |
uuid |
string (uuid) | |
name |
string | |
description |
string | |
service_name |
string | |
service_settings |
string (uri) | |
service_settings_uuid |
string (uuid) | |
service_settings_state |
string | |
service_settings_error_message |
string | |
project |
string (uri) | |
project_name |
string | |
project_uuid |
string (uuid) | |
customer |
string (uri) | |
customer_uuid |
string (uuid) | |
customer_name |
string | |
customer_native_name |
string | |
customer_abbreviation |
string | |
error_message |
string | |
error_traceback |
string | |
resource_type |
string | |
state |
any | |
created |
string (date-time) | |
modified |
string (date-time) | |
backend_id |
string | |
access_url |
string | |
node_limit |
integer (int64) | |
remote_project_identifier |
string | The identifier of the project in the remote OpenPortal instance. |
node_usage |
string (decimal) | |
is_active |
boolean | |
marketplace_offering_uuid |
string | |
marketplace_offering_name |
string | |
marketplace_offering_type |
string | |
marketplace_offering_plugin_options |
object (free-form) | |
marketplace_category_uuid |
string | |
marketplace_category_name |
string | |
marketplace_resource_uuid |
string | |
marketplace_plan_uuid |
string | |
marketplace_resource_state |
string | |
is_usage_based |
boolean | |
is_limit_based |
boolean |
Retrieve
1 2 3 4 | |
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
- Model Source:
RemoteAllocationFieldEnum - API Source:
openportal_remote_allocations_retrieve
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
| Name | Type | Required |
|---|---|---|
uuid |
string (uuid) | ✓ |
| Name | Type |
|---|---|
field |
array |
200 -
| Field | Type | Description |
|---|---|---|
url |
string (uri) | |
uuid |
string (uuid) | |
name |
string | |
description |
string | |
service_name |
string | |
service_settings |
string (uri) | |
service_settings_uuid |
string (uuid) | |
service_settings_state |
string | |
service_settings_error_message |
string | |
project |
string (uri) | |
project_name |
string | |
project_uuid |
string (uuid) | |
customer |
string (uri) | |
customer_uuid |
string (uuid) | |
customer_name |
string | |
customer_native_name |
string | |
customer_abbreviation |
string | |
error_message |
string | |
error_traceback |
string | |
resource_type |
string | |
state |
any | |
created |
string (date-time) | |
modified |
string (date-time) | |
backend_id |
string | |
access_url |
string | |
node_limit |
integer (int64) | |
remote_project_identifier |
string | The identifier of the project in the remote OpenPortal instance. |
node_usage |
string (decimal) | |
is_active |
boolean | |
marketplace_offering_uuid |
string | |
marketplace_offering_name |
string | |
marketplace_offering_type |
string | |
marketplace_offering_plugin_options |
object (free-form) | |
marketplace_category_uuid |
string | |
marketplace_category_name |
string | |
marketplace_resource_uuid |
string | |
marketplace_plan_uuid |
string | |
marketplace_resource_state |
string | |
is_usage_based |
boolean | |
is_limit_based |
boolean |
Create
1 2 3 4 5 6 7 | |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 | |
- Model Source:
RemoteAllocationRequest - API Source:
openportal_remote_allocations_create
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | |
| Field | Type | Required | Description |
|---|---|---|---|
name |
string | ✓ | |
description |
string | ||
service_settings |
string (uri) | ✓ | |
project |
string (uri) | ✓ | |
node_limit |
integer (int64) | ||
remote_project_identifier |
string | The identifier of the project in the remote OpenPortal instance. |
201 -
| Field | Type | Description |
|---|---|---|
url |
string (uri) | |
uuid |
string (uuid) | |
name |
string | |
description |
string | |
service_name |
string | |
service_settings |
string (uri) | |
service_settings_uuid |
string (uuid) | |
service_settings_state |
string | |
service_settings_error_message |
string | |
project |
string (uri) | |
project_name |
string | |
project_uuid |
string (uuid) | |
customer |
string (uri) | |
customer_uuid |
string (uuid) | |
customer_name |
string | |
customer_native_name |
string | |
customer_abbreviation |
string | |
error_message |
string | |
error_traceback |
string | |
resource_type |
string | |
state |
any | |
created |
string (date-time) | |
modified |
string (date-time) | |
backend_id |
string | |
access_url |
string | |
node_limit |
integer (int64) | |
remote_project_identifier |
string | The identifier of the project in the remote OpenPortal instance. |
node_usage |
string (decimal) | |
is_active |
boolean | |
marketplace_offering_uuid |
string | |
marketplace_offering_name |
string | |
marketplace_offering_type |
string | |
marketplace_offering_plugin_options |
object (free-form) | |
marketplace_category_uuid |
string | |
marketplace_category_name |
string | |
marketplace_resource_uuid |
string | |
marketplace_plan_uuid |
string | |
marketplace_resource_state |
string | |
is_usage_based |
boolean | |
is_limit_based |
boolean |
Synchronize resource state
Schedule an asynchronous pull operation to synchronize resource state from the backend. Returns 202 if the pull was scheduled successfully, or 409 if the pull operation is not implemented for this resource type.
1 2 3 4 | |
1 2 3 4 5 6 7 8 9 10 11 12 | |
- API Source:
openportal_remote_allocations_pull
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
| Name | Type | Required |
|---|---|---|
uuid |
string (uuid) | ✓ |
202 -
| Field | Type |
|---|---|
detail |
string |
409 -
| Field | Type |
|---|---|
detail |
string |
Unlink resource
Delete resource from the database without scheduling operations on backend and without checking current state of the resource. It is intended to be used for removing resource stuck in transitioning state.
1 2 3 4 | |
1 2 3 4 5 6 7 8 9 10 11 12 | |
- API Source:
openportal_remote_allocations_unlink
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
| Name | Type | Required |
|---|---|---|
uuid |
string (uuid) | ✓ |
204 - No response body
Update
1 2 3 4 5 6 7 | |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | |
- Model Source:
RemoteAllocationRequest - API Source:
openportal_remote_allocations_update
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | |
| Name | Type | Required |
|---|---|---|
uuid |
string (uuid) | ✓ |
| Field | Type | Required | Description |
|---|---|---|---|
name |
string | ✓ | |
description |
string | ||
service_settings |
string (uri) | ✓ | |
project |
string (uri) | ✓ | |
node_limit |
integer (int64) | ||
remote_project_identifier |
string | The identifier of the project in the remote OpenPortal instance. |
200 -
| Field | Type | Description |
|---|---|---|
url |
string (uri) | |
uuid |
string (uuid) | |
name |
string | |
description |
string | |
service_name |
string | |
service_settings |
string (uri) | |
service_settings_uuid |
string (uuid) | |
service_settings_state |
string | |
service_settings_error_message |
string | |
project |
string (uri) | |
project_name |
string | |
project_uuid |
string (uuid) | |
customer |
string (uri) | |
customer_uuid |
string (uuid) | |
customer_name |
string | |
customer_native_name |
string | |
customer_abbreviation |
string | |
error_message |
string | |
error_traceback |
string | |
resource_type |
string | |
state |
any | |
created |
string (date-time) | |
modified |
string (date-time) | |
backend_id |
string | |
access_url |
string | |
node_limit |
integer (int64) | |
remote_project_identifier |
string | The identifier of the project in the remote OpenPortal instance. |
node_usage |
string (decimal) | |
is_active |
boolean | |
marketplace_offering_uuid |
string | |
marketplace_offering_name |
string | |
marketplace_offering_type |
string | |
marketplace_offering_plugin_options |
object (free-form) | |
marketplace_category_uuid |
string | |
marketplace_category_name |
string | |
marketplace_resource_uuid |
string | |
marketplace_plan_uuid |
string | |
marketplace_resource_state |
string | |
is_usage_based |
boolean | |
is_limit_based |
boolean |
Partial Update
1 2 3 4 | |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | |
- Model Source:
PatchedRemoteAllocationRequest - API Source:
openportal_remote_allocations_partial_update
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
| Name | Type | Required |
|---|---|---|
uuid |
string (uuid) | ✓ |
| Field | Type | Required | Description |
|---|---|---|---|
name |
string | ||
description |
string | ||
node_limit |
integer (int64) | ||
remote_project_identifier |
string | The identifier of the project in the remote OpenPortal instance. |
200 -
| Field | Type | Description |
|---|---|---|
url |
string (uri) | |
uuid |
string (uuid) | |
name |
string | |
description |
string | |
service_name |
string | |
service_settings |
string (uri) | |
service_settings_uuid |
string (uuid) | |
service_settings_state |
string | |
service_settings_error_message |
string | |
project |
string (uri) | |
project_name |
string | |
project_uuid |
string (uuid) | |
customer |
string (uri) | |
customer_uuid |
string (uuid) | |
customer_name |
string | |
customer_native_name |
string | |
customer_abbreviation |
string | |
error_message |
string | |
error_traceback |
string | |
resource_type |
string | |
state |
any | |
created |
string (date-time) | |
modified |
string (date-time) | |
backend_id |
string | |
access_url |
string | |
node_limit |
integer (int64) | |
remote_project_identifier |
string | The identifier of the project in the remote OpenPortal instance. |
node_usage |
string (decimal) | |
is_active |
boolean | |
marketplace_offering_uuid |
string | |
marketplace_offering_name |
string | |
marketplace_offering_type |
string | |
marketplace_offering_plugin_options |
object (free-form) | |
marketplace_category_uuid |
string | |
marketplace_category_name |
string | |
marketplace_resource_uuid |
string | |
marketplace_plan_uuid |
string | |
marketplace_resource_state |
string | |
is_usage_based |
boolean | |
is_limit_based |
boolean |
Delete
1 2 3 4 | |
1 2 3 4 5 6 7 8 9 10 11 12 | |
- API Source:
openportal_remote_allocations_destroy
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
| Name | Type | Required |
|---|---|---|
uuid |
string (uuid) | ✓ |
204 - No response body
Other Actions
Mark resource as ERRED
Manually transition the resource to ERRED state. This is useful for resources stuck in transitional states (CREATING, UPDATING, DELETING) that cannot be synced via pull. Staff-only operation.
1 2 3 4 | |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | |
- Model Source:
SetErredRequest - API Source:
openportal_remote_allocations_set_erred
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
| Name | Type | Required |
|---|---|---|
uuid |
string (uuid) | ✓ |
| Field | Type | Required |
|---|---|---|
error_message |
string | |
error_traceback |
string |
200 -
| Field | Type |
|---|---|
detail |
string |
Set limits
1 2 3 4 5 | |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | |
- Model Source:
RemoteAllocationSetLimitsRequest - API Source:
openportal_remote_allocations_set_limits
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | |
| Name | Type | Required |
|---|---|---|
uuid |
string (uuid) | ✓ |
| Field | Type | Required |
|---|---|---|
node_limit |
integer | ✓ |
200 -
| Field | Type |
|---|---|
node_limit |
integer |
Mark resource as OK
Manually transition the resource to OK state and clear error fields. Staff-only operation.
1 2 3 4 | |
1 2 3 4 5 6 7 8 9 10 11 12 | |
- API Source:
openportal_remote_allocations_set_ok
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
| Name | Type | Required |
|---|---|---|
uuid |
string (uuid) | ✓ |
200 -
| Field | Type |
|---|---|
detail |
string |