The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Paws::EMRContainers - Perl Interface to AWS Amazon EMR Containers

SYNOPSIS

  use Paws;

  my $obj = Paws->service('EMRContainers');
  my $res = $obj->Method(
    Arg1 => $val1,
    Arg2 => [ 'V1', 'V2' ],
    # if Arg3 is an object, the HashRef will be used as arguments to the constructor
    # of the arguments type
    Arg3 => { Att1 => 'Val1' },
    # if Arg4 is an array of objects, the HashRefs will be passed as arguments to
    # the constructor of the arguments type
    Arg4 => [ { Att1 => 'Val1'  }, { Att1 => 'Val2' } ],
  );

DESCRIPTION

Amazon EMR on EKS provides a deployment option for Amazon EMR that allows you to run open-source big data frameworks on Amazon Elastic Kubernetes Service (Amazon EKS). With this deployment option, you can focus on running analytics workloads while Amazon EMR on EKS builds, configures, and manages containers for open-source applications. For more information about Amazon EMR on EKS concepts and tasks, see What is Amazon EMR on EKS (https://docs.aws.amazon.com/emr/latest/EMR-on-EKS-DevelopmentGuide/emr-eks.html).

Amazon EMR containers is the API name for Amazon EMR on EKS. The emr-containers prefix is used in the following scenarios:

  • It is the prefix in the CLI commands for Amazon EMR on EKS. For example, aws emr-containers start-job-run.

  • It is the prefix before IAM policy actions for Amazon EMR on EKS. For example, "Action": [ "emr-containers:StartJobRun"]. For more information, see Policy actions for Amazon EMR on EKS (https://docs.aws.amazon.com/emr/latest/EMR-on-EKS-DevelopmentGuide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-actions).

  • It is the prefix used in Amazon EMR on EKS service endpoints. For example, emr-containers.us-east-2.amazonaws.com. For more information, see Amazon EMR on EKS Service Endpoints (https://docs.aws.amazon.com/emr/latest/EMR-on-EKS-DevelopmentGuide/service-quotas.html#service-endpoints).

For the AWS API documentation, see https://docs.aws.amazon.com/goto/WebAPI/emr-containers-2020-10-01

METHODS

CancelJobRun

Id => Str
VirtualClusterId => Str

Each argument is described in detail in: Paws::EMRContainers::CancelJobRun

Returns: a Paws::EMRContainers::CancelJobRunResponse instance

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.

CreateManagedEndpoint

CertificateArn => Str
ClientToken => Str
ExecutionRoleArn => Str
Name => Str
ReleaseLabel => Str
Type => Str
VirtualClusterId => Str
[ConfigurationOverrides => Paws::EMRContainers::ConfigurationOverrides]
[Tags => Paws::EMRContainers::TagMap]

Each argument is described in detail in: Paws::EMRContainers::CreateManagedEndpoint

Returns: a Paws::EMRContainers::CreateManagedEndpointResponse instance

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.

CreateVirtualCluster

ClientToken => Str
ContainerProvider => Paws::EMRContainers::ContainerProvider
Name => Str
[Tags => Paws::EMRContainers::TagMap]

Each argument is described in detail in: Paws::EMRContainers::CreateVirtualCluster

Returns: a Paws::EMRContainers::CreateVirtualClusterResponse instance

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.

DeleteManagedEndpoint

Id => Str
VirtualClusterId => Str

Each argument is described in detail in: Paws::EMRContainers::DeleteManagedEndpoint

Returns: a Paws::EMRContainers::DeleteManagedEndpointResponse instance

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.

DeleteVirtualCluster

Id => Str

Each argument is described in detail in: Paws::EMRContainers::DeleteVirtualCluster

Returns: a Paws::EMRContainers::DeleteVirtualClusterResponse instance

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.

DescribeJobRun

Id => Str
VirtualClusterId => Str

Each argument is described in detail in: Paws::EMRContainers::DescribeJobRun

Returns: a Paws::EMRContainers::DescribeJobRunResponse instance

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.

DescribeManagedEndpoint

Id => Str
VirtualClusterId => Str

Each argument is described in detail in: Paws::EMRContainers::DescribeManagedEndpoint

Returns: a Paws::EMRContainers::DescribeManagedEndpointResponse instance

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.

DescribeVirtualCluster

Id => Str

Each argument is described in detail in: Paws::EMRContainers::DescribeVirtualCluster

Returns: a Paws::EMRContainers::DescribeVirtualClusterResponse instance

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.

ListJobRuns

VirtualClusterId => Str
[CreatedAfter => Str]
[CreatedBefore => Str]
[MaxResults => Int]
[Name => Str]
[NextToken => Str]
[States => ArrayRef[Str|Undef]]

Each argument is described in detail in: Paws::EMRContainers::ListJobRuns

Returns: a Paws::EMRContainers::ListJobRunsResponse instance

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.

ListManagedEndpoints

VirtualClusterId => Str
[CreatedAfter => Str]
[CreatedBefore => Str]
[MaxResults => Int]
[NextToken => Str]
[States => ArrayRef[Str|Undef]]
[Types => ArrayRef[Str|Undef]]

Each argument is described in detail in: Paws::EMRContainers::ListManagedEndpoints

Returns: a Paws::EMRContainers::ListManagedEndpointsResponse instance

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.

ListTagsForResource

ResourceArn => Str

Each argument is described in detail in: Paws::EMRContainers::ListTagsForResource

Returns: a Paws::EMRContainers::ListTagsForResourceResponse instance

Lists the tags assigned to the resources.

ListVirtualClusters

[ContainerProviderId => Str]
[ContainerProviderType => Str]
[CreatedAfter => Str]
[CreatedBefore => Str]
[MaxResults => Int]
[NextToken => Str]
[States => ArrayRef[Str|Undef]]

Each argument is described in detail in: Paws::EMRContainers::ListVirtualClusters

Returns: a Paws::EMRContainers::ListVirtualClustersResponse instance

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.

StartJobRun

ClientToken => Str
ExecutionRoleArn => Str
JobDriver => Paws::EMRContainers::JobDriver
ReleaseLabel => Str
VirtualClusterId => Str
[ConfigurationOverrides => Paws::EMRContainers::ConfigurationOverrides]
[Name => Str]
[Tags => Paws::EMRContainers::TagMap]

Each argument is described in detail in: Paws::EMRContainers::StartJobRun

Returns: a Paws::EMRContainers::StartJobRunResponse instance

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.

TagResource

ResourceArn => Str
Tags => Paws::EMRContainers::TagMap

Each argument is described in detail in: Paws::EMRContainers::TagResource

Returns: a Paws::EMRContainers::TagResourceResponse instance

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.

UntagResource

ResourceArn => Str
TagKeys => ArrayRef[Str|Undef]

Each argument is described in detail in: Paws::EMRContainers::UntagResource

Returns: a Paws::EMRContainers::UntagResourceResponse instance

Removes tags from resources.

PAGINATORS

Paginator methods are helpers that repetively call methods that return partial results

ListAllJobRuns(sub { },VirtualClusterId => Str, [CreatedAfter => Str, CreatedBefore => Str, MaxResults => Int, Name => Str, NextToken => Str, States => ArrayRef[Str|Undef]])

ListAllJobRuns(VirtualClusterId => Str, [CreatedAfter => Str, CreatedBefore => Str, MaxResults => Int, Name => Str, NextToken => Str, States => ArrayRef[Str|Undef]])

If passed a sub as first parameter, it will call the sub for each element found in :

 - jobRuns, passing the object as the first parameter, and the string 'jobRuns' as the second parameter 

If not, it will return a a Paws::EMRContainers::ListJobRunsResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

ListAllManagedEndpoints(sub { },VirtualClusterId => Str, [CreatedAfter => Str, CreatedBefore => Str, MaxResults => Int, NextToken => Str, States => ArrayRef[Str|Undef], Types => ArrayRef[Str|Undef]])

ListAllManagedEndpoints(VirtualClusterId => Str, [CreatedAfter => Str, CreatedBefore => Str, MaxResults => Int, NextToken => Str, States => ArrayRef[Str|Undef], Types => ArrayRef[Str|Undef]])

If passed a sub as first parameter, it will call the sub for each element found in :

 - endpoints, passing the object as the first parameter, and the string 'endpoints' as the second parameter 

If not, it will return a a Paws::EMRContainers::ListManagedEndpointsResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

ListAllVirtualClusters(sub { },[ContainerProviderId => Str, ContainerProviderType => Str, CreatedAfter => Str, CreatedBefore => Str, MaxResults => Int, NextToken => Str, States => ArrayRef[Str|Undef]])

ListAllVirtualClusters([ContainerProviderId => Str, ContainerProviderType => Str, CreatedAfter => Str, CreatedBefore => Str, MaxResults => Int, NextToken => Str, States => ArrayRef[Str|Undef]])

If passed a sub as first parameter, it will call the sub for each element found in :

 - virtualClusters, passing the object as the first parameter, and the string 'virtualClusters' as the second parameter 

If not, it will return a a Paws::EMRContainers::ListVirtualClustersResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

SEE ALSO

This service class forms part of Paws

BUGS and CONTRIBUTIONS

The source code is located here: https://github.com/pplu/aws-sdk-perl

Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues