AWS::Serverless::Application

Integrar una aplicación sin servidor desde AWS Serverless Application Repository o desde un bucket de Amazon S3 como una aplicación anidada. Las aplicaciones anidadas se implementan como si estuvieran anidadas AWS::CloudFormation::Stackrecursos, que pueden contener varios otros recursos, incluidos otros AWS::Serverless::Application recursos.

nota

Cuando despliega en AWS CloudFormation, AWS SAM transforma sus AWS SAM recursos en AWS CloudFormation recursos. Para obtener más información, consulte AWS CloudFormation Recursos generados para AWS SAM.

Sintaxis

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

YAML

Type: AWS::Serverless::Application
Properties:
  Location: String | ApplicationLocationObject
  NotificationARNs: List
  Parameters: Map
  Tags: Map
  TimeoutInMinutes: Integer

Propiedades

Location

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 y contener una plantilla SAM CloudFormation o válida. ApplicationLocationObject se puede utilizar para especificar una aplicación que se ha publicado en AWS Serverless Application Repository

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 | ApplicationLocationObject

Obligatorio: sí

AWS CloudFormation compatibilidad: esta propiedad es similar a la TemplateURL propiedad de un AWS::CloudFormation::Stack recurso. La CloudFormation versión no tarda en ApplicationLocationObject recuperar una aplicación del AWS Serverless Application Repository.

NotificationARNs

Una lista de temas de Amazon SNS, a la que se envían notificaciones sobre eventos de la pila.

Tipo: lista

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la NotificationARNs propiedad de un AWS::CloudFormation::Stack recurso.

Parameters

Valores de los parámetros de aplicación.

Tipo: mapa

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la Parameters propiedad de un AWS::CloudFormation::Stack recurso.

Tags

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

AWS CloudFormation compatibilidad: esta propiedad es similar a la 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

El tiempo, en minutos, que se AWS CloudFormation espera a que la pila anidada alcance el CREATE_COMPLETE estado. El valor predeterminado es sin tiempo de espera. Cuando AWS 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 anidadaCREATE_COMPLETE, AWS CloudFormation marca la pila anidada como fallida y revierte tanto la pila anidada como la pila principal.

Tipo: entero

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se transfiere directamente a la TimeoutInMinutes propiedad de un recurso. AWS::CloudFormation::Stack

valores devueltos

Ref.

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 Ref en la Guía del usuario de AWS CloudFormation .

Ventilador:: GetAtt

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 Fn::GetAtt en la Guía del usuario de AWS CloudFormation .

Outputs.ApplicationOutputName

El valor de la salida de la pila con su nombre ApplicationOutputName.

Ejemplos

Aplicaciones SAR

Aplicación que usa una plantilla del Serverless Application Repository

YAML

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

Aplicación desde una URL de S3

YAML

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