AWS::Serverless::Application - AWS Serverless Application Model

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

Incorpora una aplicación sin servidor desdeAWS Serverless Application Repositoryo desde un bucket de Amazon S3 como aplicación anidada. Las aplicaciones anidadas se implementan como anidadasAWS::CloudFormation::Stackrecursos, que pueden contener varios otros recursos, incluidos otrosAWS::Serverless::Applicationde AWS.

Sintaxis

Para declarar esta entidad enAWS Serverless Application Model(AWS SAM), utilice la siguiente sintaxis.

YAML

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

Properties

Location

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

Si se proporciona una URL de plantilla, debe seguir el formato especificado en elDocumentación de TemplateUrl de CloudFormationy contiene una plantilla de CloudFormation o SAM válida. UnApplicationLocationObjectse puede utilizar para especificar una aplicación que se ha publicado en elAWS Serverless Application Repository.

Si se proporciona una ruta de archivo local, la plantilla debe pasar por el flujo de trabajo que incluye elsam deployosam package, para que la aplicación se transforme correctamente.

Type: String |Objeto ApplicationLocationObject

Obligatorio: Sí

AWS CloudFormationcompatibilidad: Esta propiedad es similar a laTemplateURLpropiedad de unAWS::CloudFormation::Stackrecurso. La versión de CloudFormation no toma unApplicationLocationObjectpara recuperar una aplicación delAWS Serverless Application Repository.

NotificationARNs

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

Type: Lista

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente alNotificationARNspropiedad de unAWS::CloudFormation::Stackrecurso.

Parameters

Valores de parámetros de aplicación.

Type: Mapeo

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente alParameterspropiedad de unAWS::CloudFormation::Stackrecurso.

Tags

Un mapa (cadena a cadena) que especifica las etiquetas que se agregarán a esta aplicación. Las claves y valores están limitados a caracteres alfanuméricos. Las claves pueden tener una longitud de entre 1 y 127 caracteres Unicode y no pueden llevar el prefijo aws:. Los valores pueden tener una longitud de entre 1 y 255 caracteres Unicode.

Type: Mapeo

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad es similar a laTagspropiedad de unAWS::CloudFormation::Stackrecurso. La propiedad Tags de SAM consta de pares Key:Value; en CloudFormation se compone de una lista de objetos Tag. Cuando se cree la pila, SAM añadirá automáticamente unlambda:createdBy:SAMetiqueta a esta aplicación. Además, si esta aplicación es de laAWS Serverless Application Repository, SAM también automáticamente las dos etiquetas adicionalesserverlessrepo:applicationId:ApplicationIdyserverlessrepo:semanticVersion:SemanticVersion.

TimeoutInMinutes

El período de tiempo, en minutos, que AWS CloudFormation espera a que la pila anidada alcance el estado CREATE_COMPLETE. El valor predeterminado es sin tiempo de espera. Cuando AWS CloudFormation detecta que la pila anidada ha alcanzado el estado CREATE_COMPLETE, marca el recurso de la pila anidada como CREATE_COMPLETE en la pila principal y reanuda la creación de la pila principal. Si el período de tiempo de espera vence antes de que la pila anidada alcance CREATE_COMPLETE, AWS CloudFormation marca la pila anidada como error y restaura la pila anidada y la pila principal.

Type: Entero

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente alTimeoutInMinutespropiedad de unAWS::CloudFormation::Stackrecurso.

Valores devueltos

Ref.

Cuando se proporciona el ID lógico de este recurso alReffunción intrínseca, devuelve el nombre del recurso del subyacenteAWS::CloudFormation::Stackrecurso.

Para obtener más información acerca del uso deRef, consulteRefen laAWS CloudFormationGuía del usuario de.

Fn::GetAtt

Fn::GetAtt devuelve un valor para un atributo especificado de este tipo. Los valores siguientes son los atributos disponibles y los valores devueltos de ejemplo.

Para obtener más información acerca del uso deFn::GetAtt, consulteFn::GetAtten laAWS CloudFormationGuía del usuario de.

Outputs.ApplicationOutputName

El valor de la salida de la pila con nombreApplicationOutputName.

Ejemplos

Aplicación SAR

Aplicación que utiliza 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

Normal Application

Aplicación desde una url de S3

YAML

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