Skip to main content

aws

The aws scope controls the interactions with AWS, including AWS Batch and S3.

aws.accessKey

AWS account access key.

aws.profile

AWS profile from ~/.aws/credentials.

aws.region

AWS region (e.g. us-east-1).

aws.secretKey

AWS account secret key.

aws.batch.cliPath

The path where the AWS command line tool is installed in the host AMI.

aws.batch.delayBetweenAttempts

Delay between download attempts from S3 (default: 10 sec).

aws.batch.executionRole

The AWS Batch Execution Role ARN that needs to be used to execute the Batch Job. It is mandatory when using AWS Fargate.

aws.batch.forceGlacierTransfer
Added in version 26.04

When true, add the --force-glacier-transfer flag to AWS CLI S3 download commands (default: false).

This option is needed when staging directories that have been restored from S3 Glacier. It does not restore objects from Glacier.

aws.batch.jobRole

The AWS Batch Job Role ARN that needs to be used to execute the Batch Job.

aws.batch.logsGroup

The name of the logs group used by Batch Jobs (default: /aws/batch/job).

aws.batch.maxParallelTransfers

Max parallel upload/download transfer operations per job (default: 4).

aws.batch.maxSpotAttempts
Changed in version 24.10

The default value was changed from 5 to 0.

Max number of execution attempts of a job interrupted by a EC2 Spot reclaim event (default: 0)

aws.batch.maxTransferAttempts

Max number of downloads attempts from S3 (default: 1).

aws.batch.platformType

The compute platform type used by AWS Batch. Can be either ec2 or fargate. Set to fargate to use AWS Fargate.

aws.batch.retryMode

The retry mode used to handle rate-limiting by AWS APIs. Can be one of standard, legacy, adaptive, or built-in (default: standard).

aws.batch.schedulingPriority

The scheduling priority for all tasks when using fair-share scheduling (default: 0).

aws.batch.shareIdentifier

The share identifier for all tasks when using fair-share scheduling.

aws.batch.terminateUnschedulableJobs
Added in version 25.04

When true, jobs that cannot be scheduled due to lack of resources or misconfiguration are terminated and handled as task failures (default: false).

aws.batch.volumes

List of container mounts. Mounts can be specified as simple e.g. /some/path or canonical format e.g. /host/path:/mount/path[:ro|rw].

aws.client.anonymous

Allow the access of public S3 buckets without providing AWS credentials (default: false). Any service that does not accept unsigned requests will return a service access error.

aws.client.connectionTimeout

The amount of time to wait (in milliseconds) when initially establishing a connection before timing out (default: 10000).

aws.client.endpoint

The AWS S3 API entry point e.g. https://s3-us-west-1.amazonaws.com. The endpoint must include the protocol prefix e.g. https://.

aws.client.maxConnections

The maximum number of open HTTP connections used by the S3 client (default: 50).

aws.client.maxDownloadHeapMemory

The maximum size for the heap memory buffer used by concurrent downloads. It must be at least 10 times the minimumPartSize (default:400 MB).

aws.client.maxErrorRetry

The maximum number of retry attempts for failed retryable requests (default: -1).

aws.client.minimumPartSize
Added in version 25.10

The minimum part size used for multipart S3 transfers (default: 8 MB).

aws.client.multipartThreshold
Added in version 25.10

The object size threshold used for multipart S3 transfers (default: same as aws.cllient.minimumPartSize).

aws.client.protocol
Deprecated in version 25.10

This option is no longer supported.

The protocol to use when connecting to AWS. Can be http or https (default: 'https').

aws.client.proxyHost

The proxy host to connect through.

aws.client.proxyPassword

The password to use when connecting through a proxy.

aws.client.proxyPort

The port to use when connecting through a proxy.

aws.client.proxyScheme
Added in version 25.10

The protocol scheme to use when connecting through a proxy. Can be http or https (default: 'http').

aws.client.proxyUsername

The user name to use when connecting through a proxy.

aws.client.requesterPays
Added in version 25.10

Use Requester Pays for S3 buckets (default: false).

aws.client.s3Acl

Specify predefined bucket permissions, also known as canned ACL. Can be one of Private, PublicRead, PublicReadWrite, AuthenticatedRead, LogDeliveryWrite, BucketOwnerRead, BucketOwnerFullControl, or AwsExecRead.

aws.client.s3PathStyleAccess

Use the path-based access model to access objects in S3-compatible storage systems (default: false).

aws.client.signerOverride
Deprecated in version 25.10

This option is no longer supported.

The name of the signature algorithm to use for signing requests made by the client.

aws.client.socketSendBufferSizeHint
Deprecated in version 25.10

This option is no longer supported.

The size hint (in bytes) for the low level TCP send buffer (default: 0).

aws.client.socketRecvBufferSizeHint
Deprecated in version 25.10

This option is no longer supported.

The size hint (in bytes) for the low level TCP receive buffer (default: 0).

aws.client.socketTimeout
Changed in version 25.10

The default socket timeout changed from 50000 to 30000.

The amount of time to wait (in milliseconds) for data to be transferred over an established, open connection before the connection is timed out (default: 30000).

aws.client.storageClass

The S3 storage class applied to stored objects. Can be STANDARD, STANDARD_IA, ONEZONE_IA, or INTELLIGENT_TIERING (default: STANDARD).

aws.client.storageEncryption

The S3 server side encryption to be used when saving objects on S3. Can be AES256 or aws:kms (default: none).

aws.client.storageKmsKeyId

The AWS KMS key Id to be used to encrypt files stored in the target S3 bucket.

aws.client.targetThroughputInGbps
Added in version 25.10

The target network throughput (in Gbps) used for S3 uploads and downloads (default: 10).

aws.client.userAgent
Deprecated in version 25.10

This option is no longer supported.

The HTTP user agent header passed with all HTTP requests.

aws.client.uploadChunkSize
Deprecated in version 25.10

This option is no longer supported.

The size of a single part in a multipart upload (default: 100 MB).

aws.client.uploadMaxAttempts
Deprecated in version 25.10

This option is no longer supported.

The maximum number of upload attempts after which a multipart upload returns an error (default: 5).

aws.client.uploadMaxThreads
Deprecated in version 25.10

This option is no longer supported.

The maximum number of threads used for multipart upload (default: 10).

aws.client.uploadRetrySleep
Deprecated in version 25.10

This option is no longer supported.

The time to wait after a failed upload attempt to retry the part upload (default: 500ms).

aws.client.uploadStorageClass

The S3 storage class applied to stored objects. Can be STANDARD, STANDARD_IA, ONEZONE_IA, or INTELLIGENT_TIERING (default: STANDARD).

On this Page