SearchWorkers
Searches for workers.
Request Syntax
POST /2023-10-12/farms/farmId
/search/workers HTTP/1.1
Content-type: application/json
{
"filterExpressions": {
"filters": [
{ ... }
],
"operator": "string
"
},
"fleetIds": [ "string
" ],
"itemOffset": number
,
"pageSize": number
,
"sortExpressions": [
{ ... }
]
}
URI Request Parameters
The request uses the following URI parameters.
- farmId
-
The farm ID in the workers search.
Pattern:
farm-[0-9a-f]{32}
Required: Yes
Request Body
The request accepts the following data in JSON format.
- filterExpressions
-
The filter expression,
AND
orOR
, to use when searching among a group of search strings in a resource. You can use two groupings per search each within parenthesis()
.Type: SearchGroupedFilterExpressions object
Required: No
- fleetIds
-
The fleet ID of the workers to search for.
Type: Array of strings
Array Members: Minimum number of 1 item. Maximum number of 10 items.
Pattern:
fleet-[0-9a-f]{32}
Required: Yes
- itemOffset
-
Defines how far into the scrollable list to start the return of results.
Type: Integer
Valid Range: Minimum value of 0. Maximum value of 10000.
Required: Yes
- pageSize
-
Specifies the number of items per page for the resource.
Type: Integer
Valid Range: Minimum value of 1. Maximum value of 100.
Required: No
- sortExpressions
-
The search terms for a resource.
Type: Array of SearchSortExpression objects
Array Members: Minimum number of 1 item. Maximum number of 5 items.
Required: No
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"nextItemOffset": number,
"totalResults": number,
"workers": [
{
"createdAt": "string",
"createdBy": "string",
"fleetId": "string",
"hostProperties": {
"ec2InstanceArn": "string",
"ec2InstanceType": "string",
"hostName": "string",
"ipAddresses": {
"ipV4Addresses": [ "string" ],
"ipV6Addresses": [ "string" ]
}
},
"status": "string",
"updatedAt": "string",
"updatedBy": "string",
"workerId": "string"
}
]
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- nextItemOffset
-
The next incremental starting point after the defined
itemOffset
.Type: Integer
Valid Range: Minimum value of 0. Maximum value of 10000.
- totalResults
-
The total number of results in the search.
Type: Integer
Valid Range: Minimum value of 0. Maximum value of 10000.
- workers
-
The workers for the search.
Type: Array of WorkerSearchSummary objects
Errors
For information about the errors that are common to all actions, see Common Errors.
- AccessDeniedException
-
You don't have permission to perform the action.
HTTP Status Code: 403
- InternalServerErrorException
-
Deadline Cloud can't process your request right now. Try again later.
HTTP Status Code: 500
- ResourceNotFoundException
-
The requested resource can't be found.
HTTP Status Code: 404
- ThrottlingException
-
Your request exceeded a request rate quota.
HTTP Status Code: 429
- ValidationException
-
The request isn't valid. This can occur if your request contains malformed JSON or unsupported characters.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: