[ aws . emr-serverless ]

get-job-run

Description

Displays detailed information about a job run.

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Synopsis

  get-job-run
--application-id <value>
--job-run-id <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]

Options

--application-id (string)

The ID of the application on which the job run is submitted.

--job-run-id (string)

The ID of the job run.

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those 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. This may not be specified along with --cli-input-yaml.

--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. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See ‘aws help’ for descriptions of global parameters.

Output

jobRun -> (structure)

The output displays information about the job run.

applicationId -> (string)

The ID of the application the job is running on.

jobRunId -> (string)

The ID of the job run.

name -> (string)

The optional job run name. This doesn’t have to be unique.

arn -> (string)

The execution role ARN of the job run.

createdBy -> (string)

The user who created the job run.

createdAt -> (timestamp)

The date and time when the job run was created.

updatedAt -> (timestamp)

The date and time when the job run was updated.

executionRole -> (string)

The execution role ARN of the job run.

state -> (string)

The state of the job run.

stateDetails -> (string)

The state details of the job run.

releaseLabel -> (string)

The EMR release version associated with the application your job is running on.

configurationOverrides -> (structure)

The configuration settings that are used to override default configuration.

applicationConfiguration -> (list)

The override configurations for the application.

(structure)

A configuration specification to be used when provisioning an application. 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 an application. 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 override configurations for monitoring.

s3MonitoringConfiguration -> (structure)

The Amazon S3 configuration for monitoring log publishing.

logUri -> (string)

The Amazon S3 destination URI for log publishing.

encryptionKeyArn -> (string)

The KMS key ARN to encrypt the logs published to the given Amazon S3 destination.

managedPersistenceMonitoringConfiguration -> (structure)

The managed log persistence configuration for a job run.

enabled -> (boolean)

Enables managed logging and defaults to true. If set to false, managed logging will be turned off.

encryptionKeyArn -> (string)

The KMS key ARN to encrypt the logs stored in managed log persistence.

jobDriver -> (structure)

The job driver for the job run.

sparkSubmit -> (structure)

The job driver parameters specified for Spark.

entryPoint -> (string)

The entry point for the Spark submit job run.

entryPointArguments -> (list)

The arguments for the Spark submit job run.

(string)

sparkSubmitParameters -> (string)

The parameters for the Spark submit job run.

hive -> (structure)

The job driver parameters specified for Hive.

query -> (string)

The query for the Hive job run.

initQueryFile -> (string)

The query file for the Hive job run.

parameters -> (string)

The parameters for the Hive job run.

tags -> (map)

The tags assigned to the job run.

key -> (string)

value -> (string)

totalResourceUtilization -> (structure)

The aggregate vCPU, memory, and storage resources used from the time job start executing till the time job is terminated, rounded up to the nearest second.

vCPUHour -> (double)

The aggregated vCPU used per hour from the time job start executing till the time job is terminated.

memoryGBHour -> (double)

The aggregated memory used per hour from the time job start executing till the time job is terminated.

storageGBHour -> (double)

The aggregated storage used per hour from the time job start executing till the time job is terminated.

networkConfiguration -> (structure)

The network configuration for customer VPC connectivity.

subnetIds -> (list)

The array of subnet Ids for customer VPC connectivity.

(string)

securityGroupIds -> (list)

The array of security group Ids for customer VPC connectivity.

(string)

totalExecutionDurationSeconds -> (integer)

The job run total execution duration in seconds. This field is only available for job runs in a COMPLETED , FAILED , or CANCELLED state.