Roles / Images: Create
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.
HTTP Request
POST /api/v1beta0/global/roles/roleId/images/
Parameters
Name | Required | Description | Location |
---|---|---|---|
roleId integer |
Yes | The ID of a Role object. |
path |
Request body
The JSON representation of a RoleImage object.
The body must be a valid RoleImage object. Example value:
{
"image": {
"id": "string"
},
"role": {
"id": 1
}
}
Successful Response (Status 201)
The JSON representation of a RoleImage object.
The API replies with a RoleImageDetailsResponse object. Example response body:
{
"data": {
"image": {
"id": "string"
},
"role": {
"id": 1
}
},
"errors": [
{
"code": "string",
"message": "string"
}
],
"meta": {
"sample": "string"
},
"warnings": [
{
"code": "string",
"message": "string"
}
]
}
Other Response Messages
HTTP Status Code | Reason | Response Model |
---|---|---|
400 | A client-side error was made. |
An ApiErrorResponse object |
401 | The request was not authenticated. |
An ApiErrorResponse object |
403 | Insufficient permissions. |
An ApiErrorResponse object |
404 | Resource not found. |
An ApiErrorResponse object |
409 | Conflict with current state. |
An ApiErrorResponse object |
422 | This request was well-formed but was rejected due to semantic errors. |
An ApiErrorResponse object |
500 | A server-side error occurred. |
An ApiErrorResponse object |
501 | This feature is not implemented in Scalr. |
An ApiErrorResponse object |
503 | The service is currently unavailable. |
An ApiErrorResponse object |