swagger: '2.0' info: description: Manage Roles, Images, Environments and etc. title: Scalr Account Acl Roles API version: 1.0.0 basePath: /api/v1beta0/account produces: - application/json tags: - name: Roles paths: /{accountId}/roles/: parameters: - description: The ID of the Account scoping this request. in: path name: accountId required: true type: integer get: description: List all the Roles available in this Account. responses: 200: description: A list of AccountRole objects. schema: $ref: '#/definitions/AccountRoleListResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles post: description: Create a new Role in this Account. parameters: - description: The JSON representation of a AccountRole object. in: body name: accountRoleObject required: true schema: $ref: '#/definitions/AccountRole' responses: 201: description: The JSON representation of a AccountRole object. schema: $ref: '#/definitions/AccountRoleDetailsResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles /{accountId}/roles/{roleId}/: parameters: - description: The ID of the Account scoping this request. in: path name: accountId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role' delete: description: Delete a Role from this Account. responses: 204: description: Successful deletion. 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles get: description: Retrieve detailed information about a given Role. responses: 200: description: The JSON representation of a AccountRole object. schema: $ref: '#/definitions/AccountRoleDetailsResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles patch: description: Modify the attributes of a given Role. parameters: - description: The JSON representation of a AccountRole object. in: body name: accountRoleObject required: true schema: $ref: '#/definitions/AccountRole' responses: 200: description: The JSON representation of a AccountRole object. schema: $ref: '#/definitions/AccountRoleDetailsResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles /{accountId}/roles/{roleId}/actions/clone/: parameters: - description: The ID of the Account scoping this request. in: path name: accountId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role' post: description: Make a copy of an existing Role by cloning it. parameters: - description: Role cloning options. in: body name: cloneRoleRequest required: true schema: properties: name: description: The name of the new Role. type: string required: - name responses: 201: description: The JSON representation of a AccountRole object. schema: $ref: '#/definitions/AccountRoleDetailsResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles /{accountId}/roles/{roleId}/actions/deprecate/: parameters: - description: The ID of the Account scoping this request. in: path name: accountId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role' post: description: Deprecate a Role and set another Role to replace it. parameters: - description: Deprecate Role options. in: body name: deprecateRoleRequest required: false schema: properties: deprecate: default: true description: By default deprecate Role If a value is true clears the deprecate from Role. type: boolean replacement: $ref: '#/definitions/RoleForeignKey' description: The suggested replacement Role foreign key for the current Role. responses: 200: description: The JSON representation of a AccountRole object. schema: $ref: '#/definitions/AccountRoleDetailsResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles /{accountId}/roles/{roleId}/global-variables/: parameters: - description: The ID of the Account scoping this request. in: path name: accountId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role' get: description: List all the Global Variables associated with a given Role. responses: 200: description: A list of GlobalVariable objects. schema: $ref: '#/definitions/GlobalVariableListResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles post: description: Declare a new Global Variable for this Role. parameters: - description: The JSON representation of a GlobalVariable object. in: body name: globalVariableObject required: true schema: $ref: '#/definitions/GlobalVariable' responses: 201: description: The JSON representation of a GlobalVariable object. schema: $ref: '#/definitions/GlobalVariableDetailsResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles /{accountId}/roles/{roleId}/global-variables/{globalVariableName}/: parameters: - description: The ID of the Account scoping this request. in: path name: accountId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role' - description: The name of the Global Variable being accessed. in: path maxLength: 128 minLength: 2 name: globalVariableName pattern: \w+ required: true type: string delete: description: Delete a Global Variable from a given Role's scope. responses: 204: description: Successful deletion. 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles get: description: Retrieve detailed information about Global Variable in the Role's scope. responses: 200: description: The JSON representation of a GlobalVariable object. schema: $ref: '#/definitions/GlobalVariableDetailsResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles patch: description: Modify the attributes of a Global Variable in the Role's scope. parameters: - description: The JSON representation of a GlobalVariable object. in: body name: globalVariableObject required: true schema: $ref: '#/definitions/GlobalVariable' responses: 200: description: The JSON representation of a GlobalVariable object. schema: $ref: '#/definitions/GlobalVariableDetailsResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles /{accountId}/roles/{roleId}/images/: parameters: - description: The ID of the Account scoping this request. in: path name: accountId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role' get: description: List all the Images associated with a given Role. responses: 200: description: A list of RoleImage objects. schema: $ref: '#/definitions/RoleImageListResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles post: description: Associate a new Image with a given Role. This will fail if an Image associated to the Role is in the same location than the Image you are trying to add. parameters: - description: The JSON representation of a RoleImage object. in: body name: roleImageObject required: true schema: $ref: '#/definitions/RoleImage' responses: 201: description: The JSON representation of a RoleImage object. schema: $ref: '#/definitions/RoleImageDetailsResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles /{accountId}/roles/{roleId}/images/{imageId}/: parameters: - description: The ID of the Account scoping this request. in: path name: accountId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role' - description: The ID of a Image object. in: path maxLength: 36 minLength: 36 name: imageId pattern: '[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}' required: true type: string x-references: $ref: '#/definitions/Image' delete: description: Dis-associate an Image from a given Role. responses: 204: description: Successful deletion. 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles get: description: Retrieve detailed information about an Image. responses: 200: description: Redirects to the Image. schema: $ref: '#/definitions/ImageDetailsResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles /{accountId}/roles/{roleId}/images/{imageId}/actions/replace/: parameters: - description: The ID of the Account scoping this request. in: path name: accountId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role' - description: The ID of a Image object. in: path maxLength: 36 minLength: 36 name: imageId pattern: '[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}' required: true type: string x-references: $ref: '#/definitions/Image' post: description: Replace an Image in-place in a given Role. This allows to replace an Image without having to dis-associate it and then associate a new one, which may not be possible if a Farm Role is currently using this Image. parameters: - description: The JSON representation of a RoleImage object. in: body name: roleImageObject required: true schema: $ref: '#/definitions/RoleImage' responses: 200: description: The JSON representation of a RoleImage object. schema: $ref: '#/definitions/RoleImageDetailsResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles /{accountId}/roles/{roleId}/orchestration-rules/: parameters: - description: The ID of the Account scoping this request. in: path name: accountId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role' get: description: List the Orchestration Rules associated with a given Role, including Rules from higher Scopes (those are read-only). responses: 200: description: A list of OrchestrationRule objects. schema: $ref: '#/definitions/OrchestrationRuleListResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles post: description: Create a new Orchestration Rule associated to a Role. parameters: - description: The JSON representation of a OrchestrationRule object. in: body name: orchestrationRuleObject required: true schema: $ref: '#/definitions/OrchestrationRule' responses: 201: description: The JSON representation of a OrchestrationRule object. schema: $ref: '#/definitions/OrchestrationRuleDetailsResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles /{accountId}/roles/{roleId}/orchestration-rules/{orchestrationRuleId}/: parameters: - description: The ID of the Account scoping this request. in: path name: accountId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role' - description: The ID of a OrchestrationRule object. in: path maxLength: 36 minLength: 36 name: orchestrationRuleId pattern: '[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}' required: true type: string x-references: $ref: '#/definitions/OrchestrationRule' delete: description: Delete an Orchestration Rule from the Role. responses: 204: description: Successful deletion. 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles get: description: Retrieve detailed information about a given Orchestration Rule associated to this Role. responses: 200: description: The JSON representation of a OrchestrationRule object. schema: $ref: '#/definitions/OrchestrationRuleDetailsResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles patch: description: Modify the attributes of a given Orchestration Rule. parameters: - description: The JSON representation of a OrchestrationRule object. in: body name: orchestrationRuleObject required: true schema: $ref: '#/definitions/OrchestrationRule' responses: 200: description: The JSON representation of a OrchestrationRule object. schema: $ref: '#/definitions/OrchestrationRuleDetailsResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse' tags: - Roles /roles/: get: description: List all the Roles available in the global scope. responses: 200: description: A list of Role objects. schema: $ref: '#/definitions/RoleListResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles post: description: Create a new Role in the global scope. parameters: - description: The JSON representation of a Role object. in: body name: roleObject required: true schema: $ref: '#/definitions/Role_2' responses: 201: description: The JSON representation of a Role object. schema: $ref: '#/definitions/RoleDetailsResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles /roles/{roleId}/: parameters: - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_2' delete: description: Delete a Role from the global scope. responses: 204: description: Successful deletion. 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles get: description: Retrieve detailed information about a given Role. responses: 200: description: The JSON representation of a Role object. schema: $ref: '#/definitions/RoleDetailsResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles patch: description: Modify the attributes of a given Role. parameters: - description: The JSON representation of a Role object. in: body name: roleObject required: true schema: $ref: '#/definitions/Role_2' responses: 200: description: The JSON representation of a Role object. schema: $ref: '#/definitions/RoleDetailsResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles /roles/{roleId}/actions/deprecate/: parameters: - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_2' post: description: Deprecate a Role and set another Role to replace it. parameters: - description: Deprecate Role options. in: body name: deprecateRoleRequest required: false schema: properties: deprecate: default: true description: By default deprecate Role If a value is true clears the deprecate from Role. type: boolean replacement: $ref: '#/definitions/RoleForeignKey' description: The suggested replacement Role foreign key for the current Role. responses: 200: description: The JSON representation of a Role object. schema: $ref: '#/definitions/RoleDetailsResponse' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles /roles/{roleId}/global-variables/: parameters: - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_2' get: description: List all the Global Variables associated with a given Role. responses: 200: description: A list of GlobalVariable objects. schema: $ref: '#/definitions/GlobalVariableListResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles post: description: Declares a new Global Variable for this Role. parameters: - description: The JSON representation of a GlobalVariable object. in: body name: globalVariableObject required: true schema: $ref: '#/definitions/GlobalVariable_2' responses: 201: description: The JSON representation of a GlobalVariable object. schema: $ref: '#/definitions/GlobalVariableDetailsResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles /roles/{roleId}/global-variables/{globalVariableName}/: parameters: - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_2' - description: The name of the Global Variable being accessed. in: path maxLength: 128 minLength: 2 name: globalVariableName pattern: \w+ required: true type: string delete: description: Deletes a Global Variable from a given Role's scope. responses: 204: description: Successful deletion. 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles get: description: Retrieve detailed information about a Global Variable in the Role's scope. responses: 200: description: The JSON representation of a GlobalVariable object. schema: $ref: '#/definitions/GlobalVariableDetailsResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles patch: description: Modify the attributes of a Global Variable in the Role's scope. parameters: - description: The JSON representation of a GlobalVariable object. in: body name: globalVariableObject required: true schema: $ref: '#/definitions/GlobalVariable_2' responses: 200: description: The JSON representation of a GlobalVariable object. schema: $ref: '#/definitions/GlobalVariableDetailsResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles /roles/{roleId}/images/: parameters: - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_2' get: description: List all the Images associated with the specified Role. responses: 200: description: A list of RoleImage objects. schema: $ref: '#/definitions/RoleImageListResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles post: description: Associate a new Image with this Role. This will fail if an Image associated to the Role is in the same location than the Image you are trying to add. parameters: - description: The JSON representation of a RoleImage object. in: body name: roleImageObject required: true schema: $ref: '#/definitions/RoleImage_2' responses: 201: description: The JSON representation of a RoleImage object. schema: $ref: '#/definitions/RoleImageDetailsResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles /roles/{roleId}/images/{imageId}/: parameters: - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_2' - description: The ID of a Image object. in: path maxLength: 36 minLength: 36 name: imageId pattern: '[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}' required: true type: string x-references: $ref: '#/definitions/Image_2' delete: description: Dis-associates an Image from a given Role. responses: 204: description: Successful deletion. 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles get: description: Retrieve detailed information about an Image. responses: 200: description: Redirects to the Image. schema: $ref: '#/definitions/ImageDetailsResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles /roles/{roleId}/images/{imageId}/actions/replace/: parameters: - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_2' - description: The ID of a Image object. in: path maxLength: 36 minLength: 36 name: imageId pattern: '[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}' required: true type: string x-references: $ref: '#/definitions/Image_2' post: description: Replaces an Image in-place in a given Role. This allows you to replace an Image without having to dis-associate it and then associate a new one, which may not be possible if a Farm Role is currently using this Image. parameters: - description: The JSON representation of a RoleImage object. in: body name: roleImageObject required: true schema: $ref: '#/definitions/RoleImage_2' responses: 200: description: The JSON representation of a RoleImage object. schema: $ref: '#/definitions/RoleImageDetailsResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles /roles/{roleId}/orchestration-rules/: parameters: - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_2' get: description: List the Orchestration Rules associated to a Role. responses: 200: description: A list of OrchestrationRule objects. schema: $ref: '#/definitions/OrchestrationRuleListResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles post: description: Create a new Orchestration Rule associated to a Role. parameters: - description: The JSON representation of a OrchestrationRule object. in: body name: orchestrationRuleObject required: true schema: $ref: '#/definitions/OrchestrationRule_2' responses: 201: description: The JSON representation of a OrchestrationRule object. schema: $ref: '#/definitions/OrchestrationRuleDetailsResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles /roles/{roleId}/orchestration-rules/{orchestrationRuleId}/: parameters: - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_2' - description: The ID of a OrchestrationRule object. in: path maxLength: 36 minLength: 36 name: orchestrationRuleId pattern: '[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}' required: true type: string x-references: $ref: '#/definitions/OrchestrationRule_2' delete: description: Deletes the specified Orchestration Rule from the Role. responses: 204: description: Successful deletion. 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles get: description: Retrieve a given Orchestration Rule associated to a Role. responses: 200: description: The JSON representation of a OrchestrationRule object. schema: $ref: '#/definitions/OrchestrationRuleDetailsResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles patch: description: Modify the attributes of the specified Orchestration Rule. parameters: - description: The JSON representation of a OrchestrationRule object. in: body name: orchestrationRuleObject required: true schema: $ref: '#/definitions/OrchestrationRule_2' responses: 200: description: The JSON representation of a OrchestrationRule object. schema: $ref: '#/definitions/OrchestrationRuleDetailsResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_2' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_2' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_2' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_2' tags: - Roles /{envId}/roles/: parameters: - description: The ID of the Environment scoping this request. in: path name: envId required: true type: integer get: description: List all the Roles available in this Environment. responses: 200: description: A list of Role objects. schema: $ref: '#/definitions/RoleListResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles post: description: Create a new Role in this Environment. parameters: - description: The JSON representation of a Role object. in: body name: roleObject required: true schema: $ref: '#/definitions/Role_3' responses: 201: description: The JSON representation of a Role object. schema: $ref: '#/definitions/RoleDetailsResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles /{envId}/roles/{roleId}/: parameters: - description: The ID of the Environment scoping this request. in: path name: envId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_3' delete: description: Delete a Role from this Environment. responses: 204: description: Successful deletion. 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles get: description: Retrieve detailed information about a given Role. responses: 200: description: The JSON representation of a Role object. schema: $ref: '#/definitions/RoleDetailsResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles patch: description: Modify the attributes of a given Role. parameters: - description: The JSON representation of a Role object. in: body name: roleObject required: true schema: $ref: '#/definitions/Role_3' responses: 200: description: The JSON representation of a Role object. schema: $ref: '#/definitions/RoleDetailsResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles /{envId}/roles/{roleId}/actions/clone/: parameters: - description: The ID of the Environment scoping this request. in: path name: envId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_3' post: description: Make a copy of an existing Role by cloning it. parameters: - description: Role cloning options. in: body name: cloneRoleRequest required: true schema: properties: name: description: The name of the new Role. type: string required: - name responses: 201: description: The JSON representation of a Role object. schema: $ref: '#/definitions/RoleDetailsResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles /{envId}/roles/{roleId}/actions/deprecate/: parameters: - description: The ID of the Environment scoping this request. in: path name: envId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_3' post: description: Deprecate a Role and set another Role to replace it. parameters: - description: Deprecate Role options. in: body name: deprecateRoleRequest required: false schema: properties: deprecate: default: true description: By default deprecate Role If a value is true clears the deprecate from Role. type: boolean replacement: $ref: '#/definitions/RoleForeignKey' description: The suggested replacement Role foreign key for the current Role. responses: 200: description: The JSON representation of a Role object. schema: $ref: '#/definitions/RoleDetailsResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles /{envId}/roles/{roleId}/actions/promote/: parameters: - description: The ID of the Environment scoping this request. in: path name: envId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_3' post: description: Promote Role to account scope. responses: 200: description: The JSON representation of a Role object. schema: $ref: '#/definitions/RoleDetailsResponse_2' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles /{envId}/roles/{roleId}/global-variables/: parameters: - description: The ID of the Environment scoping this request. in: path name: envId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_3' get: description: List all the Global Variables associated with a given Role. responses: 200: description: A list of GlobalVariable objects. schema: $ref: '#/definitions/GlobalVariableListResponse_3' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles post: description: Declares a new Global Variable for this Role. parameters: - description: The JSON representation of a GlobalVariable object. in: body name: globalVariableObject required: true schema: $ref: '#/definitions/GlobalVariable_3' responses: 201: description: The JSON representation of a GlobalVariable object. schema: $ref: '#/definitions/GlobalVariableDetailsResponse_3' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles /{envId}/roles/{roleId}/global-variables/{globalVariableName}/: parameters: - description: The ID of the Environment scoping this request. in: path name: envId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_3' - description: The name of the Global Variable being accessed. in: path maxLength: 128 minLength: 2 name: globalVariableName pattern: \w+ required: true type: string delete: description: Deletes a Global Variable from this Role's scope. responses: 204: description: Successful deletion. 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles get: description: Retrieve detailed information about Global Variable in the Role's scope. responses: 200: description: The JSON representation of a GlobalVariable object. schema: $ref: '#/definitions/GlobalVariableDetailsResponse_3' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles patch: description: Modify the attributes of a Global Variable in the Role's scope. parameters: - description: The JSON representation of a GlobalVariable object. in: body name: globalVariableObject required: true schema: $ref: '#/definitions/GlobalVariable_3' responses: 200: description: The JSON representation of a GlobalVariable object. schema: $ref: '#/definitions/GlobalVariableDetailsResponse_3' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles /{envId}/roles/{roleId}/images/: parameters: - description: The ID of the Environment scoping this request. in: path name: envId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_3' get: description: List all Images associated with a given Role. responses: 200: description: A list of RoleImage objects. schema: $ref: '#/definitions/RoleImageListResponse_3' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles post: description: Associates a new Image with a given Role. This will fail if an Image associated to the Role is in the same location than the Image you are trying to add. parameters: - description: The JSON representation of a RoleImage object. in: body name: roleImageObject required: true schema: $ref: '#/definitions/RoleImage_3' responses: 201: description: The JSON representation of a RoleImage object. schema: $ref: '#/definitions/RoleImageDetailsResponse_3' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles /{envId}/roles/{roleId}/images/{imageId}/: parameters: - description: The ID of the Environment scoping this request. in: path name: envId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_3' - description: The ID of a Image object. in: path maxLength: 36 minLength: 36 name: imageId pattern: '[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}' required: true type: string x-references: $ref: '#/definitions/Image_3' delete: description: Dis-associates an Image from a given Role. responses: 204: description: Successful deletion. 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles get: description: Retrieve detailed information about an Image. responses: 200: description: Redirects to the Image. schema: $ref: '#/definitions/ImageDetailsResponse_3' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles /{envId}/roles/{roleId}/images/{imageId}/actions/replace/: parameters: - description: The ID of the Environment scoping this request. in: path name: envId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_3' - description: The ID of a Image object. in: path maxLength: 36 minLength: 36 name: imageId pattern: '[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}' required: true type: string x-references: $ref: '#/definitions/Image_3' post: description: Replace an Image in-place in a given Role. This allows to replace an Image without having to dis-associate it and then associate a new one, which may not be possible if a Farm Role is currently using this Image. parameters: - description: The JSON representation of a RoleImage object. in: body name: roleImageObject required: true schema: $ref: '#/definitions/RoleImage_3' responses: 200: description: The JSON representation of a RoleImage object. schema: $ref: '#/definitions/RoleImageDetailsResponse_3' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles /{envId}/roles/{roleId}/orchestration-rules/: parameters: - description: The ID of the Environment scoping this request. in: path name: envId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_3' get: description: List the Orchestration Rules associated with a given Role, including Rules from higher Scopes (those are read-only). responses: 200: description: A list of OrchestrationRule objects. schema: $ref: '#/definitions/OrchestrationRuleListResponse_3' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles post: description: Create a new Orchestration Rule associated to a Role. parameters: - description: The JSON representation of a OrchestrationRule object. in: body name: orchestrationRuleObject required: true schema: $ref: '#/definitions/OrchestrationRule_3' responses: 201: description: The JSON representation of a OrchestrationRule object. schema: $ref: '#/definitions/OrchestrationRuleDetailsResponse_3' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles /{envId}/roles/{roleId}/orchestration-rules/{orchestrationRuleId}/: parameters: - description: The ID of the Environment scoping this request. in: path name: envId required: true type: integer - description: The ID of a Role object. in: path name: roleId required: true type: integer x-references: $ref: '#/definitions/Role_3' - description: The ID of a OrchestrationRule object. in: path maxLength: 36 minLength: 36 name: orchestrationRuleId pattern: '[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}' required: true type: string x-references: $ref: '#/definitions/OrchestrationRule_3' delete: description: Delete the specified Orchestration Rule from the Role. responses: 204: description: Successful deletion. 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles get: description: Retrieve a given Orchestration Rule associated to a Role. responses: 200: description: The JSON representation of a OrchestrationRule object. schema: $ref: '#/definitions/OrchestrationRuleDetailsResponse_3' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles patch: description: Modify the attributes of a given Orchestration Rule. parameters: - description: The JSON representation of a OrchestrationRule object. in: body name: orchestrationRuleObject required: true schema: $ref: '#/definitions/OrchestrationRule_3' responses: 200: description: The JSON representation of a OrchestrationRule object. schema: $ref: '#/definitions/OrchestrationRuleDetailsResponse_3' 400: description: A client-side error was made. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was structurally incorrect, and was not understood by the API. name: InvalidStructure - description: The request was understood by the API, but included invalid data. name: InvalidValue - description: The request wasn't understood by the API. name: BadRequest 401: description: The request was not authenticated. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: The request was not properly authenticated. name: BadAuthentication 403: description: Insufficient permissions. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This request should be made in a different Scope. name: ScopeViolation - description: You do not have the necessary permissions to perform this request. name: PermissionViolation - description: The maximum memory limit in GB has been reached. name: MemoryQuotaExceeded - description: The vCPUs limit has been reached. name: VcpusQuotaExceeded - description: The maximum number of the Servers that you can launch or resume has been reached. name: ServersQuotaExceeded - description: The maximum number of the Servers that you can launch or resume on current Farm has been reached. name: ServersPerFarmQuotaExceeded 404: description: Resource not found. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: This endpoint does not exist. name: EndpointNotFound noDoc: true - description: The object you are trying to access does not exist. name: ObjectNotFound 409: description: Conflict with current state. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: These changes aren't possible while this object is in use. name: ObjectInUse - description: These changes would violate a policy. name: PolicyViolation - description: These changes would violate a unicity constraint. name: UnicityViolation - description: Some of the objects being changed are locked and cannot be changed. name: Locked - description: This Cloud platform is not enabled. name: NotEnabledPlatform - description: The Operating System does not match. name: OperatingSystemMismatch - description: Some of the objects or actions being access are deprecated. name: Deprecated - description: The action can't be perfomed in the current object's state. name: UnacceptableState - description: The object that you are trying to access does not exist on the cloud. name: ObjectNotFoundOnCloud - description: Some of these settings cannot be applied, they either conflict with the current state or are invalid. name: UnacceptableObjectConfiguration 422: description: This request was well-formed but was rejected due to semantic errors. schema: $ref: '#/definitions/ApiErrorResponse_3' x-errorCodes: - description: Some of the configuration settings cannot be applied because they conflict with the current state. name: ConfigurationMismatch 500: description: A server-side error occurred. schema: $ref: '#/definitions/ApiErrorResponse_3' 501: description: This feature is not implemented in Scalr. schema: $ref: '#/definitions/ApiErrorResponse_3' 503: description: The service is currently unavailable. schema: $ref: '#/definitions/ApiErrorResponse_3' tags: - Roles definitions: OrchestrationRuleCondition: discriminator: type properties: type: description: Orchestration rule condition type. Selected only those servers that match conditions. enum: - FarmRolesCondition - OsCondition - TagsCondition type: string required: - type x-concreteTypes: - $ref: '#/definitions/FarmRolesCondition' - $ref: '#/definitions/OsCondition' - $ref: '#/definitions/TagsCondition' OsCondition: properties: osType: description: OS family or type. type: string type: description: Orchestration rule condition type. Selected only those servers that match conditions. enum: - FarmRolesCondition - OsCondition - TagsCondition type: string required: - type - osType x-abstractType: $ref: '#/definitions/OrchestrationRuleCondition' x-discriminator: type ScriptVariableRemoteList: properties: category: description: The category of this Variable. type: string description: description: A description that explains what this Global Variable is used for. type: string hidden: description: Whether this Script Variable is hidden in Orchestration Rules or execute Script action. type: boolean integrationEndpoint: $ref: '#/definitions/WebhookEndpointForeignKey' locked: description: Whether this Script Variable value is locked in Orchestration Rules or execute Script action. type: boolean name: description: The Variable name. type: string required: description: Whether this Script Variable value is required in Orchestration Rules or execute Script action. type: boolean type: description: The type of Script Variable. enum: - ScriptVariableJson - ScriptVariableString - ScriptVariableList - ScriptVariableRemoteList type: string value: description: The value declared in the script level. This property can be redefined for not locked variables in Orhestration Rules or execute Script action. Also this field supports Global Variable interpolation. type: string required: - name - type - integrationEndpoint x-abstractType: $ref: '#/definitions/ScriptVariable' x-createOnly: - name x-discriminator: type TriggeringServerTarget: description: Select only the Server that triggered the Event. properties: conditions: description: 'Triggering servers conditions. ' items: $ref: '#/definitions/OrchestrationRuleCondition' type: array targetType: enum: - TriggeringServerTarget - TriggeringFarmRoleTarget - FarmTarget type: string required: - targetType x-abstractType: $ref: '#/definitions/Target' x-discriminator: targetType GlobalVariableList: properties: allowedValues: description: The list of values to which the Global Variable value must correspond. items: $ref: '#/definitions/VariableAllowedValue' type: array category: description: The category of this Global Variable. type: string computedValue: description: The value computed by Scalr for this Global Variable. readOnly: true type: string declaredIn: description: The Scope in which this Global Variable is declared. enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string definedIn: description: The Scope in which this Global Variable is given a value. enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string description: description: A description that explains what this Global Variable is used for. type: string hidden: description: Whether this Global Variable is hidden in inner scopes. This is read-only if `declaredIn` is not the current scope. type: boolean locked: description: Whether this Global Variable is locked in inner scopes. This is read-only if `declaredIn` is not the current scope. type: boolean name: type: string requiredIn: description: The scope where this Global Variable is required. This is read-only if `declaredIn` is not the current scope. enum: - scalr - account - environment - farm - farmrole - role - server type: string type: description: The type of Global Variable. enum: - GlobalVariableJson - GlobalVariableString - GlobalVariableList - GlobalVariableRemoteList type: string value: description: The value declared in the current scope for this Global Variable. If it is null, the value will be inherited from higher scopes. This field is ignored if `declaredIn` is not the current scope. type: string required: - name - type - allowedValues x-abstractType: $ref: '#/definitions/GlobalVariable' x-createOnly: - name x-discriminator: type RoleImageDetailsResponse_2: properties: data: $ref: '#/definitions/RoleImage_2' readOnly: true errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/RoleImage_2' x-usedIn: - /global/roles/{roleId}/images/ - /global/roles/{roleId}/images/{imageId}/actions/replace/ RoleImageDetailsResponse: properties: data: $ref: '#/definitions/RoleImage' readOnly: true errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/RoleImage' x-usedIn: - /account/{accountId}/roles/{roleId}/images/ - /account/{accountId}/roles/{roleId}/images/{imageId}/actions/replace/ FarmRoleIdentity: properties: alias: description: The Alias for this Farm Role. type: string id: description: Unique identifier for this Farm Role. readOnly: true type: integer ApiErrorResponse_3: description: Common response for erroneous requests. properties: errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-usedIn: - /user/{envId}/global-variables/ - /user/{envId}/global-variables/{globalVariableName}/ - /user/{envId}/orchestration-rules/ - /user/{envId}/orchestration-rules/{orchestrationRuleId}/ - /user/{envId}/projects/ - /user/{envId}/projects/{projectId}/ - /user/{envId}/cost-centers/ - /user/{envId}/cost-centers/{costCenterId}/ - /user/{envId}/role-categories/ - /user/{envId}/role-categories/{roleCategoryId}/ - /user/{envId}/roles/ - /user/{envId}/roles/{roleId}/ - /user/{envId}/roles/{roleId}/actions/promote/ - /user/{envId}/roles/{roleId}/actions/clone/ - /user/{envId}/roles/{roleId}/actions/deprecate/ - /user/{envId}/roles/{roleId}/images/ - /user/{envId}/roles/{roleId}/images/{imageId}/ - /user/{envId}/roles/{roleId}/images/{imageId}/actions/replace/ - /user/{envId}/roles/{roleId}/global-variables/ - /user/{envId}/roles/{roleId}/global-variables/{globalVariableName}/ - /user/{envId}/roles/{roleId}/orchestration-rules/ - /user/{envId}/roles/{roleId}/orchestration-rules/{orchestrationRuleId}/ - /user/{envId}/images/ - /user/{envId}/images/{imageId}/ - /user/{envId}/images/{imageId}/actions/copy/ - /user/{envId}/images/{imageId}/actions/replace/ - /user/{envId}/servers/ - /user/{envId}/servers/{serverId}/ - /user/{envId}/servers/{serverId}/actions/suspend/ - /user/{envId}/servers/{serverId}/actions/terminate/ - /user/{envId}/servers/{serverId}/actions/resume/ - /user/{envId}/servers/{serverId}/actions/reboot/ - /user/{envId}/servers/{serverId}/actions/sync/ - /user/{envId}/servers/{serverId}/global-variables/ - /user/{envId}/servers/{serverId}/global-variables/{globalVariableName}/ - /user/{envId}/farms/{farmId}/servers/ - /user/{envId}/farm-roles/{farmRoleId}/servers/ - /user/{envId}/scripts/ - /user/{envId}/scripts/{scriptId}/ - /user/{envId}/scripts/{scriptId}/actions/execute/ - /user/{envId}/scripts/{scriptId}/script-versions/ - /user/{envId}/scripts/{scriptId}/script-versions/{scriptVersionNumber}/ - /user/{envId}/scripts/{scriptId}/script-versions/{scriptVersionNumber}/actions/execute/ - /user/{envId}/script-executions/{scriptExecutionId}/ - /user/{envId}/orchestration-logs/ - /user/{envId}/orchestration-logs/{logEntryId}/ - /user/{envId}/event-logs/ - /user/{envId}/event-logs/{eventLogEntryId}/ - /user/{envId}/webhook-endpoints/ - /user/{envId}/os/ - /user/{envId}/os/{osId}/ - /user/{envId}/events/ - /user/{envId}/events/{eventId}/ - /user/{envId}/events/{eventId}/actions/fire/ - /user/{envId}/farms/ - /user/{envId}/farms/{farmId}/ - /user/{envId}/farms/{farmId}/cloud-services/ - /user/{envId}/farms/{farmId}/cloud-services/{farmCloudServiceLinkId}/ - /user/{envId}/farms/{farmId}/actions/generate-template/ - /user/{envId}/farms/{farmId}/actions/launch/ - /user/{envId}/farms/{farmId}/actions/suspend/ - /user/{envId}/farms/{farmId}/actions/resume/ - /user/{envId}/farms/{farmId}/actions/terminate/ - /user/{envId}/farms/{farmId}/actions/lock/ - /user/{envId}/farms/{farmId}/actions/unlock/ - /user/{envId}/farms/{farmId}/actions/clone/ - /user/{envId}/farms/{farmId}/global-variables/ - /user/{envId}/farms/{farmId}/global-variables/{globalVariableName}/ - /user/{envId}/farms/{farmId}/farm-roles/ - /user/{envId}/farm-roles/{farmRoleId}/ - /user/{envId}/farm-roles/{farmRoleId}/actions/import-server/ - /user/{envId}/farm-roles/{farmRoleId}/actions/generate-template/ - /user/{envId}/farm-roles/{farmRoleId}/actions/clone/ - /user/{envId}/farm-roles/{farmRoleId}/scaling/ - /user/{envId}/farm-roles/{farmRoleId}/scaling/{metricName}/ - /user/{envId}/farm-roles/{farmRoleId}/storage/ - /user/{envId}/farm-roles/{farmRoleId}/storage/{storageConfigurationId}/ - /user/{envId}/scaling-metrics/ - /user/{envId}/scaling-metrics/{metricName}/ - /user/{envId}/farm-roles/{farmRoleId}/global-variables/ - /user/{envId}/farm-roles/{farmRoleId}/global-variables/{globalVariableName}/ - /user/{envId}/farm-roles/{farmRoleId}/orchestration-rules/ - /user/{envId}/farm-roles/{farmRoleId}/orchestration-rules/{orchestrationRuleId}/ - /user/{envId}/clouds/{cloudPlatform}/cloud-locations/ - /user/{envId}/clouds/{cloudPlatform}/cloud-locations/{cloudLocation}/instance-types/ ImageDetailsResponse_2: properties: data: $ref: '#/definitions/Image_2' readOnly: true errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/Image_2' x-usedIn: - /global/roles/{roleId}/images/{imageId}/ - /global/images/ - /global/images/{imageId}/ - /global/images/{imageId}/actions/copy/ ImageDetailsResponse: properties: data: $ref: '#/definitions/Image' readOnly: true errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/Image' x-usedIn: - /account/{accountId}/roles/{roleId}/images/{imageId}/ - /account/{accountId}/images/ - /account/{accountId}/images/{imageId}/ - /account/{accountId}/images/{imageId}/actions/copy/ ScriptVariable: discriminator: type properties: category: description: The category of this Variable. type: string description: description: A description that explains what this Global Variable is used for. type: string hidden: description: Whether this Script Variable is hidden in Orchestration Rules or execute Script action. type: boolean locked: description: Whether this Script Variable value is locked in Orchestration Rules or execute Script action. type: boolean name: description: The Variable name. type: string required: description: Whether this Script Variable value is required in Orchestration Rules or execute Script action. type: boolean type: description: The type of Script Variable. enum: - ScriptVariableJson - ScriptVariableString - ScriptVariableList - ScriptVariableRemoteList type: string value: description: The value declared in the script level. This property can be redefined for not locked variables in Orhestration Rules or execute Script action. Also this field supports Global Variable interpolation. type: string required: - name - type x-concreteTypes: - $ref: '#/definitions/ScriptVariableString' - $ref: '#/definitions/ScriptVariableJson' - $ref: '#/definitions/ScriptVariableList' - $ref: '#/definitions/ScriptVariableRemoteList' x-createOnly: - name EnvironmentForeignKey: properties: id: description: Unique identifier of a Environment object. type: integer required: - id x-derived: $ref: '#/definitions/Environment' x-references: $ref: '#/definitions/Environment' ImageForeignKey: properties: id: type: string required: - id x-derived: $ref: '#/definitions/Image' x-references: $ref: '#/definitions/Image' TriggeringFarmRoleTarget: description: Selects all the Servers that belong to the same Farm Role as the Server that triggered the Event. properties: targetType: enum: - TriggeringServerTarget - TriggeringFarmRoleTarget - FarmTarget type: string required: - targetType x-abstractType: $ref: '#/definitions/Target' x-discriminator: targetType RemoteScriptAction_2: properties: actionType: enum: - ScalrScriptAction - RemoteScriptAction - ChefAction - LocalScriptAction - AnsibleTowerAction type: string path: description: URL to the script to execute. type: string required: - actionType - path x-abstractType: $ref: '#/definitions/Action_3' x-discriminator: actionType GlobalVariableRemoteList: properties: category: description: The category of this Global Variable. type: string computedValue: description: The value computed by Scalr for this Global Variable. readOnly: true type: string declaredIn: description: The Scope in which this Global Variable is declared. enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string definedIn: description: The Scope in which this Global Variable is given a value. enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string description: description: A description that explains what this Global Variable is used for. type: string hidden: description: Whether this Global Variable is hidden in inner scopes. This is read-only if `declaredIn` is not the current scope. type: boolean integrationEndpoint: $ref: '#/definitions/WebhookEndpointForeignKey' locked: description: Whether this Global Variable is locked in inner scopes. This is read-only if `declaredIn` is not the current scope. type: boolean name: type: string requiredIn: description: The scope where this Global Variable is required. This is read-only if `declaredIn` is not the current scope. enum: - scalr - account - environment - farm - farmrole - role - server type: string type: description: The type of Global Variable. enum: - GlobalVariableJson - GlobalVariableString - GlobalVariableList - GlobalVariableRemoteList type: string value: description: The value declared in the current scope for this Global Variable. If it is null, the value will be inherited from higher scopes. This field is ignored if `declaredIn` is not the current scope. type: string required: - name - type - integrationEndpoint x-abstractType: $ref: '#/definitions/GlobalVariable' x-createOnly: - name x-discriminator: type GlobalVariableString: properties: category: description: The category of this Global Variable. type: string computedValue: description: The value computed by Scalr for this Global Variable. readOnly: true type: string declaredIn: description: The Scope in which this Global Variable is declared. enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string definedIn: description: The Scope in which this Global Variable is given a value. enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string description: description: A description that explains what this Global Variable is used for. type: string hidden: description: Whether this Global Variable is hidden in inner scopes. This is read-only if `declaredIn` is not the current scope. type: boolean locked: description: Whether this Global Variable is locked in inner scopes. This is read-only if `declaredIn` is not the current scope. type: boolean name: type: string outputFormat: description: The formatting to apply when displaying this variable. This is read-only if `declaredIn` is not the current scope. type: string requiredIn: description: The scope where this Global Variable is required. This is read-only if `declaredIn` is not the current scope. enum: - scalr - account - environment - farm - farmrole - role - server type: string type: description: The type of Global Variable. enum: - GlobalVariableJson - GlobalVariableString - GlobalVariableList - GlobalVariableRemoteList type: string validationPattern: type: string value: description: The value declared in the current scope for this Global Variable. If it is null, the value will be inherited from higher scopes. This field is ignored if `declaredIn` is not the current scope. type: string required: - name - type x-abstractType: $ref: '#/definitions/GlobalVariable' x-createOnly: - name x-discriminator: type Target: discriminator: targetType properties: targetType: enum: - TriggeringServerTarget - TriggeringFarmRoleTarget - FarmTarget type: string required: - targetType x-concreteTypes: - $ref: '#/definitions/TriggeringServerTarget' - $ref: '#/definitions/TriggeringFarmRoleTarget' - $ref: '#/definitions/FarmTarget' RemoteScriptAction: properties: actionType: enum: - ScalrScriptAction - RemoteScriptAction - ChefAction - LocalScriptAction - AnsibleTowerAction type: string path: description: Path or URL to the script to execute. type: string required: - actionType - path x-abstractType: $ref: '#/definitions/Action' x-discriminator: actionType OrchestrationRuleDetailsResponse_2: properties: data: $ref: '#/definitions/OrchestrationRule_2' readOnly: true errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/OrchestrationRule_2' x-usedIn: - /global/roles/{roleId}/orchestration-rules/ - /global/roles/{roleId}/orchestration-rules/{orchestrationRuleId}/ Image_3: properties: added: description: Date and time at which this Image was created. format: date-time readOnly: true type: string architecture: enum: - i386 - x86_64 type: string cloudFeatures: $ref: '#/definitions/ImageCloudFeatures' cloudImageId: type: string cloudInitInstalled: description: Whether cloud-init is installed on this Image. type: boolean cloudLocation: description: 'Cloud Location, inside a given Cloud Platform, for this resource. May be null if this resource does not have a specific location. Note: if you would like to filter on this property, you **must** also filter on `cloudPlatform`.' type: string cloudPlatform: description: The Cloud Platform this resource resides in. enum: - ec2 - gce type: string deprecated: description: Whether this Image is deprecated. type: boolean id: maxLength: 36 minLength: 36 pattern: '[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}' readOnly: true type: string lastUsed: description: Date and time at which this Image was last used. format: date-time readOnly: true type: string name: type: string os: $ref: '#/definitions/OsForeignKey' scalrAgentInstalled: description: Whether Scalr Agent is installed on this Image. type: boolean scope: enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string size: description: Size of the image in GB. This property is read-only at the Environment scope. type: integer source: description: Indicates how this Image was created. enum: - Manual - BundleTask readOnly: true type: string status: description: Current status for this Image. `failed` means that the deletion failed. enum: - active - pending_delete - failed readOnly: true type: string statusError: description: If the Image is in a failed state, this indicates why. readOnly: true type: string type: description: (Only used on EC2 currently) Whether this Image is HVM or EBS. At the Environment scope this property is read-only. Property is deprecated and will be removed soon. Use 'cloudFeatures' instead. type: string required: - name - cloudPlatform - cloudImageId - architecture - os x-createOnly: - cloudImageId - size - type - scalrAgentInstalled - cloudInitInstalled - cloudLocation - cloudPlatform - os - architecture - cloudFeatures x-filterable: - id - name - scope - cloudPlatform - cloudLocation - cloudImageId - architecture - source - status - deprecated - os - scalrAgentInstalled - cloudInitInstalled x-usedIn: - /user/{envId}/roles/{roleId}/images/{imageId}/ - /user/{envId}/roles/{roleId}/images/{imageId}/actions/replace/ - /user/{envId}/images/ - /user/{envId}/images/{imageId}/ - /user/{envId}/images/{imageId}/actions/copy/ - /user/{envId}/images/{imageId}/actions/replace/ RoleImageListResponse_3: properties: data: items: $ref: '#/definitions/RoleImage_3' readOnly: true type: array errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true pagination: $ref: '#/definitions/ApiPagination' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/RoleImage_3' x-usedIn: - /user/{envId}/roles/{roleId}/images/ RoleImageDetailsResponse_3: properties: data: $ref: '#/definitions/RoleImage_3' readOnly: true errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/RoleImage_3' x-usedIn: - /user/{envId}/roles/{roleId}/images/ - /user/{envId}/roles/{roleId}/images/{imageId}/actions/replace/ RoleCategory: properties: id: description: Identifier of the Role Category. readOnly: true type: integer name: description: The name of the Role Category. type: string scope: description: The Scope in which this Role Category is defined. enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string required: - name x-filterable: - id - name - scope x-usedIn: - /account/{accountId}/role-categories/ - /account/{accountId}/role-categories/{roleCategoryId}/ Action: discriminator: actionType properties: actionType: enum: - ScalrScriptAction - RemoteScriptAction - ChefAction - LocalScriptAction - AnsibleTowerAction type: string required: - actionType x-concreteTypes: - $ref: '#/definitions/AnsibleTowerAction' - $ref: '#/definitions/ScalrScriptAction' - $ref: '#/definitions/RemoteScriptAction' - $ref: '#/definitions/LocalScriptAction' - $ref: '#/definitions/ChefAction' OrchestrationRule_2: properties: action: $ref: '#/definitions/Action_2' description: Orchestration Rule action that will be executed on the target servers. blocking: description: Whether this Orchestration Rule's execution should delay the execution of further Orchestration Rules and the triggering of further Events. Defaults to the action's default when null. type: boolean enabled: default: true description: If Orchestration Rule is not enabled this Rule won't be triggered. type: boolean id: description: Unique identifier for an Orchestration Rule. maxLength: 36 minLength: 36 pattern: '[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}' readOnly: true type: string order: description: The priority of this Orchestration Rule relative to other Orchestration Rules that use the same triggeringEvent. Default is relative to existing Rules. type: integer runAs: description: User the Orchestration Rule should execute as. Defaults to root / Administrator when null. type: string scope: enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string target: $ref: '#/definitions/Target' description: The set of Servers where the Orchestration Rules Action will be executed. timeout: description: The time Scalr should wait for before aborting the execution of this Orchestration Rule, in seconds. Defaults to the action's default when null. type: integer trigger: $ref: '#/definitions/Trigger' description: Orchestration Rule trigger. required: - trigger - action - target x-filterable: - id - blocking - order - runAs x-usedIn: - /global/roles/{roleId}/orchestration-rules/ - /global/roles/{roleId}/orchestration-rules/{orchestrationRuleId}/ AccountRoleListResponse: properties: data: items: $ref: '#/definitions/AccountRole' readOnly: true type: array errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true pagination: $ref: '#/definitions/ApiPagination' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/AccountRole' x-usedIn: - /account/{accountId}/roles/ ApiPagination: properties: first: readOnly: true type: string last: readOnly: true type: string next: readOnly: true type: string prev: readOnly: true type: string OpenstackImageCloudFeatures: description: Cloud specifics Image configuration. properties: sourceType: default: image description: The Openstack image source type. Set shapshot for image based on volume shapshot. enum: - image - snapshot type: string type: enum: - AwsImageCloudFeatures - VmwareImageCloudFeatures - OpenstackImageCloudFeatures type: string required: - type x-abstractType: $ref: '#/definitions/ImageCloudFeatures' x-discriminator: type RoleDeprecatedOptions: properties: deprecated: description: The timestamp at which this Role was deprecated. format: date-time readOnly: true type: string replacement: $ref: '#/definitions/RoleForeignKey' description: The suggested replacement Role foreign key for the current Role. readOnly: true RoleListResponse_2: properties: data: items: $ref: '#/definitions/Role_3' readOnly: true type: array errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true pagination: $ref: '#/definitions/ApiPagination' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/Role_3' x-usedIn: - /user/{envId}/roles/ OrchestrationRuleListResponse: properties: data: items: $ref: '#/definitions/OrchestrationRule' readOnly: true type: array errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true pagination: $ref: '#/definitions/ApiPagination' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/OrchestrationRule' x-usedIn: - /account/{accountId}/orchestration-rules/ - /account/{accountId}/roles/{roleId}/orchestration-rules/ WebhookEndpoint: description: Webhook endpoint summary. properties: id: description: Identifier of the Webhook endpoint. maxLength: 36 minLength: 36 pattern: '[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}' type: string scope: enum: - scalr - account - environment - farm - farmrole - role - server type: string url: description: Endpoint URL. type: string RoleImageListResponse: properties: data: items: $ref: '#/definitions/RoleImage' readOnly: true type: array errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true pagination: $ref: '#/definitions/ApiPagination' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/RoleImage' x-usedIn: - /account/{accountId}/roles/{roleId}/images/ FarmRolesCondition: properties: farmRoles: description: Farm Role identity objects. items: $ref: '#/definitions/FarmRoleIdentity' type: array type: description: Orchestration rule condition type. Selected only those servers that match conditions. enum: - FarmRolesCondition - OsCondition - TagsCondition type: string required: - type x-abstractType: $ref: '#/definitions/OrchestrationRuleCondition' x-discriminator: type Action_3: discriminator: actionType properties: actionType: enum: - ScalrScriptAction - RemoteScriptAction - ChefAction - LocalScriptAction - AnsibleTowerAction type: string required: - actionType x-concreteTypes: - $ref: '#/definitions/ScalrScriptAction' - $ref: '#/definitions/RemoteScriptAction_2' - $ref: '#/definitions/LocalScriptAction' - $ref: '#/definitions/ChefAction' - $ref: '#/definitions/AnsibleTowerAction' Action_2: discriminator: actionType properties: actionType: enum: - ScalrScriptAction - RemoteScriptAction - ChefAction - LocalScriptAction - AnsibleTowerAction type: string required: - actionType x-concreteTypes: - $ref: '#/definitions/ScalrScriptAction' - $ref: '#/definitions/RemoteScriptAction' - $ref: '#/definitions/LocalScriptAction' - $ref: '#/definitions/ChefAction' - $ref: '#/definitions/AnsibleTowerAction' ChefAction: properties: actionType: enum: - ScalrScriptAction - RemoteScriptAction - ChefAction - LocalScriptAction - AnsibleTowerAction type: string required: - actionType x-abstractType: $ref: '#/definitions/Action' x-discriminator: actionType GlobalVariable_2: discriminator: type properties: category: description: The category of this Global Variable. type: string computedValue: description: The value computed by Scalr for this Global Variable. readOnly: true type: string declaredIn: description: The Scope in which this Global Variable is declared. enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string definedIn: description: The Scope in which this Global Variable is given a value. enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string description: description: A description that explains what this Global Variable is used for. type: string hidden: description: Whether this Global Variable is hidden in inner scopes. This is read-only if `declaredIn` is not the current scope. type: boolean locked: description: Whether this Global Variable is locked in inner scopes. This is read-only if `declaredIn` is not the current scope. type: boolean name: type: string requiredIn: description: The scope where this Global Variable is required. This is read-only if `declaredIn` is not the current scope. enum: - scalr - account - environment - farm - farmrole - role - server type: string type: description: The type of Global Variable. enum: - GlobalVariableJson - GlobalVariableString - GlobalVariableList - GlobalVariableRemoteList type: string value: description: The value declared in the current scope for this Global Variable. If it is null, the value will be inherited from higher scopes. This field is ignored if `declaredIn` is not the current scope. type: string required: - name - type x-concreteTypes: - $ref: '#/definitions/GlobalVariableString' - $ref: '#/definitions/GlobalVariableJson' - $ref: '#/definitions/GlobalVariableList' - $ref: '#/definitions/GlobalVariableRemoteList' x-createOnly: - name x-usedIn: - /global/global-variables/ - /global/global-variables/{globalVariableName}/ - /global/roles/{roleId}/global-variables/ - /global/roles/{roleId}/global-variables/{globalVariableName}/ ImageCloudFeatures: description: Cloud specifics Image configuration. discriminator: type properties: type: enum: - AwsImageCloudFeatures - VmwareImageCloudFeatures - OpenstackImageCloudFeatures type: string required: - type x-concreteTypes: - $ref: '#/definitions/AwsImageCloudFeatures' - $ref: '#/definitions/VmwareImageCloudFeatures' - $ref: '#/definitions/OpenstackImageCloudFeatures' ApiErrorResponse_2: description: Common response for erroneous requests. properties: errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-usedIn: - /global/global-variables/ - /global/global-variables/{globalVariableName}/ - /global/role-categories/ - /global/role-categories/{roleCategoryId}/ - /global/roles/ - /global/roles/{roleId}/ - /global/roles/{roleId}/actions/deprecate/ - /global/roles/{roleId}/images/ - /global/roles/{roleId}/images/{imageId}/ - /global/roles/{roleId}/images/{imageId}/actions/replace/ - /global/roles/{roleId}/global-variables/ - /global/roles/{roleId}/global-variables/{globalVariableName}/ - /global/roles/{roleId}/orchestration-rules/ - /global/roles/{roleId}/orchestration-rules/{orchestrationRuleId}/ - /global/images/ - /global/images/{imageId}/ - /global/images/{imageId}/actions/copy/ - /global/images/{imageId}/actions/replace/ - /global/os/ - /global/os/{osId}/ - /global/projects/ - /global/projects/{projectId}/ - /global/cloud-credentials/ - /global/cloud-credentials/{cloudCredentialsId}/ - /global/users/ - /global/ansible-tower/servers/ - /global/ansible-tower/configurations/ - /global/ansible-tower/configurations/{ansibleTowerConfigurationId}/ RoleForeignKey: properties: id: type: integer required: - id x-derived: $ref: '#/definitions/Role' x-references: $ref: '#/definitions/Role' AccountRoleDetailsResponse: properties: data: $ref: '#/definitions/AccountRole' readOnly: true errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/AccountRole' x-usedIn: - /account/{accountId}/roles/ - /account/{accountId}/roles/{roleId}/ - /account/{accountId}/roles/{roleId}/actions/clone/ - /account/{accountId}/roles/{roleId}/actions/deprecate/ OrchestrationRule_3: properties: action: $ref: '#/definitions/Action_3' description: Orchestration Rule action that will be executed on the target servers. blocking: description: Whether this Orchestration Rule's execution should delay the execution of further Orchestration Rules and the triggering of further Events. Defaults to the action's default when null. type: boolean enabled: default: true description: If Orchestration Rule is not enabled this Rule won't be triggered type: boolean id: description: Unique identifier for an Orchestration Rule. maxLength: 36 minLength: 36 pattern: '[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}' readOnly: true type: string order: description: The priority of this Orchestration Rule relative to other Orchestration Rules that use the same triggeringEvent. Default is relative to existing Rules. type: integer runAs: description: A name of the system user the Orchestration Rule should be executed as. Administrator / root is used by default. type: string scope: enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string target: $ref: '#/definitions/Target' description: The set of Servers where the Orchestration Rules Action will be executed. timeout: description: The time Scalr should wait for before aborting the execution of this Orchestration Rule, in seconds. Defaults to the action's default when null. type: integer trigger: $ref: '#/definitions/Trigger' description: Orchestration Rule trigger. required: - trigger - action - target x-filterable: - id - blocking - order - runAs x-usedIn: - /user/{envId}/orchestration-rules/ - /user/{envId}/orchestration-rules/{orchestrationRuleId}/ - /user/{envId}/roles/{roleId}/orchestration-rules/ - /user/{envId}/roles/{roleId}/orchestration-rules/{orchestrationRuleId}/ - /user/{envId}/farm-roles/{farmRoleId}/orchestration-rules/ - /user/{envId}/farm-roles/{farmRoleId}/orchestration-rules/{orchestrationRuleId}/ ScriptVersionIdentity: properties: script: $ref: '#/definitions/ScriptIdentity' variables: description: The list of redefined script variables for the current script. items: $ref: '#/definitions/ScriptVariableValue' type: array version: description: The Script version. null is interpreted as the latest/default Version. type: string EventForeignKey: properties: id: description: The name of this Custom Event. type: string required: - id x-derived: $ref: '#/definitions/Event' x-references: $ref: '#/definitions/Event' AnsibleTowerAction: properties: actionType: enum: - ScalrScriptAction - RemoteScriptAction - ChefAction - LocalScriptAction - AnsibleTowerAction type: string configuration: $ref: '#/definitions/AnsibleTowerConfigurationIdentity' description: Ansible Tower identity stored at Bootstrap Configurations. jobTemplate: $ref: '#/definitions/JobTemplateIdentity' description: Ansible Tower Job template stored at Tower Server. variables: description: The Ansible Tower variables to override. JSON or YAML representation. type: string required: - actionType - configuration - jobTemplate x-abstractType: $ref: '#/definitions/Action' x-discriminator: actionType FarmTarget: description: Selects all the Servers that belong to the triggering Server's Farm. properties: conditions: description: 'Triggering servers conditions. ' items: $ref: '#/definitions/OrchestrationRuleCondition' type: array targetType: enum: - TriggeringServerTarget - TriggeringFarmRoleTarget - FarmTarget type: string required: - targetType x-abstractType: $ref: '#/definitions/Target' x-discriminator: targetType AllEventsTrigger: description: Triggers when any Event fires. properties: triggerType: enum: - AllEventsTrigger - SpecificEventTrigger type: string required: - triggerType x-abstractType: $ref: '#/definitions/Trigger' x-discriminator: triggerType RoleDetailsResponse: properties: data: $ref: '#/definitions/Role_2' readOnly: true errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/Role_2' x-usedIn: - /global/roles/ - /global/roles/{roleId}/ - /global/roles/{roleId}/actions/deprecate/ Trigger: discriminator: triggerType properties: triggerType: enum: - AllEventsTrigger - SpecificEventTrigger type: string required: - triggerType x-concreteTypes: - $ref: '#/definitions/AllEventsTrigger' - $ref: '#/definitions/SpecificEventTrigger' LocalScriptAction: properties: actionType: enum: - ScalrScriptAction - RemoteScriptAction - ChefAction - LocalScriptAction - AnsibleTowerAction type: string path: description: Path to the script to execute. type: string required: - actionType - path x-abstractType: $ref: '#/definitions/Action' x-discriminator: actionType Role: properties: builtinAutomation: items: enum: - base - chef - mysql - percona - postgresql - redis - apache - nginx - tomcat - haproxy - rabbitmq - memcached type: string type: array category: $ref: '#/definitions/RoleCategoryForeignKey' deprecated: $ref: '#/definitions/RoleDeprecatedOptions' description: The deprecation options associated with this Role. readOnly: true description: type: string id: readOnly: true type: integer name: type: string os: $ref: '#/definitions/OsForeignKey' quickStart: description: Whether this Role is a QuickStart Role. type: boolean quickStartGroup: description: The name of the QuickStart Group. type: string scope: enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string tags: description: The list of tags that should be applied to the Role. items: type: string type: array useScalrAgent: description: Whether this Role uses Scalarizr, the Scalr agent. type: boolean required: - name - category - os x-createOnly: - useScalrAgent - builtinAutomation - os x-filterable: - id - name - os - category - scope - quickStart - quickStartGroup - useScalrAgent - builtinAutomation x-usedIn: - /account/{accountId}/roles/{roleId}/ - /account/{accountId}/roles/{roleId}/actions/clone/ - /account/{accountId}/roles/{roleId}/actions/deprecate/ - /account/{accountId}/roles/{roleId}/images/ - /account/{accountId}/roles/{roleId}/images/{imageId}/ - /account/{accountId}/roles/{roleId}/images/{imageId}/actions/replace/ - /account/{accountId}/roles/{roleId}/global-variables/ - /account/{accountId}/roles/{roleId}/global-variables/{globalVariableName}/ - /account/{accountId}/roles/{roleId}/orchestration-rules/ - /account/{accountId}/roles/{roleId}/orchestration-rules/{orchestrationRuleId}/ VmwareImageCloudFeatures: description: Cloud specifics Image configuration. properties: type: enum: - AwsImageCloudFeatures - VmwareImageCloudFeatures - OpenstackImageCloudFeatures type: string vCenterHost: description: The vCenter host where the current Image exists. At the Environment scope this property is read-only. type: string required: - type x-abstractType: $ref: '#/definitions/ImageCloudFeatures' x-discriminator: type AccountRole: properties: allowedEnvironments: description: List of allowed Environments accessible to this Role. items: $ref: '#/definitions/EnvironmentForeignKey' type: array builtinAutomation: items: enum: - base - chef - mysql - percona - postgresql - redis - apache - nginx - tomcat - haproxy - rabbitmq - memcached type: string type: array category: $ref: '#/definitions/RoleCategoryForeignKey' deprecated: $ref: '#/definitions/RoleDeprecatedOptions' description: The deprecation options associated with this Role. readOnly: true description: type: string id: readOnly: true type: integer name: type: string os: $ref: '#/definitions/OsForeignKey' quickStart: description: Whether this Role is a QuickStart Role. type: boolean quickStartGroup: description: The name of the QuickStart Group. type: string restrictedAccess: description: It restricts access to the Role except of allowed Environments. type: boolean scope: enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string tags: description: The list of tags that should be applied to the Role. items: type: string type: array useScalrAgent: description: Whether this Role uses Scalarizr, the Scalr agent. type: boolean required: - name - category - os x-createOnly: - useScalrAgent - builtinAutomation - os x-derived: $ref: '#/definitions/Role' x-filterable: - id - name - os - category - scope - quickStart - quickStartGroup - useScalrAgent - builtinAutomation - restrictedAccess x-references: $ref: '#/definitions/Role' x-usedIn: - /account/{accountId}/roles/ - /account/{accountId}/roles/{roleId}/ OsForeignKey: properties: id: description: An ID uniquely identifying this OS in Scalr. type: string required: - id x-derived: $ref: '#/definitions/Os' x-references: $ref: '#/definitions/Os' ScalrScriptAction: properties: actionType: enum: - ScalrScriptAction - RemoteScriptAction - ChefAction - LocalScriptAction - AnsibleTowerAction type: string scriptVersion: $ref: '#/definitions/ScriptVersionIdentity' description: ScriptVersion to execute. required: - actionType - scriptVersion x-abstractType: $ref: '#/definitions/Action' x-discriminator: actionType OrchestrationRule: properties: action: $ref: '#/definitions/Action' description: Orchestration Rule action that will be executed on the target servers. blocking: description: Whether this Orchestration Rule's execution should delay the execution of further Orchestration Rules and the triggering of further Events. Defaults to the action's default when null. type: boolean enabled: default: true description: If Orchestration Rule is not enabled this Rule won't be triggered. type: boolean id: description: Unique identifier for an Orchestration Rule. maxLength: 36 minLength: 36 pattern: '[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}' readOnly: true type: string order: description: The priority of this Orchestration Rule relative to other Orchestration Rules that use the same triggeringEvent. Default is relative to existing Rules. type: integer runAs: description: User the Orchestration Rule should execute as. Defaults to root / Administrator when null. type: string scope: enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string target: $ref: '#/definitions/Target' description: The set of Servers where the Orchestration Rules Action will be executed. timeout: description: The time Scalr should wait for before aborting the execution of this Orchestration Rule, in seconds. Defaults to the action's default when null. type: integer trigger: $ref: '#/definitions/Trigger' description: Orchestration Rule trigger. required: - trigger - action - target x-filterable: - id - blocking - order - runAs x-usedIn: - /account/{accountId}/orchestration-rules/ - /account/{accountId}/orchestration-rules/{orchestrationRuleId}/ - /account/{accountId}/roles/{roleId}/orchestration-rules/ - /account/{accountId}/roles/{roleId}/orchestration-rules/{orchestrationRuleId}/ GlobalVariableJson: properties: category: description: The category of this Global Variable. type: string computedValue: description: The value computed by Scalr for this Global Variable. readOnly: true type: string declaredIn: description: The Scope in which this Global Variable is declared. enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string definedIn: description: The Scope in which this Global Variable is given a value. enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string description: description: A description that explains what this Global Variable is used for. type: string hidden: description: Whether this Global Variable is hidden in inner scopes. This is read-only if `declaredIn` is not the current scope. type: boolean locked: description: Whether this Global Variable is locked in inner scopes. This is read-only if `declaredIn` is not the current scope. type: boolean name: type: string requiredIn: description: The scope where this Global Variable is required. This is read-only if `declaredIn` is not the current scope. enum: - scalr - account - environment - farm - farmrole - role - server type: string type: description: The type of Global Variable. enum: - GlobalVariableJson - GlobalVariableString - GlobalVariableList - GlobalVariableRemoteList type: string value: description: The value declared in the current scope for this Global Variable. If it is null, the value will be inherited from higher scopes. This field is ignored if `declaredIn` is not the current scope. type: string required: - name - type x-abstractType: $ref: '#/definitions/GlobalVariable' x-createOnly: - name x-discriminator: type Role_3: properties: builtinAutomation: items: enum: - base - chef - mysql - percona - postgresql - redis - apache - nginx - tomcat - haproxy - rabbitmq - memcached type: string type: array category: $ref: '#/definitions/RoleCategoryForeignKey' deprecated: $ref: '#/definitions/RoleDeprecatedOptions' description: The deprecation options associated with this Role. readOnly: true description: type: string id: readOnly: true type: integer name: description: The name of the Role. type: string os: $ref: '#/definitions/OsForeignKey' quickStart: description: Whether this Role is a QuickStart Role. type: boolean quickStartGroup: description: The name of the QuickStart Group. type: string scope: enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string tags: description: The list of tags that should be applied to the Role. items: type: string type: array useScalrAgent: description: Whether this Role uses Scalarizr, the Scalr agent. type: boolean required: - name - category - os x-createOnly: - useScalrAgent - builtinAutomation - os x-filterable: - id - name - os - category - scope - quickStart - quickStartGroup - useScalrAgent - builtinAutomation x-usedIn: - /user/{envId}/roles/ - /user/{envId}/roles/{roleId}/ - /user/{envId}/roles/{roleId}/actions/promote/ - /user/{envId}/roles/{roleId}/actions/clone/ - /user/{envId}/roles/{roleId}/actions/deprecate/ - /user/{envId}/roles/{roleId}/images/ - /user/{envId}/roles/{roleId}/images/{imageId}/ - /user/{envId}/roles/{roleId}/images/{imageId}/actions/replace/ - /user/{envId}/roles/{roleId}/global-variables/ - /user/{envId}/roles/{roleId}/global-variables/{globalVariableName}/ - /user/{envId}/roles/{roleId}/orchestration-rules/ - /user/{envId}/roles/{roleId}/orchestration-rules/{orchestrationRuleId}/ GlobalVariableListResponse: properties: data: items: $ref: '#/definitions/GlobalVariable' readOnly: true type: array errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true pagination: $ref: '#/definitions/ApiPagination' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/GlobalVariable' x-usedIn: - /account/{accountId}/global-variables/ - /account/{accountId}/roles/{roleId}/global-variables/ OrchestrationRuleListResponse_3: properties: data: items: $ref: '#/definitions/OrchestrationRule_3' readOnly: true type: array errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true pagination: $ref: '#/definitions/ApiPagination' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/OrchestrationRule_3' x-usedIn: - /user/{envId}/orchestration-rules/ - /user/{envId}/roles/{roleId}/orchestration-rules/ - /user/{envId}/farm-roles/{farmRoleId}/orchestration-rules/ ApiMessage: properties: code: description: A machine-readable representation of the message. type: string message: description: A human-readable representation of the message. type: string GlobalVariableDetailsResponse_2: properties: data: $ref: '#/definitions/GlobalVariable_2' readOnly: true errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/GlobalVariable_2' x-usedIn: - /global/global-variables/ - /global/global-variables/{globalVariableName}/ - /global/roles/{roleId}/global-variables/ - /global/roles/{roleId}/global-variables/{globalVariableName}/ RoleDetailsResponse_2: properties: data: $ref: '#/definitions/Role_3' readOnly: true errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/Role_3' x-usedIn: - /user/{envId}/roles/ - /user/{envId}/roles/{roleId}/ - /user/{envId}/roles/{roleId}/actions/promote/ - /user/{envId}/roles/{roleId}/actions/clone/ - /user/{envId}/roles/{roleId}/actions/deprecate/ RoleListResponse: properties: data: items: $ref: '#/definitions/Role_2' readOnly: true type: array errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true pagination: $ref: '#/definitions/ApiPagination' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/Role_2' x-usedIn: - /global/roles/ GlobalVariable: discriminator: type properties: category: description: The category of this Global Variable. type: string computedValue: description: The value computed by Scalr for this Global Variable. readOnly: true type: string declaredIn: description: The Scope in which this Global Variable is declared. enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string definedIn: description: The Scope in which this Global Variable is given a value. enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string description: description: A description that explains what this Global Variable is used for. type: string hidden: description: Whether this Global Variable is hidden in inner scopes. This is read-only if `declaredIn` is not the current scope. type: boolean locked: description: Whether this Global Variable is locked in inner scopes. This is read-only if `declaredIn` is not the current scope. type: boolean name: type: string requiredIn: description: The scope where this Global Variable is required. This is read-only if `declaredIn` is not the current scope. enum: - scalr - account - environment - farm - farmrole - role - server type: string type: description: The type of Global Variable. enum: - GlobalVariableJson - GlobalVariableString - GlobalVariableList - GlobalVariableRemoteList type: string value: description: The value declared in the current scope for this Global Variable. If it is null, the value will be inherited from higher scopes. This field is ignored if `declaredIn` is not the current scope. type: string required: - name - type x-concreteTypes: - $ref: '#/definitions/GlobalVariableString' - $ref: '#/definitions/GlobalVariableJson' - $ref: '#/definitions/GlobalVariableList' - $ref: '#/definitions/GlobalVariableRemoteList' x-createOnly: - name x-usedIn: - /account/{accountId}/global-variables/ - /account/{accountId}/global-variables/{globalVariableName}/ - /account/{accountId}/roles/{roleId}/global-variables/ - /account/{accountId}/roles/{roleId}/global-variables/{globalVariableName}/ ImageDetailsResponse_3: properties: data: $ref: '#/definitions/Image_3' readOnly: true errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/Image_3' x-usedIn: - /user/{envId}/roles/{roleId}/images/{imageId}/ - /user/{envId}/images/ - /user/{envId}/images/{imageId}/ - /user/{envId}/images/{imageId}/actions/copy/ TagsCondition: properties: tags: description: Selects all the Servers that belong to the Role with at least one tag from this list. items: type: string type: array type: description: Orchestration rule condition type. Selected only those servers that match conditions. enum: - FarmRolesCondition - OsCondition - TagsCondition type: string required: - type - tags x-abstractType: $ref: '#/definitions/OrchestrationRuleCondition' x-discriminator: type ScriptVariableList: properties: allowedValues: description: The list of values to which the Global Variable value must correspond. items: $ref: '#/definitions/VariableAllowedValue' type: array category: description: The category of this Variable. type: string description: description: A description that explains what this Global Variable is used for. type: string hidden: description: Whether this Script Variable is hidden in Orchestration Rules or execute Script action. type: boolean locked: description: Whether this Script Variable value is locked in Orchestration Rules or execute Script action. type: boolean name: description: The Variable name. type: string required: description: Whether this Script Variable value is required in Orchestration Rules or execute Script action. type: boolean type: description: The type of Script Variable. enum: - ScriptVariableJson - ScriptVariableString - ScriptVariableList - ScriptVariableRemoteList type: string value: description: The value declared in the script level. This property can be redefined for not locked variables in Orhestration Rules or execute Script action. Also this field supports Global Variable interpolation. type: string required: - name - type - allowedValues x-abstractType: $ref: '#/definitions/ScriptVariable' x-createOnly: - name x-discriminator: type Role_2: properties: builtinAutomation: items: enum: - base - chef - mysql - percona - postgresql - redis - apache - nginx - tomcat - haproxy - rabbitmq - memcached type: string type: array category: $ref: '#/definitions/RoleCategoryForeignKey' deprecated: $ref: '#/definitions/RoleDeprecatedOptions' description: The deprecation options associated with this Role. readOnly: true description: type: string id: readOnly: true type: integer name: type: string os: $ref: '#/definitions/OsForeignKey' quickStart: description: Whether this Role is a QuickStart Role. type: boolean quickStartGroup: description: The name of the QuickStart Group. type: string scope: enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string tags: description: The list of tags that should be applied to the Role. items: type: string type: array useScalrAgent: description: Whether this Role uses Scalarizr, the Scalr agent. type: boolean required: - name - category - os x-createOnly: - useScalrAgent - builtinAutomation - os x-filterable: - id - name - os - category - scope - quickStart - quickStartGroup - useScalrAgent - builtinAutomation x-usedIn: - /global/roles/ - /global/roles/{roleId}/ - /global/roles/{roleId}/actions/deprecate/ - /global/roles/{roleId}/images/ - /global/roles/{roleId}/images/{imageId}/ - /global/roles/{roleId}/images/{imageId}/actions/replace/ - /global/roles/{roleId}/global-variables/ - /global/roles/{roleId}/global-variables/{globalVariableName}/ - /global/roles/{roleId}/orchestration-rules/ - /global/roles/{roleId}/orchestration-rules/{orchestrationRuleId}/ GlobalVariableListResponse_3: properties: data: items: $ref: '#/definitions/GlobalVariable_3' readOnly: true type: array errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true pagination: $ref: '#/definitions/ApiPagination' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/GlobalVariable_3' x-usedIn: - /user/{envId}/global-variables/ - /user/{envId}/roles/{roleId}/global-variables/ - /user/{envId}/servers/{serverId}/global-variables/ - /user/{envId}/farms/{farmId}/global-variables/ - /user/{envId}/farm-roles/{farmRoleId}/global-variables/ Environment: properties: added: format: date-time readOnly: true type: string costCenter: $ref: '#/definitions/CostCenterForeignKey' id: readOnly: true type: integer name: type: string status: enum: - active - inactive type: string type: default: cmp enum: - cmp - iacp type: string required: - name x-createOnly: - type x-filterable: - id - name - added - status - type - costCenter x-usedIn: - /account/{accountId}/environments/ - /account/{accountId}/environments/{envId}/ Os: properties: family: description: OS family. type: string generation: type: string id: description: An ID uniquely identifying this OS in Scalr. pattern: '[A-Za-z0-9-]+' type: string name: description: A human-readable name for this OS. type: string version: type: string required: - id - name - family - generation - version x-filterable: - id - name - family - generation x-usedIn: - /account/{accountId}/os/{osId}/ GlobalVariable_3: discriminator: type properties: category: description: The category of this Global Variable. type: string computedValue: description: The value computed by Scalr for this Global Variable. readOnly: true type: string declaredIn: description: The Scope in which this Global Variable is declared. enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string definedIn: description: The Scope in which this Global Variable is given a value. enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string description: description: A description that explains what this Global Variable is used for. type: string hidden: description: Whether this Global Variable is hidden in inner scopes. This is read-only if `declaredIn` is not the current scope. type: boolean locked: description: Whether this Global Variable is locked in inner scopes. This is read-only if `declaredIn` is not the current scope. type: boolean name: type: string requiredIn: description: The scope where this Global Variable is required. This is read-only if `declaredIn` is not the current scope. enum: - scalr - account - environment - farm - farmrole - role - server type: string type: description: The type of Global Variable. enum: - GlobalVariableJson - GlobalVariableString - GlobalVariableList - GlobalVariableRemoteList type: string value: description: The value declared in the current scope for this Global Variable. If it is null, the value will be inherited from higher scopes. This field is ignored if `declaredIn` is not the current scope. type: string required: - name - type x-concreteTypes: - $ref: '#/definitions/GlobalVariableString' - $ref: '#/definitions/GlobalVariableJson' - $ref: '#/definitions/GlobalVariableList' - $ref: '#/definitions/GlobalVariableRemoteList' x-createOnly: - name x-usedIn: - /user/{envId}/global-variables/ - /user/{envId}/global-variables/{globalVariableName}/ - /user/{envId}/roles/{roleId}/global-variables/ - /user/{envId}/roles/{roleId}/global-variables/{globalVariableName}/ - /user/{envId}/servers/{serverId}/global-variables/ - /user/{envId}/servers/{serverId}/global-variables/{globalVariableName}/ - /user/{envId}/farms/{farmId}/global-variables/ - /user/{envId}/farms/{farmId}/global-variables/{globalVariableName}/ - /user/{envId}/farm-roles/{farmRoleId}/global-variables/ - /user/{envId}/farm-roles/{farmRoleId}/global-variables/{globalVariableName}/ AnsibleTowerConfigurationIdentity: properties: id: description: The Ansible Tower configuration identifier. maxLength: 36 minLength: 36 pattern: '[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}' type: string name: description: The Ansible Tower configuration name. type: string RoleImage: description: A Representation of a Role Image. Note that the `role` property is optional when POST-ing to a URL that already includes `{roleId}`. properties: image: $ref: '#/definitions/ImageForeignKey' role: $ref: '#/definitions/RoleForeignKey' required: - role - image x-filterable: - role - image x-usedIn: - /account/{accountId}/roles/{roleId}/images/ - /account/{accountId}/roles/{roleId}/images/{imageId}/actions/replace/ ApiErrorResponse: description: Common response for erroneous requests. properties: errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-usedIn: - /account/{accountId}/global-variables/ - /account/{accountId}/global-variables/{globalVariableName}/ - /account/{accountId}/orchestration-rules/ - /account/{accountId}/orchestration-rules/{orchestrationRuleId}/ - /account/{accountId}/cost-centers/ - /account/{accountId}/cost-centers/{costCenterId}/ - /account/{accountId}/environments/ - /account/{accountId}/environments/{envId}/ - /account/{accountId}/environments/{envId}/clouds/ - /account/{accountId}/environments/{envId}/clouds/{cloud}/ - /account/{accountId}/environments/{envId}/teams/ - /account/{accountId}/environments/{envId}/teams/{teamId}/ - /account/{accountId}/teams/ - /account/{accountId}/teams/{teamId}/ - /account/{accountId}/acl-roles/ - /account/{accountId}/role-categories/ - /account/{accountId}/role-categories/{roleCategoryId}/ - /account/{accountId}/roles/ - /account/{accountId}/roles/{roleId}/ - /account/{accountId}/roles/{roleId}/actions/clone/ - /account/{accountId}/roles/{roleId}/actions/deprecate/ - /account/{accountId}/roles/{roleId}/images/ - /account/{accountId}/roles/{roleId}/images/{imageId}/ - /account/{accountId}/roles/{roleId}/images/{imageId}/actions/replace/ - /account/{accountId}/roles/{roleId}/global-variables/ - /account/{accountId}/roles/{roleId}/global-variables/{globalVariableName}/ - /account/{accountId}/roles/{roleId}/orchestration-rules/ - /account/{accountId}/roles/{roleId}/orchestration-rules/{orchestrationRuleId}/ - /account/{accountId}/images/ - /account/{accountId}/images/{imageId}/ - /account/{accountId}/images/{imageId}/actions/copy/ - /account/{accountId}/images/{imageId}/actions/replace/ - /account/{accountId}/projects/ - /account/{accountId}/projects/{projectId}/ - /account/{accountId}/scripts/ - /account/{accountId}/scripts/{scriptId}/ - /account/{accountId}/scripts/{scriptId}/script-versions/ - /account/{accountId}/scripts/{scriptId}/script-versions/{scriptVersionNumber}/ - /account/{accountId}/webhook-endpoints/ - /account/{accountId}/os/ - /account/{accountId}/os/{osId}/ - /account/{accountId}/events/ - /account/{accountId}/events/{eventId}/ - /account/{accountId}/cloud-credentials/ - /account/{accountId}/cloud-credentials/{cloudCredentialsId}/ - /account/{accountId}/scaling-metrics/ - /account/{accountId}/scaling-metrics/{metricName}/ - /account/{accountId}/users/ - /account/{accountId}/ansible-tower/servers/ - /account/{accountId}/ansible-tower/configurations/ - /account/{accountId}/ansible-tower/configurations/{ansibleTowerConfigurationId}/ GlobalVariableDetailsResponse_3: properties: data: $ref: '#/definitions/GlobalVariable_3' readOnly: true errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/GlobalVariable_3' x-usedIn: - /user/{envId}/global-variables/ - /user/{envId}/global-variables/{globalVariableName}/ - /user/{envId}/roles/{roleId}/global-variables/ - /user/{envId}/roles/{roleId}/global-variables/{globalVariableName}/ - /user/{envId}/servers/{serverId}/global-variables/ - /user/{envId}/servers/{serverId}/global-variables/{globalVariableName}/ - /user/{envId}/farms/{farmId}/global-variables/ - /user/{envId}/farms/{farmId}/global-variables/{globalVariableName}/ - /user/{envId}/farm-roles/{farmRoleId}/global-variables/ - /user/{envId}/farm-roles/{farmRoleId}/global-variables/{globalVariableName}/ Image: properties: added: description: Date and time at which this Image was created. format: date-time readOnly: true type: string architecture: enum: - i386 - x86_64 type: string cloudFeatures: $ref: '#/definitions/ImageCloudFeatures' cloudImageId: type: string cloudInitInstalled: description: Whether cloud-init is installed on this Image. type: boolean cloudLocation: description: 'Cloud Location, inside a given Cloud Platform, for this resource. May be null if this resource does not have a specific location. Note: if you would like to filter on this property, you **must** also filter on `cloudPlatform`.' type: string cloudPlatform: description: The Cloud Platform this resource resides in. enum: - ec2 - gce type: string deprecated: description: Whether this Image is deprecated. type: boolean id: maxLength: 36 minLength: 36 pattern: '[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}' readOnly: true type: string lastUsed: description: Date and time at which this Image was last used. format: date-time readOnly: true type: string name: type: string os: $ref: '#/definitions/OsForeignKey' scalrAgentInstalled: description: Whether Scalr Agent is installed on this Image. type: boolean scope: enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string size: description: Size of the image in GB. This property is read-only at the Environment scope. type: integer source: description: Indicates how this Image was created. enum: - Manual - BundleTask readOnly: true type: string status: description: Current status for this Image. `failed` means that the deletion failed. enum: - active - pending_delete - failed readOnly: true type: string statusError: description: If the Image is in a failed state, this indicates why. readOnly: true type: string type: description: (Only used on EC2 currently) Whether this Image is HVM or EBS. At the Environment scope this property is read-only. Property is deprecated and will be removed soon. Use 'cloudFeatures' instead. type: string required: - name - cloudPlatform - cloudImageId - architecture - os x-createOnly: - cloudImageId - size - type - scalrAgentInstalled - cloudInitInstalled - cloudLocation - cloudPlatform - os - architecture - cloudFeatures x-filterable: - id - name - scope - cloudPlatform - cloudLocation - cloudImageId - architecture - source - status - deprecated - os - scalrAgentInstalled - cloudInitInstalled x-usedIn: - /account/{accountId}/roles/{roleId}/images/{imageId}/ - /account/{accountId}/roles/{roleId}/images/{imageId}/actions/replace/ - /account/{accountId}/images/ - /account/{accountId}/images/{imageId}/ - /account/{accountId}/images/{imageId}/actions/copy/ - /account/{accountId}/images/{imageId}/actions/replace/ ApiMetaContainer: properties: sample: description: Actual properties TBD. type: string AwsImageCloudFeatures: description: Cloud specifics Image configuration. properties: accountId: description: AWS account ID type: string type: enum: - AwsImageCloudFeatures - VmwareImageCloudFeatures - OpenstackImageCloudFeatures type: string virtualization: description: 'The Image virtualization type. Can be one of two types of virtualization: paravirtual (pv) or hardware virtual machine (hvm). At the Environment scope this property is read-only.' enum: - hvm - paravirtual type: string required: - type x-abstractType: $ref: '#/definitions/ImageCloudFeatures' x-discriminator: type ScriptIdentity: properties: id: type: integer name: description: The name of the Script. type: string required: - id x-derived: $ref: '#/definitions/Script' x-references: $ref: '#/definitions/Script' RoleImageListResponse_2: properties: data: items: $ref: '#/definitions/RoleImage_2' readOnly: true type: array errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true pagination: $ref: '#/definitions/ApiPagination' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/RoleImage_2' x-usedIn: - /global/roles/{roleId}/images/ ScriptVariableString: properties: category: description: The category of this Variable. type: string description: description: A description that explains what this Global Variable is used for. type: string hidden: description: Whether this Script Variable is hidden in Orchestration Rules or execute Script action. type: boolean locked: description: Whether this Script Variable value is locked in Orchestration Rules or execute Script action. type: boolean name: description: The Variable name. type: string outputFormat: description: The formatting to apply when displaying this variable. type: string required: description: Whether this Script Variable value is required in Orchestration Rules or execute Script action. type: boolean type: description: The type of Script Variable. enum: - ScriptVariableJson - ScriptVariableString - ScriptVariableList - ScriptVariableRemoteList type: string validationPattern: description: The validation regular expresion to validate the value. type: string value: description: The value declared in the script level. This property can be redefined for not locked variables in Orhestration Rules or execute Script action. Also this field supports Global Variable interpolation. type: string required: - name - type x-abstractType: $ref: '#/definitions/ScriptVariable' x-createOnly: - name x-discriminator: type VariableAllowedValue: properties: label: description: The Global Variable Value label type: string value: description: The Global Variable value type: string required: - value RoleImage_2: description: A Representation of a Role Image. Note that the `role` property is optional when POST-ing to a URL that already includes `{roleId}`. properties: image: $ref: '#/definitions/ImageForeignKey' role: $ref: '#/definitions/RoleForeignKey' required: - role - image x-filterable: - role - image x-usedIn: - /global/roles/{roleId}/images/ - /global/roles/{roleId}/images/{imageId}/actions/replace/ GlobalVariableDetailsResponse: properties: data: $ref: '#/definitions/GlobalVariable' readOnly: true errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/GlobalVariable' x-usedIn: - /account/{accountId}/global-variables/ - /account/{accountId}/global-variables/{globalVariableName}/ - /account/{accountId}/roles/{roleId}/global-variables/ - /account/{accountId}/roles/{roleId}/global-variables/{globalVariableName}/ Script: properties: added: format: date-time readOnly: true type: string blockingDefault: description: Whether this Script is blocking by default. This can be overridden in the Orchestration Rules that use this Script. type: boolean deprecated: default: false description: Whether the Script is deprecated. type: boolean description: type: string id: readOnly: true type: integer lastChanged: format: date-time readOnly: true type: string name: description: The name of the Script. type: string osType: description: Type of OS this Script should execute on. This will influence Orchestration Rules, and will impact the validation rules applied to the ScriptVersions. enum: - linux - windows - cross-platform type: string requireAdminPrivileges: default: false description: Whether the Script requires root/Administrator privileges to be executed. type: boolean scope: enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string tags: description: The list of tags that should be applied to the Script. items: type: string type: array timeoutDefault: description: The time after which Scalr will abort the execution of this Script, in seconds. This can be overridden in the Orchestration Rules that use this Script. type: integer variables: description: The list of redefined script variables for the current script. items: $ref: '#/definitions/ScriptVariable' type: array required: - name - osType x-createOnly: - osType x-filterable: - id - name - osType - blockingDefault - scope - deprecated - requireAdminPrivileges x-usedIn: - /account/{accountId}/scripts/ - /account/{accountId}/scripts/{scriptId}/ - /account/{accountId}/scripts/{scriptId}/script-versions/ - /account/{accountId}/scripts/{scriptId}/script-versions/{scriptVersionNumber}/ RoleCategoryForeignKey: properties: id: description: Identifier of the Role Category. type: integer required: - id x-derived: $ref: '#/definitions/RoleCategory' x-references: $ref: '#/definitions/RoleCategory' GlobalVariableListResponse_2: properties: data: items: $ref: '#/definitions/GlobalVariable_2' readOnly: true type: array errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true pagination: $ref: '#/definitions/ApiPagination' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/GlobalVariable_2' x-usedIn: - /global/global-variables/ - /global/roles/{roleId}/global-variables/ RoleImage_3: description: A Representation of a Role Image. Note that the `role` property is optional when POST-ing to a URL that already includes `{roleId}`. properties: image: $ref: '#/definitions/ImageForeignKey' role: $ref: '#/definitions/RoleForeignKey' required: - role - image x-filterable: - role - image x-usedIn: - /user/{envId}/roles/{roleId}/images/ - /user/{envId}/roles/{roleId}/images/{imageId}/actions/replace/ Event: properties: description: type: string id: description: The name of this Custom Event. maxLength: 25 pattern: '[A-Za-z0-9]+' type: string scope: enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string required: - id x-createOnly: - id x-filterable: - id - scope x-usedIn: - /account/{accountId}/events/ - /account/{accountId}/events/{eventId}/ OrchestrationRuleListResponse_2: properties: data: items: $ref: '#/definitions/OrchestrationRule_2' readOnly: true type: array errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true pagination: $ref: '#/definitions/ApiPagination' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/OrchestrationRule_2' x-usedIn: - /global/roles/{roleId}/orchestration-rules/ Image_2: properties: added: description: Date and time at which this Image was created. format: date-time readOnly: true type: string architecture: enum: - i386 - x86_64 type: string cloudFeatures: $ref: '#/definitions/ImageCloudFeatures' cloudImageId: type: string cloudInitInstalled: description: Whether cloud-init is installed on this Image. type: boolean cloudLocation: description: 'Cloud Location, inside a given Cloud Platform, for this resource. May be null if this resource does not have a specific location. Note: if you would like to filter on this property, you **must** also filter on `cloudPlatform`.' type: string cloudPlatform: description: The Cloud Platform this resource resides in. enum: - ec2 - gce - azure - cloudstack - idcf - openstack - ocs - otc - rackspacenguk - rackspacengus - hpcloud - mirantis - vio - cisco - vmware type: string deprecated: description: Whether this Image is deprecated. type: boolean id: maxLength: 36 minLength: 36 pattern: '[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}' readOnly: true type: string lastUsed: description: Date and time at which this Image was last used. format: date-time readOnly: true type: string name: type: string os: $ref: '#/definitions/OsForeignKey' scalrAgentInstalled: description: Whether Scalr Agent is installed on this Image. type: boolean scope: enum: - scalr - account - environment - farm - farmrole - role - server readOnly: true type: string size: description: Size of the image in GB. This property is read-only at the Environment scope. type: integer source: description: Indicates how this Image was created. enum: - Manual - BundleTask readOnly: true type: string status: description: Current status for this Image. `failed` means that the deletion failed. enum: - active - pending_delete - failed readOnly: true type: string statusError: description: If the Image is in a failed state, this indicates why. readOnly: true type: string type: description: (Only used on EC2 currently) Whether this Image is HVM or EBS. At the Environment scope this property is read-only. Property is deprecated and will be removed soon. Use 'cloudFeatures' instead. type: string required: - name - cloudPlatform - cloudImageId - architecture - os x-createOnly: - cloudImageId - size - type - scalrAgentInstalled - cloudInitInstalled - cloudLocation - cloudPlatform - os - architecture - cloudFeatures x-filterable: - id - name - scope - cloudPlatform - cloudLocation - cloudImageId - architecture - source - status - deprecated - os - scalrAgentInstalled - cloudInitInstalled x-usedIn: - /global/roles/{roleId}/images/{imageId}/ - /global/roles/{roleId}/images/{imageId}/actions/replace/ - /global/images/ - /global/images/{imageId}/ - /global/images/{imageId}/actions/copy/ - /global/images/{imageId}/actions/replace/ SpecificEventTrigger: description: Triggers when a specific Event fires. properties: event: $ref: '#/definitions/EventForeignKey' triggerType: enum: - AllEventsTrigger - SpecificEventTrigger type: string required: - triggerType - event x-abstractType: $ref: '#/definitions/Trigger' x-discriminator: triggerType ScriptVariableJson: properties: category: description: The category of this Variable. type: string description: description: A description that explains what this Global Variable is used for. type: string hidden: description: Whether this Script Variable is hidden in Orchestration Rules or execute Script action. type: boolean locked: description: Whether this Script Variable value is locked in Orchestration Rules or execute Script action. type: boolean name: description: The Variable name. type: string required: description: Whether this Script Variable value is required in Orchestration Rules or execute Script action. type: boolean type: description: The type of Script Variable. enum: - ScriptVariableJson - ScriptVariableString - ScriptVariableList - ScriptVariableRemoteList type: string value: description: The value declared in the script level. This property can be redefined for not locked variables in Orhestration Rules or execute Script action. Also this field supports Global Variable interpolation. type: string required: - name - type x-abstractType: $ref: '#/definitions/ScriptVariable' x-createOnly: - name x-discriminator: type JobTemplateIdentity: properties: id: description: The Ansible Tower Job template identifier. type: integer name: description: The Ansible Tower Job template name. type: string scmBranch: description: The Ansible Tower Job template SCM Branch. type: string ScriptVariableValue: properties: name: description: The Variable name. type: string value: description: The redefined value declared in the Script level. type: string required: - name OrchestrationRuleDetailsResponse_3: properties: data: $ref: '#/definitions/OrchestrationRule_3' readOnly: true errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/OrchestrationRule_3' x-usedIn: - /user/{envId}/orchestration-rules/ - /user/{envId}/orchestration-rules/{orchestrationRuleId}/ - /user/{envId}/roles/{roleId}/orchestration-rules/ - /user/{envId}/roles/{roleId}/orchestration-rules/{orchestrationRuleId}/ - /user/{envId}/farm-roles/{farmRoleId}/orchestration-rules/ - /user/{envId}/farm-roles/{farmRoleId}/orchestration-rules/{orchestrationRuleId}/ WebhookEndpointForeignKey: properties: id: description: Webhook endpoint identifier. type: string required: - id x-derived: $ref: '#/definitions/WebhookEndpoint' x-references: $ref: '#/definitions/WebhookEndpoint' OrchestrationRuleDetailsResponse: properties: data: $ref: '#/definitions/OrchestrationRule' readOnly: true errors: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array meta: $ref: '#/definitions/ApiMetaContainer' readOnly: true warnings: items: $ref: '#/definitions/ApiMessage' readOnly: true type: array x-derived: $ref: '#/definitions/OrchestrationRule' x-usedIn: - /account/{accountId}/orchestration-rules/ - /account/{accountId}/orchestration-rules/{orchestrationRuleId}/ - /account/{accountId}/roles/{roleId}/orchestration-rules/ - /account/{accountId}/roles/{roleId}/orchestration-rules/{orchestrationRuleId}/ x-dry-yaml-definitions: architecture: enum: - i386 - x86_64 type: string cloudLocationProperties: cloudLocation: description: 'Cloud Location, inside a given Cloud Platform, for this resource. May be null if this resource does not have a specific location. Note: if you would like to filter on this property, you **must** also filter on `cloudPlatform`.' type: string cloudPlatform: description: The Cloud Platform this resource resides in. enum: - ec2 - gce type: string cloudstackProvider: description: Cloud provider that should be specified for CloudStack based clouds. enum: - cloudstack - idcf type: string openstackProvider: description: Cloud provider that should be specified for OpenStack based clouds. enum: - openstack - ocs - hpcloud - mirantis - vio - cisco type: string pathParamsPatterns: uuid: maxLength: 36 minLength: 36 pattern: '[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}' uuidShort: maxLength: 12 minLength: 12 pattern: '[A-Fa-f0-9]+' scopeProperty: enum: - scalr - account - environment - farm - farmrole - role - server type: string