AWS CLI Command Reference

Note:

You are viewing the documentation for an older major version of the AWS CLI (version 1).

AWS CLI version 2, the latest major version of AWS CLI, is now stable and recommended for general use. To view this page for the AWS CLI version 2, click here. For more information see the AWS CLI version 2 installation instructions and migration guide.

[ aws . emr-containers ]

create-job-template

Description

Creates a job template. Job template stores values of StartJobRun API request in a template and can be used to start a job run. Job template allows two use cases: avoid repeating recurring StartJobRun API request values, enforcing certain values in StartJobRun API request.

See also: AWS API Documentation

Synopsis

  create-job-template
--name <value>
[--client-token <value>]
--job-template-data <value>
[--tags <value>]
[--kms-key-arn <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]

Options

--name (string)

The specified name of the job template.

--client-token (string)

The client token of the job template.

--job-template-data (structure)

The job template data which holds values of StartJobRun API request.

executionRoleArn -> (string)

The execution role ARN of the job run.

releaseLabel -> (string)

The release version of Amazon EMR.

configurationOverrides -> (structure)

The configuration settings that are used to override defaults configuration.

applicationConfiguration -> (list)

The configurations for the application running by the job run.

(structure)

A configuration specification to be used when provisioning virtual clusters, which can include configurations for applications and software bundled with Amazon EMR on EKS. A configuration consists of a classification, properties, and optional nested configurations. A classification refers to an application-specific configuration file. Properties are the settings you want to change in that file.

classification -> (string)

The classification within a configuration.

properties -> (map)

A set of properties specified within a configuration classification.

key -> (string)

value -> (string)

configurations -> (list)

A list of additional configurations to apply within a configuration object.

(structure)

A configuration specification to be used when provisioning virtual clusters, which can include configurations for applications and software bundled with Amazon EMR on EKS. A configuration consists of a classification, properties, and optional nested configurations. A classification refers to an application-specific configuration file. Properties are the settings you want to change in that file.

classification -> (string)

The classification within a configuration.

properties -> (map)

A set of properties specified within a configuration classification.

key -> (string)

value -> (string)

monitoringConfiguration -> (structure)

The configurations for monitoring.

persistentAppUI -> (string)

Monitoring configurations for the persistent application UI.

cloudWatchMonitoringConfiguration -> (structure)

Monitoring configurations for CloudWatch.

logGroupName -> (string)

The name of the log group for log publishing.

logStreamNamePrefix -> (string)

The specified name prefix for log streams.

s3MonitoringConfiguration -> (structure)

Amazon S3 configuration for monitoring log publishing.

logUri -> (string)

Amazon S3 destination URI for log publishing.

jobDriver -> (structure)

Specify the driver that the job runs on. Exactly one of the two available job drivers is required, either sparkSqlJobDriver or sparkSubmitJobDriver.

sparkSubmitJobDriver -> (structure)

The job driver parameters specified for spark submit.

entryPoint -> (string)

The entry point of job application.

entryPointArguments -> (list)

The arguments for job application.

(string)

sparkSubmitParameters -> (string)

The Spark submit parameters that are used for job runs.

sparkSqlJobDriver -> (structure)

The job driver for job type.

entryPoint -> (string)

The SQL file to be executed.

sparkSqlParameters -> (string)

The Spark parameters to be included in the Spark SQL command.

parameterConfiguration -> (map)

The configuration of parameters existing in the job template.

key -> (string)

value -> (structure)

The configuration of a job template parameter.

type -> (string)

The type of the job template parameter. Allowed values are: ‘STRING’, ‘NUMBER’.

defaultValue -> (string)

The default value for the job template parameter.

jobTags -> (map)

The tags assigned to jobs started using the job template.

key -> (string)

value -> (string)

JSON Syntax:

{
  "executionRoleArn": "string",
  "releaseLabel": "string",
  "configurationOverrides": {
    "applicationConfiguration": [
      {
        "classification": "string",
        "properties": {"string": "string"
          ...},
        "configurations": [
          {
            "classification": "string",
            "properties": {"string": "string"
              ...},
            "configurations":
          }
          ...
        ]
      }
      ...
    ],
    "monitoringConfiguration": {
      "persistentAppUI": "string",
      "cloudWatchMonitoringConfiguration": {
        "logGroupName": "string",
        "logStreamNamePrefix": "string"
      },
      "s3MonitoringConfiguration": {
        "logUri": "string"
      }
    }
  },
  "jobDriver": {
    "sparkSubmitJobDriver": {
      "entryPoint": "string",
      "entryPointArguments": ["string", ...],
      "sparkSubmitParameters": "string"
    },
    "sparkSqlJobDriver": {
      "entryPoint": "string",
      "sparkSqlParameters": "string"
    }
  },
  "parameterConfiguration": {"string": {
        "type": "NUMBER"|"STRING",
        "defaultValue": "string"
      }
    ...},
  "jobTags": {"string": "string"
    ...}
}

--tags (map)

The tags that are associated with the job template.

key -> (string)

value -> (string)

Shorthand Syntax:

KeyName1=string,KeyName2=string

JSON Syntax:

{"string": "string"
  ...}

--kms-key-arn (string)

The KMS key ARN used to encrypt the job template.

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

Global Options

--debug (boolean)

Turn on debug logging.

--endpoint-url (string)

Override command's default URL with the given URL.

--no-verify-ssl (boolean)

By default, the AWS CLI uses SSL when communicating with AWS services. For each SSL connection, the AWS CLI will verify SSL certificates. This option overrides the default behavior of verifying SSL certificates.

--no-paginate (boolean)

Disable automatic pagination.

--output (string)

The formatting style for command output.

  • json
  • text
  • table

--query (string)

A JMESPath query to use in filtering the response data.

--profile (string)

Use a specific profile from your credential file.

--region (string)

The region to use. Overrides config/env settings.

--version (string)

Display the version of this tool.

--color (string)

Turn on/off color output.

  • on
  • off
  • auto

--no-sign-request (boolean)

Do not sign requests. Credentials will not be loaded if this argument is provided.

--ca-bundle (string)

The CA certificate bundle to use when verifying SSL certificates. Overrides config/env settings.

--cli-read-timeout (int)

The maximum socket read time in seconds. If the value is set to 0, the socket read will be blocking and not timeout. The default value is 60 seconds.

--cli-connect-timeout (int)

The maximum socket connect time in seconds. If the value is set to 0, the socket connect will be blocking and not timeout. The default value is 60 seconds.

Output

id -> (string)

This output display the created job template ID.

name -> (string)

This output displays the name of the created job template.

arn -> (string)

This output display the ARN of the created job template.

createdAt -> (timestamp)

This output displays the date and time when the job template was created.