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.

# AWS::Serverless::Application
<a name="sam-resource-application"></a>

Integrar una aplicación sin servidor desde [AWS Serverless Application Repository](https://serverlessrepo.aws.amazon.com/applications) o desde un bucket de Amazon S3 como una aplicación anidada. Las aplicaciones anidadas se implementasn como recursos anidados [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stack.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stack.html), que pueden contener varios otros recursos, incluidos otros recursos [AWS::Serverless::Application](#sam-resource-application).

**nota**  
Cuando despliega en AWS CloudFormation, AWS SAM transforma sus AWS SAM recursos en CloudFormation recursos. Para obtener más información, consulte [CloudFormation Recursos generados para AWS SAM](sam-specification-generated-resources.md).

## Sintaxis
<a name="sam-resource-application-syntax"></a>

Para declarar esta entidad en tu plantilla AWS Serverless Application Model (AWS SAM), usa la siguiente sintaxis.

### YAML
<a name="sam-resource-application-syntax.yaml"></a>

```
Type: AWS::Serverless::Application
Properties:
  [Location](#sam-application-location): String | ApplicationLocationObject
  [NotificationARNs](#sam-application-notificationarns): List
  [Parameters](#sam-application-parameters): Map
  [Tags](#sam-application-tags): Map
  [TimeoutInMinutes](#sam-application-timeoutinminutes): Integer
```

## Propiedades
<a name="sam-resource-application-properties"></a>

 `Location`   <a name="sam-application-location"></a>
URL de plantilla, ruta de archivo o objeto de ubicación de una aplicación anidada.  
Si se proporciona una URL de plantilla, debe seguir el formato especificado en la [CloudFormation TemplateUrl documentación](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-templateurl) y contener una plantilla SAM CloudFormation o válida. [ApplicationLocationObject](sam-property-application-applicationlocationobject.md) se puede utilizar para especificar una aplicación que se ha publicado en [AWS Serverless Application Repository](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/what-is-serverlessrepo.html)  
Si se proporciona una ruta de archivo local, la plantilla debe seguir el flujo de trabajo que incluye el `sam package` o el comando `sam deploy` para que la aplicación se transforme correctamente.  
*Tipo*: Cadena \$1 [ApplicationLocationObject](sam-property-application-applicationlocationobject.md)  
*Obligatorio*: sí  
*CloudFormation compatibilidad*: esta propiedad es similar a la `[TemplateURL](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-templateurl)` propiedad de un `AWS::CloudFormation::Stack` recurso. La CloudFormation versión no tarda en [ApplicationLocationObject](sam-property-application-applicationlocationobject.md) recuperar una aplicación del AWS Serverless Application Repository.

 `NotificationARNs`   <a name="sam-application-notificationarns"></a>
Una lista de temas de Amazon SNS, a la que se envían notificaciones sobre eventos de la pila.  
*Tipo*: lista  
*Obligatorio*: no  
*CloudFormation compatibilidad*: esta propiedad se pasa directamente a la `[NotificationARNs](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-notificationarns)` propiedad de un `AWS::CloudFormation::Stack` recurso.

 `Parameters`   <a name="sam-application-parameters"></a>
Valores de los parámetros de aplicación.  
*Tipo*: mapa  
*Obligatorio*: no  
*CloudFormation compatibilidad*: esta propiedad se pasa directamente a la `[Parameters](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-parameters)` propiedad de un `AWS::CloudFormation::Stack` recurso.

 `Tags`   <a name="sam-application-tags"></a>
Un mapa (cadena a cadena) que especifica las etiquetas agregadas a esta aplicación. Los valores y claves están limitados a caracteres alfanuméricos. Las claves pueden tener de 1 a 127 caracteres Unicode y no pueden ir precedidas de aws: Los valores pueden tener de 1 a 255 caracteres Unicode.  
*Tipo*: mapa  
*Obligatorio*: no  
*CloudFormation compatibilidad*: esta propiedad es similar a la `[Tags](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-tags)` propiedad de un `AWS::CloudFormation::Stack` recurso. La propiedad Tags de SAM consta de pares clave-valor; en CloudFormation ella, consiste en una lista de objetos Tag. Cuando se crea la pila, SAM añadirá automáticamente una etiqueta `lambda:createdBy:SAM` a esta aplicación. Además, si esta aplicación es de AWS Serverless Application Repository, SAM también almacenará automáticamente las dos etiquetas `serverlessrepo:applicationId:ApplicationId` adicionales y. `serverlessrepo:semanticVersion:SemanticVersion`

 `TimeoutInMinutes`   <a name="sam-application-timeoutinminutes"></a>
El tiempo, en minutos, que se CloudFormation espera a que la pila anidada alcance el `CREATE_COMPLETE` estado. El valor predeterminado es sin tiempo de espera. Cuando CloudFormation detecta que la pila anidada ha alcanzado el `CREATE_COMPLETE` estado, marca el recurso de la pila anidada como si estuviera `CREATE_COMPLETE` en la pila principal y reanudará la creación de la pila principal. Si el tiempo de espera expira antes de que llegue la pila anidada`CREATE_COMPLETE`, CloudFormation marca la pila anidada como fallida y revierte tanto la pila anidada como la pila principal.  
*Tipo*: entero  
*Obligatorio*: no  
*CloudFormation compatibilidad*: esta propiedad se transfiere directamente a la `[TimeoutInMinutes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-timeoutinminutes)` propiedad de un recurso. `AWS::CloudFormation::Stack`

## valores devueltos
<a name="sam-resource-application-return-values"></a>

### Ref.
<a name="sam-resource-application-return-values-ref"></a>

Cuando se proporciona el ID lógico de este recurso a la función intrínseca `Ref`, esta devuelve el nombre del recurso subyacente `AWS::CloudFormation::Stack`.

Para obtener más información sobre el uso de la función `Ref`, consulta [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html) en la *Guía del usuario de AWS CloudFormation *. 

### Ventilador: GetAtt
<a name="sam-resource-application-return-values-fn--getatt"></a>

`Fn::GetAtt` devuelve un valor para un atributo especificado de este tipo. A continuación se indican los atributos disponibles y los valores devueltos de muestra. 

Para obtener más información acerca de cómo usar `Fn::GetAtt`, consulta [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html) en la *Guía del usuario de AWS CloudFormation *. 

`Outputs.ApplicationOutputName`  <a name="Outputs.ApplicationOutputName-fn::getatt"></a>
El valor de la salida de la pila con su nombre `ApplicationOutputName`.

## Ejemplos
<a name="sam-resource-application--examples"></a>

### Aplicaciones SAR
<a name="sam-resource-application--examples--sar-application"></a>

Aplicación que usa una plantilla del Serverless Application Repository

#### YAML
<a name="sam-resource-application--examples--sar-application--yaml"></a>

```
Type: AWS::Serverless::Application
Properties:
  Location:
    ApplicationId: 'arn:aws:serverlessrepo:us-east-1:012345678901:applications/my-application'
    SemanticVersion: 1.0.0
  Parameters:
    StringParameter: parameter-value
    IntegerParameter: 2
```

### Aplicación normal
<a name="sam-resource-application--examples--normal-application"></a>

Aplicación desde una URL de S3

#### YAML
<a name="sam-resource-application--examples--normal-application--yaml"></a>

```
Type: AWS::Serverless::Application
Properties:
  Location: https://s3.amazonaws.com/sam-s3-demo-bucket/template.yaml
```

# ApplicationLocationObject
<a name="sam-property-application-applicationlocationobject"></a>

Una solicitud que se ha publicado en [AWS Serverless Application Repository](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/what-is-serverlessrepo.html).

## Sintaxis
<a name="sam-property-application-applicationlocationobject-syntax"></a>

Para declarar esta entidad en tu plantilla AWS Serverless Application Model (AWS SAM), usa la siguiente sintaxis.

### YAML
<a name="sam-property-application-applicationlocationobject-syntax.yaml"></a>

```
  [ApplicationId](#sam-application-applicationlocationobject-applicationid): String
  [SemanticVersion](#sam-application-applicationlocationobject-semanticversion): String
```

## Propiedades
<a name="sam-property-application-applicationlocationobject-properties"></a>

 `ApplicationId`   <a name="sam-application-applicationlocationobject-applicationid"></a>
El nombre de recurso de Amazon (ARN) de la aplicación.  
*Tipo:* cadena  
*Obligatorio*: sí  
*CloudFormation compatibilidad*: esta propiedad es exclusiva de AWS SAM y no tiene un CloudFormation equivalente.

 `SemanticVersion`   <a name="sam-application-applicationlocationobject-semanticversion"></a>
La versión semántica de la aplicación.  
*Tipo:* cadena  
*Obligatorio*: sí  
*CloudFormation compatibilidad*: esta propiedad es exclusiva de AWS SAM y no tiene un CloudFormation equivalente.

## Ejemplos
<a name="sam-property-application-applicationlocationobject--examples"></a>

### my-application
<a name="sam-property-application-applicationlocationobject--examples--my-application"></a>

Ejemplo de aplicación de ubicación de un objeto

#### YAML
<a name="sam-property-application-applicationlocationobject--examples--my-application--yaml"></a>

```
Location:
  ApplicationId: 'arn:aws:serverlessrepo:us-east-1:012345678901:applications/my-application'
  SemanticVersion: 1.0.0
```