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 Recursos AWS CloudFormation de AWS SAM generados.

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

PlantillaURL, ruta de archivo u objeto de ubicación de una aplicación anidada.

Si URL se proporciona una plantilla, debe seguir el formato especificado en la CloudFormation TemplateUrl documentación y contener una SAM plantilla 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 SNS temas de Amazon existentes a los que se envían notificaciones sobre eventos de pila.

Tipo: lista

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se transfiere 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 SAM consta de pares clave:valor; en CloudFormation ella se compone de una lista de objetos Tag. Cuando se cree la pila, SAM añadirá automáticamente una lambda:createdBy:SAM etiqueta a esta aplicación. Además, si esta aplicación es de AWS Serverless Application Repository, también SAM se eliminarán automáticamente las dos etiquetas adicionales serverlessrepo:applicationId:ApplicationId yserverlessrepo: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

SARAplicación

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/amzn-s3-demo-bucket/template.yaml