amazonka-transcribe-2.0: Amazon Transcribe Service SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.Transcribe.Types.JobExecutionSettings

Description

 
Synopsis

Documentation

data JobExecutionSettings Source #

Makes it possible to control how your transcription job is processed. Currently, the only JobExecutionSettings modification you can choose is enabling job queueing using the AllowDeferredExecution sub-parameter.

If you include JobExecutionSettings in your request, you must also include the sub-parameters: AllowDeferredExecution and DataAccessRoleArn.

See: newJobExecutionSettings smart constructor.

Constructors

JobExecutionSettings' 

Fields

  • allowDeferredExecution :: Maybe Bool

    Makes it possible to enable job queuing when your concurrent request limit is exceeded. When AllowDeferredExecution is set to true, transcription job requests are placed in a queue until the number of jobs falls below the concurrent request limit. If AllowDeferredExecution is set to false and the number of transcription job requests exceed the concurrent request limit, you get a LimitExceededException error.

    Note that job queuing is enabled by default for Call Analytics jobs.

    If you include AllowDeferredExecution in your request, you must also include DataAccessRoleArn.

  • dataAccessRoleArn :: Maybe Text

    The Amazon Resource Name (ARN) of an IAM role that has permissions to access the Amazon S3 bucket that contains your input files. If the role that you specify doesn’t have the appropriate permissions to access the specified Amazon S3 location, your request fails.

    IAM role ARNs have the format arn:partition:iam::account:role/role-name-with-path. For example: arn:aws:iam::111122223333:role/Admin. For more information, see IAM ARNs.

    Note that if you include DataAccessRoleArn in your request, you must also include AllowDeferredExecution.

Instances

Instances details
FromJSON JobExecutionSettings Source # 
Instance details

Defined in Amazonka.Transcribe.Types.JobExecutionSettings

ToJSON JobExecutionSettings Source # 
Instance details

Defined in Amazonka.Transcribe.Types.JobExecutionSettings

Generic JobExecutionSettings Source # 
Instance details

Defined in Amazonka.Transcribe.Types.JobExecutionSettings

Associated Types

type Rep JobExecutionSettings :: Type -> Type #

Read JobExecutionSettings Source # 
Instance details

Defined in Amazonka.Transcribe.Types.JobExecutionSettings

Show JobExecutionSettings Source # 
Instance details

Defined in Amazonka.Transcribe.Types.JobExecutionSettings

NFData JobExecutionSettings Source # 
Instance details

Defined in Amazonka.Transcribe.Types.JobExecutionSettings

Methods

rnf :: JobExecutionSettings -> () #

Eq JobExecutionSettings Source # 
Instance details

Defined in Amazonka.Transcribe.Types.JobExecutionSettings

Hashable JobExecutionSettings Source # 
Instance details

Defined in Amazonka.Transcribe.Types.JobExecutionSettings

type Rep JobExecutionSettings Source # 
Instance details

Defined in Amazonka.Transcribe.Types.JobExecutionSettings

type Rep JobExecutionSettings = D1 ('MetaData "JobExecutionSettings" "Amazonka.Transcribe.Types.JobExecutionSettings" "amazonka-transcribe-2.0-4BjJqzwmm0K94bsEMe1tnF" 'False) (C1 ('MetaCons "JobExecutionSettings'" 'PrefixI 'True) (S1 ('MetaSel ('Just "allowDeferredExecution") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "dataAccessRoleArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))))

newJobExecutionSettings :: JobExecutionSettings Source #

Create a value of JobExecutionSettings with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:allowDeferredExecution:JobExecutionSettings', jobExecutionSettings_allowDeferredExecution - Makes it possible to enable job queuing when your concurrent request limit is exceeded. When AllowDeferredExecution is set to true, transcription job requests are placed in a queue until the number of jobs falls below the concurrent request limit. If AllowDeferredExecution is set to false and the number of transcription job requests exceed the concurrent request limit, you get a LimitExceededException error.

Note that job queuing is enabled by default for Call Analytics jobs.

If you include AllowDeferredExecution in your request, you must also include DataAccessRoleArn.

$sel:dataAccessRoleArn:JobExecutionSettings', jobExecutionSettings_dataAccessRoleArn - The Amazon Resource Name (ARN) of an IAM role that has permissions to access the Amazon S3 bucket that contains your input files. If the role that you specify doesn’t have the appropriate permissions to access the specified Amazon S3 location, your request fails.

IAM role ARNs have the format arn:partition:iam::account:role/role-name-with-path. For example: arn:aws:iam::111122223333:role/Admin. For more information, see IAM ARNs.

Note that if you include DataAccessRoleArn in your request, you must also include AllowDeferredExecution.

jobExecutionSettings_allowDeferredExecution :: Lens' JobExecutionSettings (Maybe Bool) Source #

Makes it possible to enable job queuing when your concurrent request limit is exceeded. When AllowDeferredExecution is set to true, transcription job requests are placed in a queue until the number of jobs falls below the concurrent request limit. If AllowDeferredExecution is set to false and the number of transcription job requests exceed the concurrent request limit, you get a LimitExceededException error.

Note that job queuing is enabled by default for Call Analytics jobs.

If you include AllowDeferredExecution in your request, you must also include DataAccessRoleArn.

jobExecutionSettings_dataAccessRoleArn :: Lens' JobExecutionSettings (Maybe Text) Source #

The Amazon Resource Name (ARN) of an IAM role that has permissions to access the Amazon S3 bucket that contains your input files. If the role that you specify doesn’t have the appropriate permissions to access the specified Amazon S3 location, your request fails.

IAM role ARNs have the format arn:partition:iam::account:role/role-name-with-path. For example: arn:aws:iam::111122223333:role/Admin. For more information, see IAM ARNs.

Note that if you include DataAccessRoleArn in your request, you must also include AllowDeferredExecution.