testRole method
The TestRole operation tests the IAM role used to create the pipeline.
The TestRole
action lets you determine whether the IAM role
you are using has sufficient permissions to let Elastic Transcoder perform
tasks associated with the transcoding process. The action attempts to
assume the specified IAM role, checks read access to the input and output
buckets, and tries to send a test notification to Amazon SNS topics that
you specify.
May throw ValidationException. May throw IncompatibleVersionException. May throw ResourceNotFoundException. May throw AccessDeniedException. May throw InternalServiceException.
Parameter inputBucket
:
The Amazon S3 bucket that contains media files to be transcoded. The
action attempts to read from this bucket.
Parameter outputBucket
:
The Amazon S3 bucket that Elastic Transcoder writes transcoded media files
to. The action attempts to read from this bucket.
Parameter role
:
The IAM Amazon Resource Name (ARN) for the role that you want Elastic
Transcoder to test.
Parameter topics
:
The ARNs of one or more Amazon Simple Notification Service (Amazon SNS)
topics that you want the action to send a test notification to.
Implementation
@Deprecated('Deprecated')
Future<TestRoleResponse> testRole({
required String inputBucket,
required String outputBucket,
required String role,
required List<String> topics,
}) async {
ArgumentError.checkNotNull(inputBucket, 'inputBucket');
ArgumentError.checkNotNull(outputBucket, 'outputBucket');
ArgumentError.checkNotNull(role, 'role');
ArgumentError.checkNotNull(topics, 'topics');
final $payload = <String, dynamic>{
'InputBucket': inputBucket,
'OutputBucket': outputBucket,
'Role': role,
'Topics': topics,
};
final response = await _protocol.send(
payload: $payload,
method: 'POST',
requestUri: '/2012-09-25/roleTests',
exceptionFnMap: _exceptionFns,
);
return TestRoleResponse.fromJson(response);
}