AWS App Runner dejará de estar abierto a nuevos clientes a partir del 30 de abril de 2026. Si quieres usar App Runner, regístrate antes de esa fecha. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte [Cambio en la disponibilidad de AWS App Runner](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html).
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.
# La API de App Runner
La interfaz de programación de AWS App Runner aplicaciones (API) es una RESTful API para realizar solicitudes al servicio App Runner. Puedes usar la API para crear, enumerar, describir, actualizar y eliminar los recursos de App Runner en tu Cuenta de AWS.
Puedes llamar a la API directamente en el código de tu aplicación o puedes usar una de las AWS SDKs.
Para obtener información de referencia completa sobre la API, consulta la [Referencia AWS App Runner de la API](https://docs.aws.amazon.com/apprunner/latest/api/).
Para obtener más información sobre las herramientas para AWS desarrolladores, consulta [Herramientas sobre las que construir AWS](https://aws.amazon.com/tools/).
**Topics**
+ [Utilización de AWS CLI para trabajar con App Runner](#api.cli)
+ [Uso AWS CloudShell para trabajar con AWS App Runner](api-cshell.md)
## Utilización de AWS CLI para trabajar con App Runner
Para los scripts de línea de comandos, utilice el [AWS CLI](https://docs.aws.amazon.com/cli/)para realizar llamadas al servicio App Runner. Para obtener información de AWS CLI referencia completa, consulte el [apprunner](https://docs.aws.amazon.com/cli/latest/reference/apprunner/) en la Referencia de *AWS CLI comandos*.
AWS CloudShell le permite omitir la instalación de AWS CLI en su entorno de desarrollo y utilizarla en su lugar. Consola de administración de AWS Además de evitar la instalación, tampoco es necesario configurar las credenciales ni especificar la región. Su Consola de administración de AWS sesión proporciona este contexto a AWS CLI. Para obtener más información CloudShell y un ejemplo de uso, consulte[Uso AWS CloudShell para trabajar con AWS App Runner](api-cshell.md).
# Uso AWS CloudShell para trabajar con AWS App Runner
AWS CloudShell es un shell preautenticado y basado en un navegador que puedes iniciar directamente desde. Consola de administración de AWS Puede ejecutar AWS CLI comandos en los AWS servicios (incluso AWS App Runner) utilizando el shell que prefiera (Bash o Z shell). PowerShell Y puede hacerlo sin necesidad de descargar o instalar herramientas de línea de comandos.
Los [AWS CloudShell ejecutas desde la Consola de administración de AWS](https://docs.aws.amazon.com/cloudshell/latest/userguide/working-with-cloudshell.html#launch-options) consola y las AWS credenciales que usaste para iniciar sesión en la consola estarán disponibles automáticamente en una nueva sesión de shell. Esta autenticación previa de AWS CloudShell los usuarios permite omitir la configuración de las credenciales al interactuar con AWS servicios como App Runner que utilizan la AWS CLI versión 2 (preinstalada en el entorno informático del shell).
**Topics**
+ [Obtener permisos de IAM para AWS CloudShell](#api-cshell.permissions)
+ [Interactúa con App Runner mediante AWS CloudShell](#api-cshell.call-apprunner)
+ [Verificar el servicio App Runner mediante AWS CloudShell](#api-cshell.call-your-service)
## Obtener permisos de IAM para AWS CloudShell
Con los recursos de administración de acceso que proporcionan AWS Identity and Access Management, los administradores pueden conceder permisos a los usuarios de IAM para que puedan acceder a las funciones del entorno AWS CloudShell y utilizarlas.
La forma más rápida de que un administrador conceda acceso a los usuarios es mediante una política AWS gestionada. Una [política administrada de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) es una política independiente creada y administrada por AWS. La siguiente política AWS administrada para se CloudShell puede adjuntar a las identidades de IAM:
+ `AWSCloudShellFullAccess`: Concede permiso de uso AWS CloudShell con acceso completo a todas las funciones.
Si desea limitar el alcance de las acciones con las que puede realizar un usuario de IAM AWS CloudShell, puede crear una política personalizada que utilice la política `AWSCloudShellFullAccess` gestionada como plantilla. Para obtener más información sobre cómo limitar las acciones que están disponibles para los usuarios CloudShell, consulte [Administrar el AWS CloudShell acceso y el uso con políticas de IAM](https://docs.aws.amazon.com/cloudshell/latest/userguide/sec-auth-with-identities.html) en la Guía del *AWS CloudShell usuario*.
**nota**
Tu identidad de IAM también requiere una política que otorgue permiso para realizar llamadas a App Runner. Para obtener más información, consulte [Cómo funciona App Runner con IAM](security_iam_service-with-iam.md).
## Interactúa con App Runner mediante AWS CloudShell
Tras iniciarlo AWS CloudShell desde Consola de administración de AWS, podrás empezar a interactuar inmediatamente con App Runner mediante la interfaz de línea de comandos.
En el siguiente ejemplo, recuperas información sobre uno de tus servicios de App Runner mediante la función AWS CLI in CloudShell.
**nota**
AWS CLI Al usarlo AWS CloudShell, no necesitas descargar ni instalar ningún recurso adicional. Además, dado que ya está autenticado en el intérprete de comandos, no tiene que configurar las credenciales antes de realizar llamadas.
**Example Recuperar la información del servicio de App Runner mediante AWS CloudShell**
1. Desde Consola de administración de AWS, puede iniciar CloudShell seleccionando las siguientes opciones disponibles en la barra de navegación:
+ Selecciona el CloudShell icono.
+ Comience a escribir **cloudshell** en el cuadro de búsqueda y, a continuación, elija la **CloudShell**opción cuando aparezca en los resultados de la búsqueda.
1. Para ver todos los servicios actuales de App Runner de su AWS cuenta en la AWS región de la sesión de la consola, introduzca el siguiente comando en la línea de CloudShell comandos:
```
$ aws apprunner list-services
```
El resultado muestra un resumen de la información de sus servicios.
```
{
"ServiceSummaryList": [
{
"ServiceName": "my-app-1",
"ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceArn": "arn:aws:apprunner:us-east-2:123456789012:service/my-app-1/8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
"CreatedAt": "2020-11-20T19:05:25Z",
"UpdatedAt": "2020-11-23T12:41:37Z",
"Status": "RUNNING"
},
{
"ServiceName": "my-app-2",
"ServiceId": "ab8f94cfe29a460fb8760afd2ee87555",
"ServiceArn": "arn:aws:apprunner:us-east-2:123456789012:service/my-app-2/ab8f94cfe29a460fb8760afd2ee87555",
"ServiceUrl": "e2m8rrrx33.us-east-1.awsapprunner.com",
"CreatedAt": "2020-11-06T23:15:30Z",
"UpdatedAt": "2020-11-23T13:21:22Z",
"Status": "RUNNING"
}
]
}
```
1. Para obtener una descripción detallada de un servicio concreto de App Runner, ingresa el siguiente comando en la línea de CloudShell comandos, usando uno de los ARNs recuperados en el paso anterior:
```
$ aws apprunner describe-service --service-arn arn:aws:apprunner:us-east-2:123456789012:service/my-app-1/8fe1e10304f84fd2b0df550fe98a71fa
```
El resultado muestra una descripción detallada del servicio que especificó.
```
{
"Service": {
"ServiceName": "my-app-1",
"ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceArn": "arn:aws:apprunner:us-east-2:123456789012:service/my-app-1/8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
"CreatedAt": "2020-11-20T19:05:25Z",
"UpdatedAt": "2020-11-23T12:41:37Z",
"Status": "RUNNING",
"SourceConfiguration": {
"CodeRepository": {
"RepositoryUrl": "https://github.com/my-account/python-hello",
"SourceCodeVersion": {
"Type": "BRANCH",
"Value": "main"
},
"CodeConfiguration": {
"CodeConfigurationValues": {
"BuildCommand": "[pip install -r requirements.txt]",
"Port": "8080",
"Runtime": "PYTHON_3",
"RuntimeEnvironmentVariables": [
{
"NAME": "Jane"
}
],
"StartCommand": "python server.py"
},
"ConfigurationSource": "API"
}
},
"AutoDeploymentsEnabled": true,
"AuthenticationConfiguration": {
"ConnectionArn": "arn:aws:apprunner:us-east-2:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e"
}
},
"InstanceConfiguration": {
"CPU": "1 vCPU",
"Memory": "3 GB"
},
"HealthCheckConfiguration": {
"Protocol": "TCP",
"Path": "/",
"Interval": 10,
"Timeout": 5,
"HealthyThreshold": 1,
"UnhealthyThreshold": 5
},
"AutoScalingConfigurationSummary": {
"AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-2:123456789012:autoscalingconfiguration/DefaultConfiguration/1/00000000000000000000000000000001",
"AutoScalingConfigurationName": "DefaultConfiguration",
"AutoScalingConfigurationRevision": 1
}
}
}
```
## Verificar el servicio App Runner mediante AWS CloudShell
Al [crear un servicio de App Runner](manage-create.md), App Runner crea un dominio predeterminado para el sitio web del servicio y lo muestra en la consola (o lo devuelve en el resultado de la llamada a la API). Puedes usarlo CloudShell para hacer llamadas a tu sitio web y comprobar que funciona correctamente.
Por ejemplo, después de crear un servicio de App Runner como se describe en[Cómo empezar a usar App Runner](getting-started.md), ejecute el siguiente comando en CloudShell:
```
$ curl https://qxuadi4qwp.us-east-2.awsapprunner.com/; echo
```
El resultado debe mostrar el contenido de la página esperado.
![\[Se muestra una ventana del navegador AWS CloudShell con un comando para mostrar el contenido de una página de servicio de App Runner\]](http://docs.aws.amazon.com/es_es/apprunner/latest/dg/images/api-cshell-curl.png)