describeEvents method
Describes events for a specified server. Results are ordered by time, with newest events first.
This operation is synchronous.
A ResourceNotFoundException
is thrown when the server does
not exist. A ValidationException
is raised when parameters of
the request are not valid.
May throw ValidationException. May throw InvalidNextTokenException. May throw ResourceNotFoundException.
Parameter serverName
:
The name of the server for which you want to view events.
Parameter maxResults
:
To receive a paginated response, use this parameter to specify the maximum
number of results to be returned with a single call. If the number of
available results exceeds this maximum, the response includes a
NextToken
value that you can assign to the
NextToken
request parameter to get the next set of results.
Parameter nextToken
:
NextToken is a string that is returned in some command responses. It
indicates that not all entries have been returned, and that you must run
at least one more request to get remaining items. To get remaining
results, call DescribeEvents
again, and assign the token from
the previous results as the value of the nextToken
parameter.
If there are no more results, the response object's nextToken
parameter value is null
. Setting a nextToken
value that was not returned in your previous results causes an
InvalidNextTokenException
to occur.
Implementation
Future<DescribeEventsResponse> describeEvents({
required String serverName,
int? maxResults,
String? nextToken,
}) async {
ArgumentError.checkNotNull(serverName, 'serverName');
_s.validateStringLength(
'serverName',
serverName,
1,
40,
isRequired: true,
);
_s.validateNumRange(
'maxResults',
maxResults,
1,
1152921504606846976,
);
_s.validateStringLength(
'nextToken',
nextToken,
0,
10000,
);
final headers = <String, String>{
'Content-Type': 'application/x-amz-json-1.1',
'X-Amz-Target': 'OpsWorksCM_V2016_11_01.DescribeEvents'
};
final jsonResponse = await _protocol.send(
method: 'POST',
requestUri: '/',
exceptionFnMap: _exceptionFns,
// TODO queryParams
headers: headers,
payload: {
'ServerName': serverName,
if (maxResults != null) 'MaxResults': maxResults,
if (nextToken != null) 'NextToken': nextToken,
},
);
return DescribeEventsResponse.fromJson(jsonResponse.body);
}