Amazon EMR Containers 2020-10-01
- Client: Aws\EMRContainers\EMRContainersClient
- Service ID: emr-containers
- Version: 2020-10-01
This page describes the parameters and results for the operations of the Amazon EMR Containers (2020-10-01), and shows how to use the Aws\EMRContainers\EMRContainersClient object to call the described operations. This documentation is specific to the 2020-10-01 API version of the service.
Operation Summary
Each of the following operations can be created from a client using
$client->getCommand('CommandName'), where "CommandName" is the
name of one of the following operations. Note: a command is a value that
encapsulates an operation and the parameters used to create an HTTP request.
You can also create and send a command immediately using the magic methods
available on a client object: $client->commandName(/* parameters */).
You can send the command asynchronously (returning a promise) by appending the
word "Async" to the operation name: $client->commandNameAsync(/* parameters */).
- CancelJobRun ( array $params = [] )
Cancels a job run.
- CreateManagedEndpoint ( array $params = [] )
Creates a managed endpoint.
- CreateVirtualCluster ( array $params = [] )
Creates a virtual cluster.
- DeleteManagedEndpoint ( array $params = [] )
Deletes a managed endpoint.
- DeleteVirtualCluster ( array $params = [] )
Deletes a virtual cluster.
- DescribeJobRun ( array $params = [] )
Displays detailed information about a job run.
- DescribeManagedEndpoint ( array $params = [] )
Displays detailed information about a managed endpoint.
- DescribeVirtualCluster ( array $params = [] )
Displays detailed information about a specified virtual cluster.
- ListJobRuns ( array $params = [] )
Lists job runs based on a set of parameters.
- ListManagedEndpoints ( array $params = [] )
Lists managed endpoints based on a set of parameters.
- ListTagsForResource ( array $params = [] )
Lists the tags assigned to the resources.
- ListVirtualClusters ( array $params = [] )
Lists information about the specified virtual cluster.
- StartJobRun ( array $params = [] )
Starts a job run.
- TagResource ( array $params = [] )
Assigns tags to resources.
- UntagResource ( array $params = [] )
Removes tags from resources.
Paginators
Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:
Operations
CancelJobRun
$result = $client->cancelJobRun([/* ... */]); $promise = $client->cancelJobRunAsync([/* ... */]);
Cancels a job run. A job run is a unit of work, such as a Spark jar, PySpark script, or SparkSQL query, that you submit to Amazon EMR on EKS.
Parameter Syntax
$result = $client->cancelJobRun([
'id' => '<string>', // REQUIRED
'virtualClusterId' => '<string>', // REQUIRED
]);
Parameter Details
Members
Result Syntax
[
'id' => '<string>',
'virtualClusterId' => '<string>',
]
Result Details
Members
Errors
-
There are invalid parameters in the client request.
-
This is an internal server exception.
CreateManagedEndpoint
$result = $client->createManagedEndpoint([/* ... */]); $promise = $client->createManagedEndpointAsync([/* ... */]);
Creates a managed endpoint. A managed endpoint is a gateway that connects EMR Studio to Amazon EMR on EKS so that EMR Studio can communicate with your virtual cluster.
Parameter Syntax
$result = $client->createManagedEndpoint([
'certificateArn' => '<string>', // REQUIRED
'clientToken' => '<string>', // REQUIRED
'configurationOverrides' => [
'applicationConfiguration' => [
[
'classification' => '<string>', // REQUIRED
'configurations' => [...], // RECURSIVE
'properties' => ['<string>', ...],
],
// ...
],
'monitoringConfiguration' => [
'cloudWatchMonitoringConfiguration' => [
'logGroupName' => '<string>', // REQUIRED
'logStreamNamePrefix' => '<string>',
],
'persistentAppUI' => 'ENABLED|DISABLED',
's3MonitoringConfiguration' => [
'logUri' => '<string>', // REQUIRED
],
],
],
'executionRoleArn' => '<string>', // REQUIRED
'name' => '<string>', // REQUIRED
'releaseLabel' => '<string>', // REQUIRED
'tags' => ['<string>', ...],
'type' => '<string>', // REQUIRED
'virtualClusterId' => '<string>', // REQUIRED
]);
Parameter Details
Members
- certificateArn
-
- Required: Yes
- Type: string
The certificate ARN of the managed endpoint.
- clientToken
-
- Required: Yes
- Type: string
The client idempotency token for this create call.
- configurationOverrides
-
- Type: ConfigurationOverrides structure
The configuration settings that will be used to override existing configurations.
- executionRoleArn
-
- Required: Yes
- Type: string
The ARN of the execution role.
- name
-
- Required: Yes
- Type: string
The name of the managed endpoint.
- releaseLabel
-
- Required: Yes
- Type: string
The Amazon EMR release version.
- tags
-
- Type: Associative array of custom strings keys (String128) to strings
The tags of the managed endpoint.
- type
-
- Required: Yes
- Type: string
The type of the managed endpoint.
- virtualClusterId
-
- Required: Yes
- Type: string
The ID of the virtual cluster for which a managed endpoint is created.
Result Syntax
[
'arn' => '<string>',
'id' => '<string>',
'name' => '<string>',
'virtualClusterId' => '<string>',
]
Result Details
Members
Errors
-
There are invalid parameters in the client request.
-
The specified resource was not found.
-
This is an internal server exception.
CreateVirtualCluster
$result = $client->createVirtualCluster([/* ... */]); $promise = $client->createVirtualClusterAsync([/* ... */]);
Creates a virtual cluster. Virtual cluster is a managed entity on Amazon EMR on EKS. You can create, describe, list and delete virtual clusters. They do not consume any additional resource in your system. A single virtual cluster maps to a single Kubernetes namespace. Given this relationship, you can model virtual clusters the same way you model Kubernetes namespaces to meet your requirements.
Parameter Syntax
$result = $client->createVirtualCluster([
'clientToken' => '<string>', // REQUIRED
'containerProvider' => [ // REQUIRED
'id' => '<string>', // REQUIRED
'info' => [
'eksInfo' => [
'namespace' => '<string>',
],
],
'type' => 'EKS', // REQUIRED
],
'name' => '<string>', // REQUIRED
'tags' => ['<string>', ...],
]);
Parameter Details
Members
- clientToken
-
- Required: Yes
- Type: string
The client token of the virtual cluster.
- containerProvider
-
- Required: Yes
- Type: ContainerProvider structure
The container provider of the virtual cluster.
- name
-
- Required: Yes
- Type: string
The specified name of the virtual cluster.
- tags
-
- Type: Associative array of custom strings keys (String128) to strings
The tags assigned to the virtual cluster.
Result Syntax
[
'arn' => '<string>',
'id' => '<string>',
'name' => '<string>',
]
Result Details
Members
Errors
-
There are invalid parameters in the client request.
-
The specified resource was not found.
-
This is an internal server exception.
DeleteManagedEndpoint
$result = $client->deleteManagedEndpoint([/* ... */]); $promise = $client->deleteManagedEndpointAsync([/* ... */]);
Deletes a managed endpoint. A managed endpoint is a gateway that connects EMR Studio to Amazon EMR on EKS so that EMR Studio can communicate with your virtual cluster.
Parameter Syntax
$result = $client->deleteManagedEndpoint([
'id' => '<string>', // REQUIRED
'virtualClusterId' => '<string>', // REQUIRED
]);
Parameter Details
Members
Result Syntax
[
'id' => '<string>',
'virtualClusterId' => '<string>',
]
Result Details
Members
Errors
-
There are invalid parameters in the client request.
-
This is an internal server exception.
DeleteVirtualCluster
$result = $client->deleteVirtualCluster([/* ... */]); $promise = $client->deleteVirtualClusterAsync([/* ... */]);
Deletes a virtual cluster. Virtual cluster is a managed entity on Amazon EMR on EKS. You can create, describe, list and delete virtual clusters. They do not consume any additional resource in your system. A single virtual cluster maps to a single Kubernetes namespace. Given this relationship, you can model virtual clusters the same way you model Kubernetes namespaces to meet your requirements.
Parameter Syntax
$result = $client->deleteVirtualCluster([
'id' => '<string>', // REQUIRED
]);
Parameter Details
Result Syntax
[
'id' => '<string>',
]
Result Details
Errors
-
There are invalid parameters in the client request.
-
This is an internal server exception.
DescribeJobRun
$result = $client->describeJobRun([/* ... */]); $promise = $client->describeJobRunAsync([/* ... */]);
Displays detailed information about a job run. A job run is a unit of work, such as a Spark jar, PySpark script, or SparkSQL query, that you submit to Amazon EMR on EKS.
Parameter Syntax
$result = $client->describeJobRun([
'id' => '<string>', // REQUIRED
'virtualClusterId' => '<string>', // REQUIRED
]);
Parameter Details
Members
Result Syntax
[
'jobRun' => [
'arn' => '<string>',
'clientToken' => '<string>',
'configurationOverrides' => [
'applicationConfiguration' => [
[
'classification' => '<string>',
'configurations' => [...], // RECURSIVE
'properties' => ['<string>', ...],
],
// ...
],
'monitoringConfiguration' => [
'cloudWatchMonitoringConfiguration' => [
'logGroupName' => '<string>',
'logStreamNamePrefix' => '<string>',
],
'persistentAppUI' => 'ENABLED|DISABLED',
's3MonitoringConfiguration' => [
'logUri' => '<string>',
],
],
],
'createdAt' => <DateTime>,
'createdBy' => '<string>',
'executionRoleArn' => '<string>',
'failureReason' => 'INTERNAL_ERROR|USER_ERROR|VALIDATION_ERROR|CLUSTER_UNAVAILABLE',
'finishedAt' => <DateTime>,
'id' => '<string>',
'jobDriver' => [
'sparkSubmitJobDriver' => [
'entryPoint' => '<string>',
'entryPointArguments' => ['<string>', ...],
'sparkSubmitParameters' => '<string>',
],
],
'name' => '<string>',
'releaseLabel' => '<string>',
'state' => 'PENDING|SUBMITTED|RUNNING|FAILED|CANCELLED|CANCEL_PENDING|COMPLETED',
'stateDetails' => '<string>',
'tags' => ['<string>', ...],
'virtualClusterId' => '<string>',
],
]
Result Details
Members
- jobRun
-
- Type: JobRun structure
The output displays information about a job run.
Errors
-
There are invalid parameters in the client request.
-
The specified resource was not found.
-
This is an internal server exception.
DescribeManagedEndpoint
$result = $client->describeManagedEndpoint([/* ... */]); $promise = $client->describeManagedEndpointAsync([/* ... */]);
Displays detailed information about a managed endpoint. A managed endpoint is a gateway that connects EMR Studio to Amazon EMR on EKS so that EMR Studio can communicate with your virtual cluster.
Parameter Syntax
$result = $client->describeManagedEndpoint([
'id' => '<string>', // REQUIRED
'virtualClusterId' => '<string>', // REQUIRED
]);
Parameter Details
Members
Result Syntax
[
'endpoint' => [
'arn' => '<string>',
'certificateArn' => '<string>',
'configurationOverrides' => [
'applicationConfiguration' => [
[
'classification' => '<string>',
'configurations' => [...], // RECURSIVE
'properties' => ['<string>', ...],
],
// ...
],
'monitoringConfiguration' => [
'cloudWatchMonitoringConfiguration' => [
'logGroupName' => '<string>',
'logStreamNamePrefix' => '<string>',
],
'persistentAppUI' => 'ENABLED|DISABLED',
's3MonitoringConfiguration' => [
'logUri' => '<string>',
],
],
],
'createdAt' => <DateTime>,
'executionRoleArn' => '<string>',
'id' => '<string>',
'name' => '<string>',
'releaseLabel' => '<string>',
'securityGroup' => '<string>',
'serverUrl' => '<string>',
'state' => 'CREATING|ACTIVE|TERMINATING|TERMINATED|TERMINATED_WITH_ERRORS',
'subnetIds' => ['<string>', ...],
'tags' => ['<string>', ...],
'type' => '<string>',
'virtualClusterId' => '<string>',
],
]
Result Details
Members
- endpoint
-
- Type: Endpoint structure
This output displays information about a managed endpoint.
Errors
-
There are invalid parameters in the client request.
-
The specified resource was not found.
-
This is an internal server exception.
DescribeVirtualCluster
$result = $client->describeVirtualCluster([/* ... */]); $promise = $client->describeVirtualClusterAsync([/* ... */]);
Displays detailed information about a specified virtual cluster. Virtual cluster is a managed entity on Amazon EMR on EKS. You can create, describe, list and delete virtual clusters. They do not consume any additional resource in your system. A single virtual cluster maps to a single Kubernetes namespace. Given this relationship, you can model virtual clusters the same way you model Kubernetes namespaces to meet your requirements.
Parameter Syntax
$result = $client->describeVirtualCluster([
'id' => '<string>', // REQUIRED
]);
Parameter Details
Result Syntax
[
'virtualCluster' => [
'arn' => '<string>',
'containerProvider' => [
'id' => '<string>',
'info' => [
'eksInfo' => [
'namespace' => '<string>',
],
],
'type' => 'EKS',
],
'createdAt' => <DateTime>,
'id' => '<string>',
'name' => '<string>',
'state' => 'RUNNING|TERMINATING|TERMINATED|ARRESTED',
'tags' => ['<string>', ...],
],
]
Result Details
Members
- virtualCluster
-
- Type: VirtualCluster structure
This output displays information about the specified virtual cluster.
Errors
-
There are invalid parameters in the client request.
-
The specified resource was not found.
-
This is an internal server exception.
ListJobRuns
$result = $client->listJobRuns([/* ... */]); $promise = $client->listJobRunsAsync([/* ... */]);
Lists job runs based on a set of parameters. A job run is a unit of work, such as a Spark jar, PySpark script, or SparkSQL query, that you submit to Amazon EMR on EKS.
Parameter Syntax
$result = $client->listJobRuns([
'createdAfter' => <integer || string || DateTime>,
'createdBefore' => <integer || string || DateTime>,
'maxResults' => <integer>,
'name' => '<string>',
'nextToken' => '<string>',
'states' => ['<string>', ...],
'virtualClusterId' => '<string>', // REQUIRED
]);
Parameter Details
Members
- createdAfter
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time after which the job runs were submitted.
- createdBefore
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time before which the job runs were submitted.
- maxResults
-
- Type: int
The maximum number of job runs that can be listed.
- name
-
- Type: string
The name of the job run.
- nextToken
-
- Type: string
The token for the next set of job runs to return.
- states
-
- Type: Array of strings
The states of the job run.
- virtualClusterId
-
- Required: Yes
- Type: string
The ID of the virtual cluster for which to list the job run.
Result Syntax
[
'jobRuns' => [
[
'arn' => '<string>',
'clientToken' => '<string>',
'configurationOverrides' => [
'applicationConfiguration' => [
[
'classification' => '<string>',
'configurations' => [...], // RECURSIVE
'properties' => ['<string>', ...],
],
// ...
],
'monitoringConfiguration' => [
'cloudWatchMonitoringConfiguration' => [
'logGroupName' => '<string>',
'logStreamNamePrefix' => '<string>',
],
'persistentAppUI' => 'ENABLED|DISABLED',
's3MonitoringConfiguration' => [
'logUri' => '<string>',
],
],
],
'createdAt' => <DateTime>,
'createdBy' => '<string>',
'executionRoleArn' => '<string>',
'failureReason' => 'INTERNAL_ERROR|USER_ERROR|VALIDATION_ERROR|CLUSTER_UNAVAILABLE',
'finishedAt' => <DateTime>,
'id' => '<string>',
'jobDriver' => [
'sparkSubmitJobDriver' => [
'entryPoint' => '<string>',
'entryPointArguments' => ['<string>', ...],
'sparkSubmitParameters' => '<string>',
],
],
'name' => '<string>',
'releaseLabel' => '<string>',
'state' => 'PENDING|SUBMITTED|RUNNING|FAILED|CANCELLED|CANCEL_PENDING|COMPLETED',
'stateDetails' => '<string>',
'tags' => ['<string>', ...],
'virtualClusterId' => '<string>',
],
// ...
],
'nextToken' => '<string>',
]
Result Details
Members
- jobRuns
-
- Type: Array of JobRun structures
This output lists information about the specified job runs.
- nextToken
-
- Type: string
This output displays the token for the next set of job runs.
Errors
-
There are invalid parameters in the client request.
-
This is an internal server exception.
ListManagedEndpoints
$result = $client->listManagedEndpoints([/* ... */]); $promise = $client->listManagedEndpointsAsync([/* ... */]);
Lists managed endpoints based on a set of parameters. A managed endpoint is a gateway that connects EMR Studio to Amazon EMR on EKS so that EMR Studio can communicate with your virtual cluster.
Parameter Syntax
$result = $client->listManagedEndpoints([
'createdAfter' => <integer || string || DateTime>,
'createdBefore' => <integer || string || DateTime>,
'maxResults' => <integer>,
'nextToken' => '<string>',
'states' => ['<string>', ...],
'types' => ['<string>', ...],
'virtualClusterId' => '<string>', // REQUIRED
]);
Parameter Details
Members
- createdAfter
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time after which the endpoints are created.
- createdBefore
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time before which the endpoints are created.
- maxResults
-
- Type: int
The maximum number of managed endpoints that can be listed.
- nextToken
-
- Type: string
The token for the next set of managed endpoints to return.
- states
-
- Type: Array of strings
The states of the managed endpoints.
- types
-
- Type: Array of strings
The types of the managed endpoints.
- virtualClusterId
-
- Required: Yes
- Type: string
The ID of the virtual cluster.
Result Syntax
[
'endpoints' => [
[
'arn' => '<string>',
'certificateArn' => '<string>',
'configurationOverrides' => [
'applicationConfiguration' => [
[
'classification' => '<string>',
'configurations' => [...], // RECURSIVE
'properties' => ['<string>', ...],
],
// ...
],
'monitoringConfiguration' => [
'cloudWatchMonitoringConfiguration' => [
'logGroupName' => '<string>',
'logStreamNamePrefix' => '<string>',
],
'persistentAppUI' => 'ENABLED|DISABLED',
's3MonitoringConfiguration' => [
'logUri' => '<string>',
],
],
],
'createdAt' => <DateTime>,
'executionRoleArn' => '<string>',
'id' => '<string>',
'name' => '<string>',
'releaseLabel' => '<string>',
'securityGroup' => '<string>',
'serverUrl' => '<string>',
'state' => 'CREATING|ACTIVE|TERMINATING|TERMINATED|TERMINATED_WITH_ERRORS',
'subnetIds' => ['<string>', ...],
'tags' => ['<string>', ...],
'type' => '<string>',
'virtualClusterId' => '<string>',
],
// ...
],
'nextToken' => '<string>',
]
Result Details
Members
- endpoints
-
- Type: Array of Endpoint structures
The managed endpoints to be listed.
- nextToken
-
- Type: string
The token for the next set of endpoints to return.
Errors
-
There are invalid parameters in the client request.
-
This is an internal server exception.
ListTagsForResource
$result = $client->listTagsForResource([/* ... */]); $promise = $client->listTagsForResourceAsync([/* ... */]);
Lists the tags assigned to the resources.
Parameter Syntax
$result = $client->listTagsForResource([
'resourceArn' => '<string>', // REQUIRED
]);
Parameter Details
Result Syntax
[
'tags' => ['<string>', ...],
]
Result Details
Members
Errors
-
This is an internal server exception.
-
There are invalid parameters in the client request.
-
The specified resource was not found.
ListVirtualClusters
$result = $client->listVirtualClusters([/* ... */]); $promise = $client->listVirtualClustersAsync([/* ... */]);
Lists information about the specified virtual cluster. Virtual cluster is a managed entity on Amazon EMR on EKS. You can create, describe, list and delete virtual clusters. They do not consume any additional resource in your system. A single virtual cluster maps to a single Kubernetes namespace. Given this relationship, you can model virtual clusters the same way you model Kubernetes namespaces to meet your requirements.
Parameter Syntax
$result = $client->listVirtualClusters([
'containerProviderId' => '<string>',
'containerProviderType' => 'EKS',
'createdAfter' => <integer || string || DateTime>,
'createdBefore' => <integer || string || DateTime>,
'maxResults' => <integer>,
'nextToken' => '<string>',
'states' => ['<string>', ...],
]);
Parameter Details
Members
- containerProviderId
-
- Type: string
The container provider ID of the virtual cluster.
- containerProviderType
-
- Type: string
The container provider type of the virtual cluster. EKS is the only supported type as of now.
- createdAfter
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time after which the virtual clusters are created.
- createdBefore
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time before which the virtual clusters are created.
- maxResults
-
- Type: int
The maximum number of virtual clusters that can be listed.
- nextToken
-
- Type: string
The token for the next set of virtual clusters to return.
- states
-
- Type: Array of strings
The states of the requested virtual clusters.
Result Syntax
[
'nextToken' => '<string>',
'virtualClusters' => [
[
'arn' => '<string>',
'containerProvider' => [
'id' => '<string>',
'info' => [
'eksInfo' => [
'namespace' => '<string>',
],
],
'type' => 'EKS',
],
'createdAt' => <DateTime>,
'id' => '<string>',
'name' => '<string>',
'state' => 'RUNNING|TERMINATING|TERMINATED|ARRESTED',
'tags' => ['<string>', ...],
],
// ...
],
]
Result Details
Members
- nextToken
-
- Type: string
This output displays the token for the next set of virtual clusters.
- virtualClusters
-
- Type: Array of VirtualCluster structures
This output lists the specified virtual clusters.
Errors
-
There are invalid parameters in the client request.
-
This is an internal server exception.
StartJobRun
$result = $client->startJobRun([/* ... */]); $promise = $client->startJobRunAsync([/* ... */]);
Starts a job run. A job run is a unit of work, such as a Spark jar, PySpark script, or SparkSQL query, that you submit to Amazon EMR on EKS.
Parameter Syntax
$result = $client->startJobRun([
'clientToken' => '<string>', // REQUIRED
'configurationOverrides' => [
'applicationConfiguration' => [
[
'classification' => '<string>', // REQUIRED
'configurations' => [...], // RECURSIVE
'properties' => ['<string>', ...],
],
// ...
],
'monitoringConfiguration' => [
'cloudWatchMonitoringConfiguration' => [
'logGroupName' => '<string>', // REQUIRED
'logStreamNamePrefix' => '<string>',
],
'persistentAppUI' => 'ENABLED|DISABLED',
's3MonitoringConfiguration' => [
'logUri' => '<string>', // REQUIRED
],
],
],
'executionRoleArn' => '<string>', // REQUIRED
'jobDriver' => [ // REQUIRED
'sparkSubmitJobDriver' => [
'entryPoint' => '<string>', // REQUIRED
'entryPointArguments' => ['<string>', ...],
'sparkSubmitParameters' => '<string>',
],
],
'name' => '<string>',
'releaseLabel' => '<string>', // REQUIRED
'tags' => ['<string>', ...],
'virtualClusterId' => '<string>', // REQUIRED
]);
Parameter Details
Members
- clientToken
-
- Required: Yes
- Type: string
The client idempotency token of the job run request.
- configurationOverrides
-
- Type: ConfigurationOverrides structure
The configuration overrides for the job run.
- executionRoleArn
-
- Required: Yes
- Type: string
The execution role ARN for the job run.
- jobDriver
-
- Required: Yes
- Type: JobDriver structure
The job driver for the job run.
- name
-
- Type: string
The name of the job run.
- releaseLabel
-
- Required: Yes
- Type: string
The Amazon EMR release version to use for the job run.
- tags
-
- Type: Associative array of custom strings keys (String128) to strings
The tags assigned to job runs.
- virtualClusterId
-
- Required: Yes
- Type: string
The virtual cluster ID for which the job run request is submitted.
Result Syntax
[
'arn' => '<string>',
'id' => '<string>',
'name' => '<string>',
'virtualClusterId' => '<string>',
]
Result Details
Members
Errors
-
There are invalid parameters in the client request.
-
The specified resource was not found.
-
This is an internal server exception.
TagResource
$result = $client->tagResource([/* ... */]); $promise = $client->tagResourceAsync([/* ... */]);
Assigns tags to resources. A tag is a label that you assign to an AWS resource. Each tag consists of a key and an optional value, both of which you define. Tags enable you to categorize your AWS resources by attributes such as purpose, owner, or environment. When you have many resources of the same type, you can quickly identify a specific resource based on the tags you've assigned to it. For example, you can define a set of tags for your Amazon EMR on EKS clusters to help you track each cluster's owner and stack level. We recommend that you devise a consistent set of tag keys for each resource type. You can then search and filter the resources based on the tags that you add.
Parameter Syntax
$result = $client->tagResource([
'resourceArn' => '<string>', // REQUIRED
'tags' => ['<string>', ...], // REQUIRED
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
This is an internal server exception.
-
There are invalid parameters in the client request.
-
The specified resource was not found.
UntagResource
$result = $client->untagResource([/* ... */]); $promise = $client->untagResourceAsync([/* ... */]);
Removes tags from resources.
Parameter Syntax
$result = $client->untagResource([
'resourceArn' => '<string>', // REQUIRED
'tagKeys' => ['<string>', ...], // REQUIRED
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
This is an internal server exception.
-
There are invalid parameters in the client request.
-
The specified resource was not found.
Shapes
CloudWatchMonitoringConfiguration
Description
A configuration for CloudWatch monitoring. You can configure your jobs to send log information to CloudWatch Logs.
Members
Configuration
Description
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.
Members
- classification
-
- Required: Yes
- Type: string
The classification within a configuration.
- configurations
-
- Type: Array of Configuration structures
A list of additional configurations to apply within a configuration object.
- properties
-
- Type: Associative array of custom strings keys (String1024) to strings
A set of properties specified within a configuration classification.
ConfigurationOverrides
Description
A configuration specification to be used to override existing configurations.
Members
- applicationConfiguration
-
- Type: Array of Configuration structures
The configurations for the application running by the job run.
- monitoringConfiguration
-
- Type: MonitoringConfiguration structure
The configurations for monitoring.
ContainerInfo
Description
The information about the container used for a job run or a managed endpoint.
Members
- eksInfo
-
- Type: EksInfo structure
The information about the EKS cluster.
ContainerProvider
Description
The information about the container provider.
Members
- id
-
- Required: Yes
- Type: string
The ID of the container cluster.
- info
-
- Type: ContainerInfo structure
The information about the container cluster.
- type
-
- Required: Yes
- Type: string
The type of the container provider. EKS is the only supported type as of now.
EksInfo
Description
The information about the EKS cluster.
Members
Endpoint
Description
This entity represents the endpoint that is managed by Amazon EMR on EKS.
Members
- arn
-
- Type: string
The ARN of the endpoint.
- certificateArn
-
- Type: string
The certificate ARN of the endpoint.
- configurationOverrides
-
- Type: ConfigurationOverrides structure
The configuration settings that are used to override existing configurations for endpoints.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time when the endpoint was created.
- executionRoleArn
-
- Type: string
The execution role ARN of the endpoint.
- id
-
- Type: string
The ID of the endpoint.
- name
-
- Type: string
The name of the endpoint.
- releaseLabel
-
- Type: string
The EMR release version to be used for the endpoint.
- securityGroup
-
- Type: string
The security group configuration of the endpoint.
- serverUrl
-
- Type: string
The server URL of the endpoint.
- state
-
- Type: string
The state of the endpoint.
- subnetIds
-
- Type: Array of strings
The subnet IDs of the endpoint.
- tags
-
- Type: Associative array of custom strings keys (String128) to strings
The tags of the endpoint.
- type
-
- Type: string
The type of the endpoint.
- virtualClusterId
-
- Type: string
The ID of the endpoint's virtual cluster.
InternalServerException
JobDriver
Description
Specify the driver that the job runs on.
Members
- sparkSubmitJobDriver
-
- Type: SparkSubmitJobDriver structure
The job driver parameters specified for spark submit.
JobRun
Description
This entity describes a job run. A job run is a unit of work, such as a Spark jar, PySpark script, or SparkSQL query, that you submit to Amazon EMR on EKS.
Members
- arn
-
- Type: string
The ARN of job run.
- clientToken
-
- Type: string
The client token used to start a job run.
- configurationOverrides
-
- Type: ConfigurationOverrides structure
The configuration settings that are used to override default configuration.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time when the job run was created.
- createdBy
-
- Type: string
The user who created the job run.
- executionRoleArn
-
- Type: string
The execution role ARN of the job run.
- failureReason
-
- Type: string
The reasons why the job run has failed.
- finishedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time when the job run has finished.
- id
-
- Type: string
The ID of the job run.
- jobDriver
-
- Type: JobDriver structure
Parameters of job driver for the job run.
- name
-
- Type: string
The name of the job run.
- releaseLabel
-
- Type: string
The release version of Amazon EMR.
- state
-
- Type: string
The state of the job run.
- stateDetails
-
- Type: string
Additional details of the job run state.
- tags
-
- Type: Associative array of custom strings keys (String128) to strings
The assigned tags of the job run.
- virtualClusterId
-
- Type: string
The ID of the job run's virtual cluster.
MonitoringConfiguration
Description
Configuration setting for monitoring.
Members
- cloudWatchMonitoringConfiguration
-
- Type: CloudWatchMonitoringConfiguration structure
Monitoring configurations for CloudWatch.
- persistentAppUI
-
- Type: string
Monitoring configurations for the persistent application UI.
- s3MonitoringConfiguration
-
- Type: S3MonitoringConfiguration structure
Amazon S3 configuration for monitoring log publishing.
ResourceNotFoundException
S3MonitoringConfiguration
Description
Amazon S3 configuration for monitoring log publishing. You can configure your jobs to send log information to Amazon S3.
Members
SparkSubmitJobDriver
Description
The information about job driver for Spark submit.
Members
ValidationException
VirtualCluster
Description
This entity describes a virtual cluster. A virtual cluster is a Kubernetes namespace that Amazon EMR is registered with. Amazon EMR uses virtual clusters to run jobs and host endpoints. Multiple virtual clusters can be backed by the same physical cluster. However, each virtual cluster maps to one namespace on an EKS cluster. Virtual clusters do not create any active resources that contribute to your bill or that require lifecycle management outside the service.
Members
- arn
-
- Type: string
The ARN of the virtual cluster.
- containerProvider
-
- Type: ContainerProvider structure
The container provider of the virtual cluster.
- createdAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time when the virtual cluster is created.
- id
-
- Type: string
The ID of the virtual cluster.
- name
-
- Type: string
The name of the virtual cluster.
- state
-
- Type: string
The state of the virtual cluster.
- tags
-
- Type: Associative array of custom strings keys (String128) to strings
The assigned tags of the virtual cluster.