Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).
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 App Runner que utilizan AWS CLI
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar situaciones comunes AWS Command Line Interface con App Runner.
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `associate-custom-domain`
En el siguiente ejemplo de código, se muestra cómo utilizar `associate-custom-domain`.
**AWS CLI**
**Asociación de un nombre de dominio y del subdominio www a un servicio**
En el siguiente ejemplo de `associate-custom-domain`, se asocia un nombre de dominio personalizado que se controla con un servicio de App Runner. El nombre de dominio es el dominio raíz `example.com`, incluido el caso especial de subdominio `www.example.com`.
```
aws apprunner associate-custom-domain \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa",
"DomainName": "example.com",
"EnableWWWSubdomain": true
}
```
Salida:
```
{
"CustomDomain": {
"CertificateValidationRecords": [
{
"Name": "_70d3f50a94f7c72dc28784cf55db2f6b.example.com",
"Status": "PENDING_VALIDATION",
"Type": "CNAME",
"Value": "_1270c137383c6307b6832db02504c4b0.bsgbmzkfwj.acm-validations.aws."
},
{
"Name": "_287870d3f50a94f7c72dc4cf55db2f6b.www.example.com",
"Status": "PENDING_VALIDATION",
"Type": "CNAME",
"Value": "_832db01270c137383c6307b62504c4b0.mzkbsgbfwj.acm-validations.aws."
}
],
"DomainName": "example.com",
"EnableWWWSubdomain": true,
"Status": "CREATING"
},
"DNSTarget": "psbqam834h.us-east-1.awsapprunner.com",
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa"
}
```
+ Para obtener más información sobre la API, consulta [AssociateCustomDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/associate-custom-domain.html)la *Referencia de AWS CLI comandos*.
### `create-auto-scaling-configuration`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-auto-scaling-configuration`.
**AWS CLI**
**Creación de una configuración de escalado automático de alta disponibilidad**
En el siguiente ejemplo de `create-auto-scaling-configuration`, se crea una configuración de escalado automático optimizada para alta disponibilidad estableciendo `MinSize` en un valor de 5. Con esta configuración, App Runner intenta distribuir las instancias de servicio en el mayor número posible de zonas de disponibilidad, hasta cinco, según la AWS región.
Con la llamada se obtiene un objeto `AutoScalingConfiguration` y el resto de la configuración se establece en los valores predeterminados. En el ejemplo, esta es la primera llamada para crear una configuración denominada `high-availability`. La revisión se establece en 1 y se trata de la revisión más reciente.
```
aws apprunner create-auto-scaling-configuration \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"AutoScalingConfigurationName": "high-availability",
"MinSize": 5
}
```
Salida:
```
{
"AutoScalingConfiguration": {
"AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/1/2f50e7656d7819fead0f59672e68042e",
"AutoScalingConfigurationName": "high-availability",
"AutoScalingConfigurationRevision": 1,
"CreatedAt": "2020-11-03T00:29:17Z",
"Latest": true,
"Status": "ACTIVE",
"MaxConcurrency": 100,
"MaxSize": 50,
"MinSize": 5
}
}
```
+ Para obtener más información sobre la API, consulte [CreateAutoScalingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/create-auto-scaling-configuration.html)la *Referencia de AWS CLI comandos*.
### `create-connection`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-connection`.
**AWS CLI**
**Para crear una GitHub conexión**
El siguiente `create-connection` ejemplo crea una conexión a un repositorio de GitHub código privado. El estado de la conexión después de una llamada correcta es `PENDING_HANDSHAKE`. El motivo es que aún no ha tenido lugar un protocolo de enlace de autenticación con el proveedor. Se completa el protocolo de enlace con la consola de App Runner.
```
aws apprunner create-connection \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ConnectionName": "my-github-connection",
"ProviderType": "GITHUB"
}
```
Salida:
```
{
"Connection": {
"ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection",
"ConnectionName": "my-github-connection",
"Status": "PENDING_HANDSHAKE",
"CreatedAt": "2020-11-03T00:32:51Z",
"ProviderType": "GITHUB"
}
}
```
Para obtener más información, consulte [Managing App Runner connections](https://docs.aws.amazon.com/apprunner/latest/dg/manage-connections.html) en la *Guía para desarrolladores de AWS App Runner*.
+ Para obtener más información sobre la API, consulte [CreateConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/create-connection.html)la *Referencia de AWS CLI comandos*.
### `create-service`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-service`.
**AWS CLI**
**Ejemplo 1: cómo crear un servicio de repositorio de código fuente**
En el siguiente ejemplo de `create-service`, se crea un servicio de App Runner basado en un repositorio de código fuente de Python.
```
aws apprunner create-service \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ServiceName": "python-app",
"SourceConfiguration": {
"AuthenticationConfiguration": {
"ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e"
},
"AutoDeploymentsEnabled": true,
"CodeRepository": {
"RepositoryUrl": "https://github.com/my-account/python-hello",
"SourceCodeVersion": {
"Type": "BRANCH",
"Value": "main"
},
"CodeConfiguration": {
"ConfigurationSource": "API",
"CodeConfigurationValues": {
"Runtime": "PYTHON_3",
"BuildCommand": "pip install -r requirements.txt",
"StartCommand": "python server.py",
"Port": "8080",
"RuntimeEnvironmentVariables": [
{
"NAME": "Jane"
}
]
}
}
}
},
"InstanceConfiguration": {
"CPU": "1 vCPU",
"Memory": "3 GB"
}
}
```
Salida:
```
{
"OperationId": "17fe9f55-7e91-4097-b243-fcabbb69a4cf",
"Service": {
"CreatedAt": "2020-11-20T19:05:25Z",
"UpdatedAt": "2020-11-20T19:05:25Z",
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceName": "python-app",
"ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
"SourceConfiguration": {
"AuthenticationConfiguration": {
"ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e"
},
"AutoDeploymentsEnabled": true,
"CodeRepository": {
"CodeConfiguration": {
"CodeConfigurationValues": {
"BuildCommand": "pip install -r requirements.txt",
"Port": "8080",
"Runtime": "PYTHON_3",
"RuntimeEnvironmentVariables": [
{
"NAME": "Jane"
}
],
"StartCommand": "python server.py"
},
"ConfigurationSource": "Api"
},
"RepositoryUrl": "https://github.com/my-account/python-hello",
"SourceCodeVersion": {
"Type": "BRANCH",
"Value": "main"
}
}
},
"Status": "OPERATION_IN_PROGRESS",
"InstanceConfiguration": {
"CPU": "1 vCPU",
"Memory": "3 GB"
}
}
}
```
**Ejemplo 2: cómo crear un servicio de repositorio de código fuente**
En el siguiente ejemplo de `create-service`, se crea un servicio de App Runner basado en un repositorio de código fuente de Python.
```
aws apprunner create-service \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ServiceName": "python-app",
"SourceConfiguration": {
"AuthenticationConfiguration": {
"ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e"
},
"AutoDeploymentsEnabled": true,
"CodeRepository": {
"RepositoryUrl": "https://github.com/my-account/python-hello",
"SourceCodeVersion": {
"Type": "BRANCH",
"Value": "main"
},
"CodeConfiguration": {
"ConfigurationSource": "API",
"CodeConfigurationValues": {
"Runtime": "PYTHON_3",
"BuildCommand": "pip install -r requirements.txt",
"StartCommand": "python server.py",
"Port": "8080",
"RuntimeEnvironmentVariables": [
{
"NAME": "Jane"
}
]
}
}
}
},
"InstanceConfiguration": {
"CPU": "1 vCPU",
"Memory": "3 GB"
}
}
```
Salida:
```
{
"OperationId": "17fe9f55-7e91-4097-b243-fcabbb69a4cf",
"Service": {
"CreatedAt": "2020-11-20T19:05:25Z",
"UpdatedAt": "2020-11-20T19:05:25Z",
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceName": "python-app",
"ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
"SourceConfiguration": {
"AuthenticationConfiguration": {
"ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e"
},
"AutoDeploymentsEnabled": true,
"CodeRepository": {
"CodeConfiguration": {
"CodeConfigurationValues": {
"BuildCommand": "pip install -r requirements.txt",
"Port": "8080",
"Runtime": "PYTHON_3",
"RuntimeEnvironmentVariables": [
{
"NAME": "Jane"
}
],
"StartCommand": "python server.py"
},
"ConfigurationSource": "Api"
},
"RepositoryUrl": "https://github.com/my-account/python-hello",
"SourceCodeVersion": {
"Type": "BRANCH",
"Value": "main"
}
}
},
"Status": "OPERATION_IN_PROGRESS",
"InstanceConfiguration": {
"CPU": "1 vCPU",
"Memory": "3 GB"
}
}
}
```
**Ejemplo 3: cómo crear un servicio de repositorio de imagen de origen**
En el siguiente ejemplo de `create-service`, se crea un servicio de App Runner basado en una imagen almacenada en Elastic Container Registry (ECR).
```
aws apprunner create-service \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ServiceName": "golang-container-app",
"SourceConfiguration": {
"AuthenticationConfiguration": {
"AccessRoleArn": "arn:aws:iam::123456789012:role/my-ecr-role"
},
"AutoDeploymentsEnabled": true,
"ImageRepository": {
"ImageIdentifier": "123456789012.dkr.ecr.us-east-1.amazonaws.com/golang-app:latest",
"ImageConfiguration": {
"Port": "8080",
"RuntimeEnvironmentVariables": [
{
"NAME": "Jane"
}
]
},
"ImageRepositoryType": "ECR"
}
},
"InstanceConfiguration": {
"CPU": "1 vCPU",
"Memory": "3 GB"
}
}
```
Salida:
```
{
"OperationId": "17fe9f55-7e91-4097-b243-fcabbb69a4cf",
"Service": {
"CreatedAt": "2020-11-06T23:15:30Z",
"UpdatedAt": "2020-11-06T23:15:30Z",
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/golang-container-app/51728f8a20ce46d39b25398a6c8e9d1a",
"ServiceId": "51728f8a20ce46d39b25398a6c8e9d1a",
"ServiceName": "golang-container-app",
"ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
"SourceConfiguration": {
"AuthenticationConfiguration": {
"AccessRoleArn": "arn:aws:iam::123456789012:role/my-ecr-role"
},
"AutoDeploymentsEnabled": true,
"ImageRepository": {
"ImageIdentifier": "123456789012.dkr.ecr.us-east-1.amazonaws.com/golang-app:latest",
"ImageConfiguration": {
"Port": "8080",
"RuntimeEnvironmentVariables": [
{
"NAME": "Jane"
}
]
},
"ImageRepositoryType": "ECR"
}
},
"Status": "OPERATION_IN_PROGRESS",
"InstanceConfiguration": {
"CPU": "1 vCPU",
"Memory": "3 GB"
}
}
}
```
+ Para obtener más información sobre la API, consulte [CreateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/create-service.html)la *Referencia de AWS CLI comandos*.
### `delete-auto-scaling-configuration`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-auto-scaling-configuration`.
**AWS CLI**
**Ejemplo 1: cómo eliminar la última revisión activa de una configuración de escalado automático**
En el siguiente ejemplo de `delete-auto-scaling-configuration`, se elimina la última revisión activa de una configuración de escalado automático de App Runner. Para eliminar la última revisión activa, especifique un nombre de recurso de Amazon (ARN) que termine con el nombre de la configuración, sin el componente de revisión.
En el ejemplo, existen dos revisiones antes de esta acción. Por lo tanto, se elimina la revisión 2 (la más reciente). Sin embargo, ahora se muestra `"Latest": false`, ya que, tras ser eliminada, ya no es la última revisión activa.
```
aws apprunner delete-auto-scaling-configuration \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability"
}
```
Salida:
```
{
"AutoScalingConfiguration": {
"AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/2/e76562f50d78042e819fead0f59672e6",
"AutoScalingConfigurationName": "high-availability",
"AutoScalingConfigurationRevision": 2,
"CreatedAt": "2021-02-25T17:42:59Z",
"DeletedAt": "2021-03-02T08:07:06Z",
"Latest": false,
"Status": "INACTIVE",
"MaxConcurrency": 30,
"MaxSize": 90,
"MinSize": 5
}
}
```
**Ejemplo 2: cómo eliminar una revisión específica de una configuración de escalado automático**
En el siguiente ejemplo de `delete-auto-scaling-configuration`, se elimina una revisión específica de una configuración de escalado automático de App Runner. Para eliminar una revisión específica, especifique un ARN que incluya el número de revisión.
En el ejemplo, existen varias revisiones antes de esta acción. La acción elimina la revisión `1`.
```
aws apprunner delete-auto-scaling-configuration \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/1"
}
```
Salida:
```
{
"AutoScalingConfiguration": {
"AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/1/2f50e7656d7819fead0f59672e68042e",
"AutoScalingConfigurationName": "high-availability",
"AutoScalingConfigurationRevision": 1,
"CreatedAt": "2020-11-03T00:29:17Z",
"DeletedAt": "2021-03-02T08:07:06Z",
"Latest": false,
"Status": "INACTIVE",
"MaxConcurrency": 100,
"MaxSize": 50,
"MinSize": 5
}
}
```
+ Para obtener más información sobre la API, consulte [DeleteAutoScalingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/delete-auto-scaling-configuration.html)la *Referencia de AWS CLI comandos*.
### `delete-connection`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-connection`.
**AWS CLI**
**Para eliminar una conexión**
En el siguiente ejemplo de `delete-connection`, se elimina una conexión de App Runner. El estado de la conexión después de una llamada correcta es `DELETED`. El motivo es que la conexión ya no está disponible.
```
aws apprunner delete-connection \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection"
}
```
Salida:
```
{
"Connection": {
"ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection",
"ConnectionName": "my-github-connection",
"Status": "DELETED",
"CreatedAt": "2020-11-03T00:32:51Z",
"ProviderType": "GITHUB"
}
}
```
+ Para obtener más información sobre la API, consulte [DeleteConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/delete-connection.html)la *Referencia de AWS CLI comandos*.
### `delete-service`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-service`.
**AWS CLI**
**Para eliminar un servicio**
En el siguiente ejemplo de `delete-service`, se elimina un servicio de App Runner.
```
aws apprunner delete-service \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa"
}
```
Salida:
```
{
"OperationId": "17fe9f55-7e91-4097-b243-fcabbb69a4cf",
"Service": {
"CreatedAt": "2020-11-20T19:05:25Z",
"UpdatedAt": "2020-11-20T19:05:25Z",
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceName": "python-app",
"ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
"SourceConfiguration": {
"AuthenticationConfiguration": {
"ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e"
},
"AutoDeploymentsEnabled": true,
"CodeRepository": {
"CodeConfiguration": {
"CodeConfigurationValues": {
"BuildCommand": "pip install -r requirements.txt",
"Port": "8080",
"Runtime": "PYTHON_3",
"RuntimeEnvironmentVariables": [
{
"NAME": "Jane"
}
],
"StartCommand": "python server.py"
},
"ConfigurationSource": "Api"
},
"RepositoryUrl": "https://github.com/my-account/python-hello",
"SourceCodeVersion": {
"Type": "BRANCH",
"Value": "main"
}
}
},
"Status": "OPERATION_IN_PROGRESS",
"InstanceConfiguration": {
"CPU": "1 vCPU",
"Memory": "3 GB"
}
}
}
```
+ Para obtener más información sobre la API, consulte [DeleteService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/delete-service.html)la *Referencia de AWS CLI comandos*.
### `describe-auto-scaling-configuration`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-auto-scaling-configuration`.
**AWS CLI**
**Ejemplo 1: cómo describir la última revisión activa de una configuración de escalado automático**
En el siguiente ejemplo de `describe-auto-scaling-configuration`, se obtiene una descripción de la última revisión activa de una configuración de escalado automático de App Runner. Para eliminar la última revisión activa, especifique un ARN que termine con el nombre de la configuración, sin el componente de revisión.
En el ejemplo, existen dos revisiones. Por lo tanto, se elimina la revisión `2` (la más reciente). El objeto resultante muestra `"Latest": true`.
```
aws apprunner describe-auto-scaling-configuration \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability"
}
```
Salida:
```
{
"AutoScalingConfiguration": {
"AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/2/e76562f50d78042e819fead0f59672e6",
"AutoScalingConfigurationName": "high-availability",
"AutoScalingConfigurationRevision": 2,
"CreatedAt": "2021-02-25T17:42:59Z",
"Latest": true,
"Status": "ACTIVE",
"MaxConcurrency": 30,
"MaxSize": 90,
"MinSize": 5
}
}
```
**Ejemplo 2: cómo describir una revisión específica de una configuración de escalado automático**
En el siguiente ejemplo de `describe-auto-scaling-configuration`, se obtiene una descripción de una revisión específica de una configuración de escalado automático de App Runner. Para describir una revisión específica, especifique un ARN que incluya el número de revisión.
En el ejemplo, existen varias revisiones y se consulta la revisión `1`. El objeto resultante muestra `"Latest": false`.
```
aws apprunner describe-auto-scaling-configuration \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/1"
}
```
Salida:
```
{
"AutoScalingConfiguration": {
"AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/1/2f50e7656d7819fead0f59672e68042e",
"AutoScalingConfigurationName": "high-availability",
"AutoScalingConfigurationRevision": 1,
"CreatedAt": "2020-11-03T00:29:17Z",
"Latest": false,
"Status": "ACTIVE",
"MaxConcurrency": 100,
"MaxSize": 50,
"MinSize": 5
}
}
```
+ Para obtener más información sobre la API, consulte [DescribeAutoScalingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/describe-auto-scaling-configuration.html)la *Referencia de AWS CLI comandos*.
### `describe-custom-domains`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-custom-domains`.
**AWS CLI**
**Para obtener descripciones de nombres de dominio personalizados y asociados a un servicio**
En el siguiente ejemplo de `describe-custom-domains`, se muestran descripciones y el estado de los nombres de dominio personalizados y asociados a un servicio de App Runner.
```
aws apprunner describe-custom-domains \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa",
"DomainName": "example.com",
"EnableWWWSubdomain": true
}
```
Salida:
```
{
"CustomDomains": [
{
"CertificateValidationRecords": [
{
"Name": "_70d3f50a94f7c72dc28784cf55db2f6b.example.com",
"Status": "PENDING_VALIDATION",
"Type": "CNAME",
"Value": "_1270c137383c6307b6832db02504c4b0.bsgbmzkfwj.acm-validations.aws."
},
{
"Name": "_287870d3f50a94f7c72dc4cf55db2f6b.www.example.com",
"Status": "PENDING_VALIDATION",
"Type": "CNAME",
"Value": "_832db01270c137383c6307b62504c4b0.mzkbsgbfwj.acm-validations.aws."
}
],
"DomainName": "example.com",
"EnableWWWSubdomain": true,
"Status": "PENDING_CERTIFICATE_DNS_VALIDATION"
},
{
"CertificateValidationRecords": [
{
"Name": "_a94f784c70d3f507c72dc28f55db2f6b.deals.example.com",
"Status": "SUCCESS",
"Type": "CNAME",
"Value": "_2db02504c1270c137383c6307b6834b0.bsgbmzkfwj.acm-validations.aws."
}
],
"DomainName": "deals.example.com",
"EnableWWWSubdomain": false,
"Status": "ACTIVE"
}
],
"DNSTarget": "psbqam834h.us-east-1.awsapprunner.com",
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa"
}
```
+ Para obtener más información sobre la API, consulte [DescribeCustomDomains](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/describe-custom-domains.html)la *Referencia de AWS CLI comandos*.
### `describe-service`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-service`.
**AWS CLI**
**Para describir un servicio**
En el siguiente ejemplo de `describe-service`, se obtiene una descripción de un servicio de App Runner.
```
aws apprunner describe-service \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa"
}
```
Salida:
```
{
"Service": {
"CreatedAt": "2020-11-20T19:05:25Z",
"UpdatedAt": "2020-11-20T19:05:25Z",
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceName": "python-app",
"ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
"SourceConfiguration": {
"AuthenticationConfiguration": {
"ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e"
},
"AutoDeploymentsEnabled": true,
"CodeRepository": {
"CodeConfiguration": {
"CodeConfigurationValues": {
"BuildCommand": "pip install -r requirements.txt",
"Port": "8080",
"Runtime": "PYTHON_3",
"RuntimeEnvironmentVariables": [
{
"NAME": "Jane"
}
],
"StartCommand": "python server.py"
},
"ConfigurationSource": "Api"
},
"RepositoryUrl": "https://github.com/my-account/python-hello",
"SourceCodeVersion": {
"Type": "BRANCH",
"Value": "main"
}
}
},
"Status": "RUNNING",
"InstanceConfiguration": {
"CPU": "1 vCPU",
"Memory": "3 GB"
}
}
}
```
+ Para obtener más información sobre la API, consulte [DescribeService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/describe-service.html)la *Referencia de AWS CLI comandos*.
### `disassociate-custom-domain`
En el siguiente ejemplo de código, se muestra cómo utilizar `disassociate-custom-domain`.
**AWS CLI**
**Desasociación de un nombre de dominio de un servicio**
En el siguiente ejemplo de `disassociate-custom-domain`, se desasocia el dominio `example.com` de un servicio de App Runner. La llamada también desasocia el subdominio `www.example.com` que estaba asociado al dominio raíz.
```
aws apprunner disassociate-custom-domain \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa",
"DomainName": "example.com"
}
```
Salida:
```
{
"CustomDomain": {
"CertificateValidationRecords": [
{
"Name": "_70d3f50a94f7c72dc28784cf55db2f6b.example.com",
"Status": "PENDING_VALIDATION",
"Type": "CNAME",
"Value": "_1270c137383c6307b6832db02504c4b0.bsgbmzkfwj.acm-validations.aws."
},
{
"Name": "_287870d3f50a94f7c72dc4cf55db2f6b.www.example.com",
"Status": "PENDING_VALIDATION",
"Type": "CNAME",
"Value": "_832db01270c137383c6307b62504c4b0.mzkbsgbfwj.acm-validations.aws."
}
],
"DomainName": "example.com",
"EnableWWWSubdomain": true,
"Status": "DELETING"
},
"DNSTarget": "psbqam834h.us-east-1.awsapprunner.com",
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa"
}
```
+ Para obtener más información sobre la API, consulte [DisassociateCustomDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/disassociate-custom-domain.html)la *Referencia de AWS CLI comandos*.
### `list-auto-scaling-configurations`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-auto-scaling-configurations`.
**AWS CLI**
**Generación de una lista paginada de las configuraciones de escalado automático de App Runner**
En el siguiente `list-auto-scaling-configurations` ejemplo, se enumeran todas las configuraciones de escalado automático de App Runner de tu AWS cuenta. En cada respuesta se indican hasta cinco configuraciones de escalado automático. `AutoScalingConfigurationName` y `LatestOnly` no se especifican. Los valores predeterminados hacen que aparezca la última revisión de todas las configuraciones activas.
En este ejemplo, la respuesta incluye dos resultados y no hay otros adicionales, por lo que no se obtiene ningún `NextToken`.
```
aws apprunner list-auto-scaling-configurations \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"MaxResults": 5
}
```
Salida:
```
{
"AutoScalingConfigurationSummaryList": [
{
"AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/2/e76562f50d78042e819fead0f59672e6",
"AutoScalingConfigurationName": "high-availability",
"AutoScalingConfigurationRevision": 2
},
{
"AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/low-cost/1/50d7804e7656fead0f59672e62f2e819",
"AutoScalingConfigurationName": "low-cost",
"AutoScalingConfigurationRevision": 1
}
]
}
```
+ Para obtener más información sobre la API, consulte [ListAutoScalingConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/list-auto-scaling-configurations.html)la *Referencia de AWS CLI comandos*.
### `list-connections`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-connections`.
**AWS CLI**
**Ejemplo 1: cómo generar una lista de todas las conexiones**
En el siguiente `list-connections` ejemplo, se enumeran todas las conexiones de App Runner de la AWS cuenta.
```
aws apprunner list-connections
```
Salida:
```
{
"ConnectionSummaryList": [
{
"ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection",
"ConnectionName": "my-github-connection",
"Status": "AVAILABLE",
"CreatedAt": "2020-11-03T00:32:51Z",
"ProviderType": "GITHUB"
},
{
"ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-org-connection",
"ConnectionName": "my-github-org-connection",
"Status": "AVAILABLE",
"CreatedAt": "2020-11-03T02:54:17Z",
"ProviderType": "GITHUB"
}
]
}
```
**Ejemplo 2: cómo indicar una conexión por el nombre**
En el siguiente ejemplo de `list-connections`, se indica una conexión por el nombre.
```
aws apprunner list-connections \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ConnectionName": "my-github-org-connection"
}
```
Salida:
```
{
"ConnectionSummaryList": [
{
"ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-org-connection",
"ConnectionName": "my-github-org-connection",
"Status": "AVAILABLE",
"CreatedAt": "2020-11-03T02:54:17Z",
"ProviderType": "GITHUB"
}
]
}
```
+ Para obtener más información sobre la API, consulte [ListConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/list-connections.html)la *Referencia de AWS CLI comandos*.
### `list-operations`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-operations`.
**AWS CLI**
**Generación de una lista de las operaciones realizadas en un servicio**
En el siguiente ejemplo de `list-operations`, se genera una lista de todas las operaciones que se han realizado en un servicio de App Runner hasta el momento. En este ejemplo, el servicio es nuevo y solo se ha realizado una operación del tipo `CREATE_SERVICE`.
```
aws apprunner list-operations \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa"
}
```
Salida:
```
{
"OperationSummaryList": [
{
"EndedAt": 1606156217,
"Id": "17fe9f55-7e91-4097-b243-fcabbb69a4cf",
"StartedAt": 1606156014,
"Status": "SUCCEEDED",
"TargetArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa",
"Type": "CREATE_SERVICE",
"UpdatedAt": 1606156217
}
]
}
```
+ Para obtener más información sobre la API, consulte [ListOperations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/list-operations.html)la *Referencia de AWS CLI comandos*.
### `list-services`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-services`.
**AWS CLI**
**Generación de una lista paginada de los servicios de App Runner**
En el siguiente `list-services` ejemplo, se enumeran todos los servicios de App Runner de la AWS cuenta. En cada respuesta se muestran hasta dos servicios. En este ejemplo, se muestra la primera solicitud. La respuesta incluye dos resultados y un token que se puede usar en la siguiente solicitud. Cuando una respuesta posterior no incluye un token, se muestran todos los servicios.
```
aws apprunner list-services \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"MaxResults": 2
}
```
Salida:
```
{
"NextToken": "eyJDdXN0b21lckFjY291bnRJZCI6IjI3MDIwNTQwMjg0NSIsIlNlcnZpY2VTdGF0dXNDb2RlIjoiUFJPVklTSU9OSU5HIiwiSGFzaEtleSI6IjI3MDIwNTQwMjg0NSNhYjhmOTRjZmUyOWE0NjBmYjg3NjBhZmQyZWU4NzU1NSJ9",
"ServiceSummaryList": [
{
"CreatedAt": "2020-11-20T19:05:25Z",
"UpdatedAt": "2020-11-23T12:41:37Z",
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceName": "python-app",
"ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
"Status": "RUNNING"
},
{
"CreatedAt": "2020-11-06T23:15:30Z",
"UpdatedAt": "2020-11-23T13:21:22Z",
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/golang-container-app/ab8f94cfe29a460fb8760afd2ee87555",
"ServiceId": "ab8f94cfe29a460fb8760afd2ee87555",
"ServiceName": "golang-container-app",
"ServiceUrl": "e2m8rrrx33.us-east-1.awsapprunner.com",
"Status": "RUNNING"
}
]
}
```
+ Para obtener información sobre la API, consulte [ListServices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/list-services.html)la *Referencia de AWS CLI comandos*.
### `list-tags-for-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-tags-for-resource`.
**AWS CLI**
**Generación de una lista de las etiquetas asociadas a un servicio de App Runner**
En el siguiente ejemplo de `list-tags-for-resource`, se muestran todas las etiquetas asociadas con un servicio de App Runner.
```
aws apprunner list-tags-for-resource \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ResourceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa"
}
```
Salida:
```
{
"Tags": [
{
"Key": "Department",
"Value": "Retail"
},
{
"Key": "CustomerId",
"Value": "56439872357912"
}
]
}
```
+ Para obtener más información sobre la API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/list-tags-for-resource.html)la *Referencia de AWS CLI comandos*.
### `pause-service`
En el siguiente ejemplo de código, se muestra cómo utilizar `pause-service`.
**AWS CLI**
**Pausa de un servicio**
En el siguiente ejemplo de `pause-service`, se pausa un servicio de App Runner.
```
aws apprunner pause-service \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa"
}
```
Salida:
```
{
"OperationId": "17fe9f55-7e91-4097-b243-fcabbb69a4cf",
"Service": {
"CreatedAt": "2020-11-20T19:05:25Z",
"UpdatedAt": "2020-11-23T12:41:37Z",
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceName": "python-app",
"ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
"SourceConfiguration": {
"AuthenticationConfiguration": {
"ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e"
},
"AutoDeploymentsEnabled": true,
"CodeRepository": {
"CodeConfiguration": {
"CodeConfigurationValues": {
"BuildCommand": "pip install -r requirements.txt",
"Port": "8080",
"Runtime": "PYTHON_3",
"RuntimeEnvironmentVariables": [
{
"NAME": "Jane"
}
],
"StartCommand": "python server.py"
},
"ConfigurationSource": "Api"
},
"RepositoryUrl": "https://github.com/my-account/python-hello",
"SourceCodeVersion": {
"Type": "BRANCH",
"Value": "main"
}
}
},
"Status": "OPERATION_IN_PROGRESS",
"InstanceConfiguration": {
"CPU": "1 vCPU",
"Memory": "3 GB"
}
}
}
```
+ Para obtener más información sobre la API, consulte [PauseService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/pause-service.html)la *Referencia de AWS CLI comandos*.
### `resume-service`
En el siguiente ejemplo de código, se muestra cómo utilizar `resume-service`.
**AWS CLI**
**Reanudación de un servicio**
En el siguiente ejemplo de `resume-service`, se reanuda un servicio de App Runner.
```
aws apprunner resume-service \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa"
}
```
Salida:
```
{
"OperationId": "17fe9f55-7e91-4097-b243-fcabbb69a4cf",
"Service": {
"CreatedAt": "2020-11-20T19:05:25Z",
"UpdatedAt": "2020-11-23T12:41:37Z",
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceName": "python-app",
"ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
"SourceConfiguration": {
"AuthenticationConfiguration": {
"ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e"
},
"AutoDeploymentsEnabled": true,
"CodeRepository": {
"CodeConfiguration": {
"CodeConfigurationValues": {
"BuildCommand": "pip install -r requirements.txt",
"Port": "8080",
"Runtime": "PYTHON_3",
"RuntimeEnvironmentVariables": [
{
"NAME": "Jane"
}
],
"StartCommand": "python server.py"
},
"ConfigurationSource": "Api"
},
"RepositoryUrl": "https://github.com/my-account/python-hello",
"SourceCodeVersion": {
"Type": "BRANCH",
"Value": "main"
}
}
},
"Status": "OPERATION_IN_PROGRESS",
"InstanceConfiguration": {
"CPU": "1 vCPU",
"Memory": "3 GB"
}
}
}
```
+ Para obtener más información sobre la API, consulte [ResumeService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/resume-service.html)la *Referencia de AWS CLI comandos*.
### `start-deployment`
En el siguiente ejemplo de código, se muestra cómo utilizar `start-deployment`.
**AWS CLI**
**Inicio de una implementación manual**
En el siguiente ejemplo de `start-deployment`, se realiza una implementación manual en un servicio de App Runner.
```
aws apprunner start-deployment \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa"
}
```
Salida:
```
{
"OperationId": "853a7d5b-fc9f-4730-831b-fd8037ab832a"
}
```
+ Para obtener más información sobre la API, consulte [StartDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/start-deployment.html)la *Referencia de AWS CLI comandos*.
### `tag-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `tag-resource`.
**AWS CLI**
**Adición de etiquetas a un servicio de App Runner**
En el siguiente ejemplo de `tag-resource`, se añaden dos etiquetas a un servicio de App Runner.
```
aws apprunner tag-resource \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ResourceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa",
"Tags": [
{
"Key": "Department",
"Value": "Retail"
},
{
"Key": "CustomerId",
"Value": "56439872357912"
}
]
}
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/tag-resource.html)la *Referencia de AWS CLI comandos*.
### `untag-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `untag-resource`.
**AWS CLI**
**Eliminación de etiquetas de un servicio de App Runner**
En el siguiente ejemplo de `untag-resource`, se eliminan dos etiquetas de un servicio de App Runner.
```
aws apprunner untag-resource \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ResourceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa",
"TagKeys": [
"Department",
"CustomerId"
]
}
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/untag-resource.html)la *Referencia de AWS CLI comandos*.
### `update-service`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-service`.
**AWS CLI**
**Actualización del tamaño de memoria**
En el siguiente ejemplo de `update-service`, se actualiza a 2048 MiB el tamaño de memoria de las instancias (unidades de escalado) de un servicio de App Runner.
Cuando la llamada se realiza correctamente, App Runner inicia un proceso de actualización asíncrono. La estructura de `Service` que devuelve la llamada refleja el nuevo valor de memoria que aplica esta llamada.
```
aws apprunner update-service \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa",
"InstanceConfiguration": {
"Memory": "4 GB"
}
}
```
Salida:
```
{
"OperationId": "17fe9f55-7e91-4097-b243-fcabbb69a4cf",
"Service": {
"CreatedAt": "2020-11-20T19:05:25Z",
"UpdatedAt": "2020-11-23T12:41:37Z",
"ServiceArn": "arn:aws:apprunner:us-east-1:123456789012:service/python-app/8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceName": "python-app",
"ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
"SourceConfiguration": {
"AuthenticationConfiguration": {
"ConnectionArn": "arn:aws:apprunner:us-east-1:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e"
},
"AutoDeploymentsEnabled": true,
"CodeRepository": {
"CodeConfiguration": {
"CodeConfigurationValues": {
"BuildCommand": "pip install -r requirements.txt",
"Port": "8080",
"Runtime": "PYTHON_3",
"RuntimeEnvironmentVariables": [
{
"NAME": "Jane"
}
],
"StartCommand": "python server.py"
},
"ConfigurationSource": "Api"
},
"RepositoryUrl": "https://github.com/my-account/python-hello",
"SourceCodeVersion": {
"Type": "BRANCH",
"Value": "main"
}
}
},
"Status": "OPERATION_IN_PROGRESS",
"InstanceConfiguration": {
"CPU": "1 vCPU",
"Memory": "4 GB"
}
}
}
```
+ Para obtener más información sobre la API, consulte [UpdateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apprunner/update-service.html)la *Referencia de AWS CLI comandos*.