How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Scalr Farms API

The Farms API from Scalr — 16 operation(s) for farms.

Scalr Farms API is one of 26 APIs that Scalr publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Farms. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 26 operations across 16 paths, and defines 163 schemas. It is described by OpenAPI 2.0, at version 1.0.0.

26 operations 16 paths 163 schemas 3 DELETE9 GET3 PATCH11 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
1.0.0
Resource Areas
1

Paths & Operations 26

Across 16 paths, the API surfaces 26 operations — 3 DELETE, 9 GET, 3 PATCH, 11 POST. Each is listed below with its method, path, parameters, and response codes.

Farms 26
GET
/{envId}/farms/
List all the Farms available in this Environment.
1 param → 200400401403404409422500
POST
/{envId}/farms/
Create a new Farm in this Environment. Farm and FarmTemplate objects are acceptable.
2 params → 201400401403404409422500
DELETE
/{envId}/farms/{farmId}/
Delete a Farm from this Environment.
2 params → 204400401403404409422500
GET
/{envId}/farms/{farmId}/
Retrieve detailed information about a given Farm.
2 params → 200400401403404409422500
PATCH
/{envId}/farms/{farmId}/
Modify the attributes of a Farm.
3 params → 200400401403404409422500
POST
/{envId}/farms/{farmId}/actions/clone/
Clone a given Farm.
3 params → 201400401403404409422500
GET
/{envId}/farms/{farmId}/actions/generate-template/
Get Farm Template body for given Farm.
2 params → 200400401403404409422500
POST
/{envId}/farms/{farmId}/actions/launch/
Launch a Farm.
2 params → 200400401403404409422500
POST
/{envId}/farms/{farmId}/actions/lock/
Lock a Farm.
3 params → 200400401403404409422500
POST
/{envId}/farms/{farmId}/actions/resume/
Resume a suspended Farm.
2 params → 200400401403404409422500
POST
/{envId}/farms/{farmId}/actions/suspend/
Suspend a Farm.
2 params → 200400401403404409422500
POST
/{envId}/farms/{farmId}/actions/terminate/
Terminate a Farm.
3 params → 200400401403404409422500
POST
/{envId}/farms/{farmId}/actions/unlock/
Unlock a Farm.
2 params → 200400401403404409422500
GET
/{envId}/farms/{farmId}/cloud-services/
List of the Cloud Services linked to the current Farm.
2 params → 200400401403404409422500
POST
/{envId}/farms/{farmId}/cloud-services/
Link Cloud Service to the current Farm.
3 params → 201400401403404409422500
DELETE
/{envId}/farms/{farmId}/cloud-services/{farmCloudServiceLinkId}/
Unlink Cloud Service from the current Farm.
3 params → 204400401403404409422500
GET
/{envId}/farms/{farmId}/cloud-services/{farmCloudServiceLinkId}/
Retrieve detailed information about linked Cloud Service to the current Farm.
3 params → 200400401403404409422500
PATCH
/{envId}/farms/{farmId}/cloud-services/{farmCloudServiceLinkId}/
Modify Cloud Service attributes.
4 params → 200400401403404409422500
GET
/{envId}/farms/{farmId}/farm-roles/
List all the Farm Roles in a Farm.
2 params → 200400401403404409422500
POST
/{envId}/farms/{farmId}/farm-roles/
Create a new Farm Role in a Farm. FarmRole and FarmRoleTemplate objects are acceptable.
3 params → 201400401403404409422500
GET
/{envId}/farms/{farmId}/global-variables/
List all Global Variables associated to a Farm.
2 params → 200400401403404409422500
POST
/{envId}/farms/{farmId}/global-variables/
Declare a new Global Variable for this Farm.
3 params → 201400401403404409422500
DELETE
/{envId}/farms/{farmId}/global-variables/{globalVariableName}/
Delete a Global Variable from a given Farm's scope.
3 params → 204400401403404409422500
GET
/{envId}/farms/{farmId}/global-variables/{globalVariableName}/
Retrieve detailed information about a Global Variable in the Farm's scope
3 params → 200400401403404409422500
PATCH
/{envId}/farms/{farmId}/global-variables/{globalVariableName}/
Modify the attributes of a Global Variable's in the Farm's scope.
4 params → 200400401403404409422500
GET
/{envId}/farms/{farmId}/servers/
List all the Servers associated to a Farm.
2 params → 200400401403404409422500

Schemas 163

The contract defines 163 schemas that model the data the API accepts and returns. The most detailed are ServerSummary (19 properties), FarmRoleTemplate (16 properties), FarmRole (15 properties), ChefServerBootstrapConfiguration (14 properties). Each schema is shown below with its type and property counts.

OrchestrationRuleCondition
object
1 property 1 required
AwsCloudFrontDistributionLink
object
5 properties 2 required
FarmForeignKey
object
1 property 1 required
OsCondition
object
2 properties 2 required
ScriptVariableRemoteList
object
9 properties 3 required
FarmRoleForeignKey
object
1 property 1 required
TriggeringServerTarget
object
Select only the Server that triggered the Event.
2 properties 1 required
VmwareStorageTemplateCloudFeatures
object
Cloud specifics template configuration.
4 properties 1 required
ComposedUserIdentity
object
2 properties 1 required
GlobalVariableList
object
12 properties 3 required
SqsQueueSizeScalingRule
object
It is used in combination with the user defined Scaling Metrics.
5 properties 5 required
FarmRoleIdentity
object
2 properties 1 required
HostnameConfiguration
object
Farm Role hostname configuration.
2 properties 1 required
FarmTemplateContent
object
10 properties 2 required
FarmLightsOutConfiguration
object
LightsOut configuration for a Farm.
5 properties 3 required
NetworkCloudFeatures
object
Cloud specifics Farm Role Network configuration.
1 property 1 required
CloudFeatures
object
Cloud specifics Farm Role configuration.
1 property 1 required
ScriptVariable
object
8 properties 2 required
TemplateHostnameConfiguration
object
Template for hostname generation.
3 properties 1 required
UrlResponseTimeScalingRule
object
It is used in combination with the user defined Scaling Metrics.
5 properties 5 required
FarmRoleAnsibleTowerConfiguration
object
4 properties
PersistentStorageConfiguration
object
6 properties 2 required
ChefServerBootstrapConfiguration
object
Farm Role Chef server configuration. Please note that almost all properties are read-only if Chef is configured at higher scope and it is only possible to over…
14 properties 2 required
TriggeringFarmRoleTarget
object
Selects all the Servers that belong to the same Farm Role as the Server that triggered the Event.
1 property 1 required
TargetGroupLink
object
2 properties 1 required
CloudNetworkForeignKey
object
1 property 1 required
GlobalVariableRemoteList
object
12 properties 3 required
FarmTemplateDetailsResponse
object
4 properties
GlobalVariableString
object
13 properties 2 required
SecurityGroupIdentity
object
2 properties 1 required
Target
object
1 property 1 required
FarmTemplate
object
3 properties
FarmLockOptions
object
3 properties
RemoteScriptAction
object
2 properties 2 required
AwsEmrClusterLink
object
5 properties 2 required
ScalingTemplateContent
object
6 properties
LightsOutTimeFrame
object
Time frame for the LightsOut schedule.
3 properties 1 required
AwsCloudFeatures
object
AWS Farm Role configuration. Available only for AWS Farm Roles.
5 properties 1 required
LightsOutNotification
object
2 properties 2 required
MountConfiguration
object
4 properties
RoleCategory
object
3 properties 1 required
Action
object
1 property 1 required
AwsEfsLink
object
5 properties 2 required
ApiPagination
object
4 properties
ChefServerForeignKey
object
1 property 1 required
RoleDeprecatedOptions
object
2 properties
AwsS3BucketLink
object
5 properties 2 required
AwsSpotInstanceConfiguration
object
EC2 Spot instance configuration.
2 properties 1 required
FarmCloudServiceLink
object
5 properties 2 required
CloudSubnetForeignKey
object
1 property 1 required
ApplicationGroupForeignKey
object
1 property 1 required
WebhookEndpoint
object
Webhook endpoint summary.
3 properties
ServerAlert
object
Alerts about server state
4 properties 3 required
VmwareCloudFeatures
object
VMware Farm Role configuration. Required for VMware Farm Roles.
8 properties 2 required
ScalingConfiguration
object
6 properties
ServerSummary
object
A Scalr Server.
19 properties
FarmRolesCondition
object
2 properties 1 required
AwsRdsClusterLink
object
5 properties 2 required
SecurityConfiguration
object
1 property 1 required
NetworkConfiguration
object
Farm Role network configuration.
3 properties
AwsRdsInstanceLink
object
5 properties 2 required
IpPoolForeignKey
object
1 property 1 required
TargetFarmRoleIdentity
object
2 properties 1 required
ScalrAgent
object
The information about Scalr Agent.
4 properties
LightsOutEmailNotification
object
3 properties 3 required
InstanceType
object
6 properties
InstanceTypeForeignKey
object
1 property 1 required
ReachabilityStatus
object
2 properties
FarmListResponse
object
5 properties
StorageTemplateCloudFeatures
object
Cloud specifics template configuration.
1 property 1 required
ChefAction
object
1 property 1 required
FarmDetailsResponse
object
4 properties
FarmCloudServiceLinkListResponse
object
5 properties
ScalingRuleTimeFrame
object
4 properties 4 required
RoleForeignKey
object
1 property 1 required
CloudSubnet
object
2 properties 1 required
FarmTemplateContentLockOptions
object
2 properties 1 required
EphemeralStorageTemplate
object
Storage Template configuration.
2 properties
ScriptVersionIdentity
object
3 properties
EventForeignKey
object
1 property 1 required
InstanceTypeCloudFeatures
object
Cloud specific Instance type configuration.
1 property 1 required
UserForeignKey
object
1 property 1 required
AnsibleTowerAction
object
4 properties 3 required
FarmTarget
object
Selects all the Servers that belong to the triggering Server's Farm.
2 properties 1 required
AllEventsTrigger
object
Triggers when any Event fires.
1 property 1 required
ComposedTeamIdentity
object
2 properties 1 required
Trigger
object
1 property 1 required
DateAndTimeScalingRule
object
This Scaling Rule defines the number of instances that should be running during specified time frames.
3 properties 3 required
IpAddressConfiguration
object
The Farm Role network ip configuration
3 properties
LocalScriptAction
object
2 properties 2 required
Role
object
12 properties 3 required
AwsStorageTemplateCloudFeatures
object
Cloud specifics template configuration.
4 properties 1 required
OrchestrationRuleTemplateContent
object
8 properties
ServerSummaryListResponse
object
5 properties
BandWidthScalingRule
object
It is used in combination with the user defined Scaling Metrics.
5 properties 5 required
ServerOperations
object
List of the temporary operations being processed in the Cloud Server by one or a number of requests.
1 property 1 required
FarmRoleTemplate
object
16 properties
OsForeignKey
object
1 property 1 required
ScalrScriptAction
object
2 properties 2 required
OpenstackNetworkCloudFeatures
object
Cloud specifics Farm Role Network configuration.
2 properties 1 required
ChefBootstrapConfiguration
object
Farm Role bootstrap configuration. Please note that this configuration is available only for Roles configured with Chef built-in automation.
6 properties 1 required
GceCloudFeatures
object
GCE Farm Role configuration. Available only for GCE Farm Roles.
3 properties 1 required
ChefSoloBootstrapConfiguration
object
Farm Role Chef server configuration. Please note that almost all properties are read-only if Chef is configured at higher scope and it is only possible to over…
10 properties 2 required
GlobalVariableJson
object
11 properties 2 required
AzureNetworkCloudFeatures
object
Cloud specifics Farm Role Network configuration.
2 properties 1 required
GlobalVariableListResponse
object
5 properties
EphemeralStorageConfiguration
object
4 properties 2 required
FarmRoleDetailsResponse
object
4 properties
LoadAveragesScalingRule
object
It is used in combination with the user defined Scaling Metrics.
5 properties 5 required
FarmRoleNetwork
object
7 properties 1 required
LightsOutFarmOwnerNotification
object
2 properties 2 required
DatastoreCloudIdentity
object
2 properties
ApiMessage
object
2 properties
GceServiceAccount
object
1 property 1 required
GlobalVariable
object
11 properties 2 required
BootstrapConfiguration
object
Farm Role bootstrap configuration. Please note that this configuration is available only for Roles configured with Chef built-in automation.
2 properties 1 required
TagsCondition
object
2 properties 2 required
TemplateMetadata
object
1 property
RootStorageConfiguration
object
3 properties 2 required
FarmRoleSummaryListResponse
object
5 properties
FarmCloudServiceLinkDetailsResponse
object
4 properties
AwsAlbLink
object
6 properties 2 required
InitializationStatus
object
2 properties
ScriptVariableList
object
9 properties 3 required
AzureStorageTemplateCloudFeatures
object
Cloud specifics template configuration.
3 properties 1 required
FarmRole
object
15 properties 5 required
CloudSnapshotForeignKey
object
1 property 1 required
Os
object
5 properties 5 required
AnsibleTowerBootstrapConfiguration
object
Farm Role bootstrap configuration. Please note that this configuration is available only for Roles configured with Chef built-in automation.
4 properties 2 required
AwsInstanceTypeCloudFeatures
object
AWS instance type configuration.
6 properties 1 required
RoleIdentityTemplateContent
object
2 properties 1 required
OrchestrationTemplateContent
object
1 property
AwsNlbLink
object
6 properties 2 required
AnsibleTowerConfigurationIdentity
object
2 properties
PersistentStorageTemplate
object
Storage Template configuration.
4 properties 1 required
ApiErrorResponse
object
Common response for erroneous requests.
3 properties
BasicScalingRule
object
It is used in combination with the user defined Scaling Metrics.
4 properties 4 required
ApiMetaContainer
object
1 property
StorageConfiguration
object
2 properties 1 required
FarmRoleNetworkTemplate
object
6 properties 1 required
ScriptIdentity
object
2 properties 1 required
AwsElbLink
object
6 properties 2 required
AzureCloudFeatures
object
Azure Farm Role configuration. Required for Azure Farm Roles.
4 properties 2 required
FarmRoleAdvancedConfiguration
object
6 properties
ScriptVariableString
object
10 properties 2 required
WebhookHostnameConfiguration
object
Webhook endpoint configuration to obtain hostname.
3 properties 2 required
VariableAllowedValue
object
2 properties 1 required
NetworkConfigurationTemplate
object
Farm Role template network configuration.
3 properties
GlobalVariableDetailsResponse
object
4 properties
Script
object
13 properties 2 required
RoleCategoryForeignKey
object
1 property 1 required
RoleIdentity
object
2 properties 1 required
FarmRoleSummary
object
8 properties 5 required
Event
object
3 properties 1 required
SpecificEventTrigger
object
Triggers when a specific Event fires.
2 properties 1 required
OpenstackCloudFeatures
object
OpenStack Farm Role configuration. Available only for OpenStack Farm Roles.
2 properties 1 required
ScriptVariableJson
object
8 properties 2 required
JobTemplateIdentity
object
3 properties
FreeRamScalingRule
object
It is used in combination with the user defined Scaling Metrics.
5 properties 4 required
ScriptVariableValue
object
2 properties 1 required
ScalingRule
object
2 properties 2 required
Farm
object
10 properties 1 required
WebhookEndpointForeignKey
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

scalr-farms-api-openapi.yml Raw ↑

Other APIs Scalr publishes across the network.

Scalr IaC Management API
Scalr Acl Roles API
Scalr Ansible Tower API
Scalr Cloud Credentials API
Scalr Clouds API
Scalr Cost Centers API
Scalr Environments API
Scalr Event Logs API
Scalr Events API
Scalr Farm Roles API
Scalr Global Variables API
Scalr Images API
Where this information came from

This is an independent, third-party profile of Scalr Farms API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.