describeRcsAgents method

Future<DescribeRcsAgentsResult> describeRcsAgents({
  1. List<RcsAgentFilter>? filters,
  2. int? maxResults,
  3. String? nextToken,
  4. Owner? owner,
  5. List<String>? rcsAgentIds,
})

Retrieves the specified RCS agents or all RCS agents associated with your Amazon Web Services account.

If you specify RCS agent IDs, the output includes information for only the specified RCS agents. If you specify filters, the output includes information for only those RCS agents that meet the filter criteria. If you don't specify RCS agent IDs or filters, the output includes information for all RCS agents.

May throw AccessDeniedException. May throw InternalServerException. May throw ResourceNotFoundException. May throw ThrottlingException. May throw ValidationException.

Parameter filters : An array of RcsAgentFilter objects to filter the results.

Parameter maxResults : The maximum number of results to return per each request.

Parameter nextToken : The token to be used for the next set of paginated results. You don't need to supply a value for this field in the initial request.

Parameter owner : Use SELF to filter the list of RCS agents to ones your account owns or use SHARED to filter on RCS agents shared with your account. The Owner and RcsAgentIds parameters can't be used at the same time.

Parameter rcsAgentIds : An array of unique identifiers for the RCS agents. This is an array of strings that can be either the RcsAgentId or RcsAgentArn.

Implementation

Future<DescribeRcsAgentsResult> describeRcsAgents({
  List<RcsAgentFilter>? filters,
  int? maxResults,
  String? nextToken,
  Owner? owner,
  List<String>? rcsAgentIds,
}) async {
  _s.validateNumRange(
    'maxResults',
    maxResults,
    1,
    100,
  );
  final headers = <String, String>{
    'Content-Type': 'application/x-amz-json-1.0',
    'X-Amz-Target': 'PinpointSMSVoiceV2.DescribeRcsAgents'
  };
  final jsonResponse = await _protocol.send(
    method: 'POST',
    requestUri: '/',
    exceptionFnMap: _exceptionFns,
    // TODO queryParams
    headers: headers,
    payload: {
      if (filters != null) 'Filters': filters,
      if (maxResults != null) 'MaxResults': maxResults,
      if (nextToken != null) 'NextToken': nextToken,
      if (owner != null) 'Owner': owner.value,
      if (rcsAgentIds != null) 'RcsAgentIds': rcsAgentIds,
    },
  );

  return DescribeRcsAgentsResult.fromJson(jsonResponse.body);
}