Returns an array of JobListEntry objects of the specified length. Each JobListEntry object is for a job in the specified cluster and contains a job's state, a job's ID, and other information.
Parameters:
-
cluster_id
(ClusterId)
–
The 39-character ID for the cluster that you want to list, for example CID123e4567-e89b-12d3-a456-426655440000.
-
max_results
(Optional[ListLimit], default:
None
)
–
The number of JobListEntry objects to return.
-
next_token
(Optional[String], default:
None
)
–
HTTP requests are stateless. To identify what object comes "next" in the list of JobListEntry objects, you have the option of specifying NextToken as the starting point for your returned list.
Raises:
-
InvalidNextTokenException
–
The NextToken string was altered unexpectedly, and the operation has stopped. Run the operation without changing the NextToken string, and try again.
-
InvalidResourceException
–
The specified resource can't be found. Check the information you provided in your last request, and try again.
-
UnknownServiceError
–
The service returned an error code this client does not model.
Source code in docs_src/capo_snowball/_services/snowball.py
| def list_cluster_jobs(
self,
cluster_id: "capo_snowball.types.cluster_id.ClusterId",
*,
config_overrides: Optional[SnowballClientConfig] = None,
max_results: Optional["capo_snowball.types.list_limit.ListLimit"] = None,
next_token: Optional["capo_snowball.types.string.String"] = None,
) -> "capo_snowball.types.list_cluster_jobs_result.ListClusterJobsResult":
"""<p>Returns an array of <code>JobListEntry</code> objects of the specified length. Each <code>JobListEntry</code> object is for a job in the specified cluster and contains a job's state, a job's ID, and other information.</p>
Args:
cluster_id: <p>The 39-character ID for the cluster that you want to list, for example <code>CID123e4567-e89b-12d3-a456-426655440000</code>.</p>
max_results: <p>The number of <code>JobListEntry</code> objects to return.</p>
next_token: <p>HTTP requests are stateless. To identify what object comes "next" in the list of <code>JobListEntry</code> objects, you have the option of specifying <code>NextToken</code> as the starting point for your returned list.</p>
Raises:
capo_snowball.errors.invalid_next_token_exception.InvalidNextTokenException: <p>The <code>NextToken</code> string was altered unexpectedly, and the operation has stopped. Run the operation without changing the <code>NextToken</code> string, and try again.</p>
capo_snowball.errors.invalid_resource_exception.InvalidResourceException: <p>The specified resource can't be found. Check the information you provided in your last request, and try again.</p>
capo_snowball.errors.UnknownServiceError: The service returned an error code this client does not model.
"""
def _handler(
req: "OperationRequest[capo_snowball.types.list_cluster_jobs_request.ListClusterJobsRequest]",
) -> OperationResponse[
"capo_snowball.types.list_cluster_jobs_result.ListClusterJobsResult"
]:
import capo_snowball._operations.awsie_snowball_job_management_service.list_cluster_jobs
output, http_response = (
capo_snowball._operations.awsie_snowball_job_management_service.list_cluster_jobs.list_cluster_jobs(
req.options, req.input
)
)
return OperationResponse(output=output, response=http_response)
interceptors_, options_ = self.operation_options(
config_overrides, OperationLogging("ListClusterJobs")
)
input_: capo_snowball.types.list_cluster_jobs_request.ListClusterJobsRequest = {
"cluster_id": cluster_id
}
if max_results is not None:
input_["max_results"] = max_results
if next_token is not None:
input_["next_token"] = next_token
response = execute_pipeline(
OperationRequest(input=input_, options=options_),
handler=_handler,
interceptors=list(interceptors_),
)
response.response.close()
return response.output
|