Create Allocation

View as Markdown

Create an Allocation for the org.

Org must have an Infrastructure Provider entity. User must have FORGE_PROVIDER_ADMIN role.

Tenant management of Allocation is not supported in MVP.

Authentication

AuthorizationBearer
``` export JWT_BEARER_TOKEN="<jwt-bearer-token>" # Example org name: "acme-inc export ORG_NAME=<org-name> # Use the JWT bearer token in your API request auth header: curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://carbide-rest-api.carbide.svc.cluster.local/v2/org/$ORG_NAME/carbide/user/current ```

Path parameters

orgstringRequired

Request

This endpoint expects an object.
namestringRequired2-256 characters
Concise and descriptive name for the Allocation
tenantIdstringRequiredformat: "uuid"
ID of the Tenant that should receive the Allocation
siteIdstringRequiredformat: "uuid"
ID of the Site where resources should be allocated
descriptionstringOptional
Detailed description for the Allocation
allocationConstraintslist of objectsOptional

Response

Created
idstringRead-onlyformat: "uuid"
ID of the Allocation
namestring2-256 characters
Concise and descriptive name of the Allocation
descriptionstring
Detailed description of the Allocation
infrastructureProviderIdstringformat: "uuid"
ID of the Infrastructure Provider that created the Allocation
tenantIdstringformat: "uuid"
ID of the Tenant that received the Allocation
siteIdstringformat: "uuid"
ID of the Site where resources are allocated
statusenum
Status values for Allocation objects
Allowed values:
statusHistorylist of objectsRead-only
allocationConstraintslist of objects
createddatetimeRead-only

Date/time when the Allocation was created

updateddatetimeRead-only

Date/time when the Allocation was last updated

Errors

400
Bad Request Error
403
Forbidden Error