Work In Progress!
These docs are still work in progress and will be made available soon!
The following sections illustrate the REST APIs that are used in Apache Stratos 4.1.0:
It is recommended to save the request in a separate file. Thereafter, the path of the request file should be referred to in the REST API command.
For example:
-d @'<PATH-TO-test.json
>'
Entity | HTTP | Resource Path | Description |
---|---|---|---|
User | POST | /user | Add user. |
PUT | /user | Update user. | |
GET | /user | List users. | |
DELETE | /user/<USERNAME> | Delete user. | |
Tenant | POST | Add a tenant. | |
PUT | /tenant | Update a tenant. | |
POST | /tenant/activate/<TENANT_DOMAIN> | Activate a tenant. | |
POST | /tenant/deactivate/<TENANT_DOMAIN> | Deactivate a tenant. | |
GET | /tenant/<TENANT_DOMAIN> | Retrieve tenant details. | |
GET | /tenant/search/<TENANT_DOMAIN> | Search for tenants. | |
GET | List all the tenants. | ||
DELETE | /tenant/<TENANT_DOMAIN> | Delete a tenant. | |
Partition
| POST | Deploy a partition. | |
GET | Retrieve details on all the partitions. | ||
GET | /partitions/{partitionId} | Retrieve the details of a partition. | |
Auto-scaling policy | POST | Deploy an auto-scaling policy. | |
GET | /autoscalePolicies | Retrieve all auto-scaling policy details. | |
GET | Retrieve details of an auto-scaling policy. | ||
Deployment policy | POST | Deploy a deployment policy. | |
PUT | Update a deployment policy. | ||
GET | Retrieve details on all the deployment policies. | ||
GET | /deploymentPolicies/{deploymentPolicyId} | Retrieve details of a specific deployment policy. | |
Partition groups | GET | /deploymentPolicies/{deploymentPolicyId}/partition | Retrieve details of partitions in a specific deployment policy. |
GET | /deploymentPolicies/{deploymentPolicyId}/partitionGroup | Retrieve details of partition groups in a specific deployment policy. | |
GET | /deploymentPolicies/{deploymentPolicyId}/partitionGroup/{partitionGroupId} | Retrieve details on a specific partition group that has been defined in a deployment policy. | |
Cartridge | POST | Deploy a cartridge. | |
GET | /cartridges | List all the available cartridges (single tenant and multi-tenant). | |
GET | /cartridges/singleTenant | List all the available single tenant cartridges. | |
GET | /cartridges/{cartridgeType}/singleTenant | Retrieve available single tenant cartridge details. | |
GET | /cartridges/multiTenant | List all the available multi-tenant cartridges. | |
GET | /cartridges/loadBalancer | Retrieve the list of available load balancer cartridges. | |
GET | Retrieve details on all the deployment policies that have been defined in a specific cartridge. | ||
DELETE | /cartridges/{cartridgeType} | Undeploy a cartridge. | |
Cluster | /cluster/clusterId/<CLUSTER_ID> | Retrieve cluster details of a specific cluster. | |
GitHub | Set a Webhook in GitHub. | ||
/cartridge/sync | Synchronize the GIT repository for subscribed cartridges. | ||
Service group | /group/definition | Deploy a service group. | |
/group/definition/<GROUP_DEFINITION_NAME> | Listing details of a service group. | ||
/group | Listing all service groups. | ||
/group/definition/<GROUP_DEFINITION_NAME> | Undeploy a service group. | ||
Application | /application/definition | Deploy an application. | |
/application/definition/<APP_ID> | Undeploy an application. | ||
Subscription | GET | /subscriptions/cartridges | Retrieve list of all subscribed cartridges. |
GET | /subscriptions/cartridges/groups/{serviceGroup} | List of subscribed cartridges for a specific service group. | |
GET | /subscriptions/{subscriptionAlias}/cartridges | Retrieve details on a specific subscribed cartridge. | |
GET | /subscriptions/{subscriptionAlias}/cartridges/{cartridgeType}/active | Retrieve the active member count of a subscribed cartridge. | |
POST | Add subscription domains. | ||
GET | /subscriptions/{subscriptionAlias}/domains | Retrieve details on subscription domains. | |
GET | /subscriptions/{subscriptionAlias}/domains/{domainName} | Retrieve details on a subscription domain. | |
DELETE | /subscriptions/{subscriptionAlias}/domains/{domainName} | Remove a subscription domain. |