

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Ejemplos de comandos programáticos para Cuadernos de EMR
<a name="emr-managed-notebooks-headless"></a>

## Descripción general de
<a name="emr-managed-notebooks-headless-overview"></a>

Puede ejecutar cuadernos EMR ejecutándolos APIs desde un script o desde la línea de comandos. Al iniciar, detener, enumerar y describir las ejecuciones de cuadernos EMR fuera de la AWS consola, puede controlar mediante programación un cuaderno EMR. Puede pasar diferentes valores de parámetros a un cuaderno con una celda de cuaderno parametrizada. Esto elimina la necesidad de crear una copia del cuaderno para cada nuevo conjunto de valores de parámetros. Para obtener más información, consulte [Acciones de la API de Amazon EMR](https://docs.aws.amazon.com/emr/latest/APIReference/API_Operations.html).

Puede programar o agrupar las ejecuciones de cuadernos EMR con Amazon CloudWatch Events y. AWS Lambda Para obtener más información, consulte [Uso AWS Lambda con Amazon CloudWatch Events](https://docs.aws.amazon.com/lambda/latest/dg/services-cloudwatchevents.html).

**nota**  
Cuadernos de EMR está disponible como Espacios de trabajo de EMR Studio en la consola. El botón **Crear espacio de trabajo** de la consola le permite crear nuevos cuadernos. Para crear espacios de trabajo o acceder a ellos, los usuarios de Cuadernos de EMR necesitan permisos de rol de IAM adicionales. Para obtener más información, consulte [Cuadernos de Amazon EMR es Espacios de trabajo de Amazon EMR Studio en la consola](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-managed-notebooks-migration.html) y [Consola Amazon EMR](https://docs.aws.amazon.com/emr/latest/ManagementGuide/whats-new-in-console.html).

## Permisos de rol para la ejecución programática
<a name="emr-managed-notebooks-headless-permissions"></a>

Para utilizar la ejecución programática con Cuadernos de EMR, debe configurar los permisos de usuario con las siguientes políticas:

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "AllowExecutionActions",
      "Effect": "Allow",
      "Action": [
        "elasticmapreduce:StartNotebookExecution",
        "elasticmapreduce:DescribeNotebookExecution",
        "elasticmapreduce:ListNotebookExecutions"
      ],
      "Resource": [
        "*"
      ]
    },
    {
      "Sid": "AllowPassingServiceRole",
      "Effect": "Allow",
      "Action": [
        "iam:PassRole"
      ],
      "Resource": [
        "arn:aws:iam::123456789012:role/EMR_Notebooks_DefaultRole"
      ]
    }
  ]
}
```

------

Al ejecutar mediante programación Cuadernos de EMR en un clúster de Cuadernos de EMR, debe agregar los siguientes permisos adicionales:

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "AllowRetrievingManagedEndpointCredentials",
      "Effect": "Allow",
      "Action": [
        "emr-containers:GetManagedEndpointSessionCredentials"
      ],
      "Resource": [
        "arn:aws:emr-containers:*:123456789012:/virtualclusters/virtual-cluster-id/endpoints/managed-endpoint-id"
      ],
      "Condition": {
        "StringEquals": {
          "emr-containers:ExecutionRoleArn": [
            "arn:aws:iam::123456789012:role/emr-on-eks-execution-role"
          ]
        }
      }
    },
    {
      "Sid": "AllowDescribingManagedEndpoint",
      "Effect": "Allow",
      "Action": [
        "emr-containers:DescribeManagedEndpoint"
      ],
      "Resource": [
        "arn:aws:emr-containers:*:123456789012:/virtualclusters/virtual-cluster-id/endpoints/managed-endpoint-id"
      ]
    }
  ]
}
```

------

## Limitaciones de la ejecución programática
<a name="emr-managed-notebooks-headless-limit"></a>
+ Se admite un máximo de 100 ejecuciones simultáneas Región de AWS por cuenta.
+ Una ejecución termina si dura más de 30 días.
+ Las aplicaciones interactivas de Amazon EMR sin servidor no admiten la ejecución programática de cuadernos.

## Ejemplos de ejecución programática de cuadernos de EMR
<a name="emr-managed-notebooks-headless-examples"></a>

En las siguientes secciones se proporcionan varios ejemplos de ejecución programática de cuadernos EMR con AWS CLI el SDK de Boto3 (Python) y Ruby:
+ [Ejemplos de comandos de la CLI de Cuadernos en EMR Studio](emr-managed-notebooks-headless-cli.md)
+ [Ejemplos de Python para un cuaderno de EMR](emr-managed-notebooks-headless-python.md)
+ [Ejemplos de Ruby para un cuaderno de EMR](emr-managed-notebooks-headless-ruby.md)

También puede ejecutar cuadernos parametrizados como parte de los flujos de trabajo programados con una herramienta de orquestación como Apache Airflow o Amazon Managed Workflows para Apache Airflow (MWAA). Para obtener más información, consulte [Orquestación de trabajos de análisis en Cuadernos de EMR mediante MWAA](https://aws.amazon.com/blogs/big-data/orchestrating-analytics-jobs-on-amazon-emr-notebooks-using-amazon-mwaa/) en el *blog de macrodatos de AWS *.