AWS::Serverless::Application

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

nota

Cuando despliega enAWS CloudFormation,AWS SAM transforma susAWS SAM recursos enAWS CloudFormation recursos. Para obtener más información, consulte AWS CloudFormationRecursos generados de.

Sintaxis

Para declarar esta entidad en su plantillaAWS Serverless Application Model (AWS SAM), use 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 u 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. SeApplicationLocationObject puede utilizar para especificar una aplicación que se haya publicado en AWS Serverless Application Repository.

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

Tipo: Cadena | ApplicationLocationObject

Obligatorio: sí

AWS CloudFormationcompatibilidad: esta propiedad es similar a laTemplateURL propiedad de unAWS::CloudFormation::Stack recurso. La CloudFormation versión no necesita unApplicationLocationObject para recuperar una aplicación desdeAWS Serverless Application Repository.

NotificationARNs

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

Tipo: Lista

Obligatorio: no

AWS CloudFormationcompatibilidad: esta propiedad se pasa directamente a laNotificationARNs propiedad de unAWS::CloudFormation::Stack recurso.

Parameters

Valores de parámetros de aplicación.

Tipo: Mapa

Obligatorio: no

AWS CloudFormationcompatibilidad: esta propiedad se pasa directamente a laParameters propiedad de unAWS::CloudFormation::Stack recurso.

Tags

Un mapa (cadena a cadena) que especifica las etiquetas que se van a añadir a esta aplicación. Las claves y los 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.

Tipo: Mapa

Obligatorio: no

AWS CloudFormationcompatibilidad: esta propiedad es similar a laTags propiedad de unAWS::CloudFormation::Stack recurso. La propiedad Tags de SAM consiste en pares clave:valor; en CloudFormation ella, se compone de una lista de objetos Tag. Cuando se cree la pila, SAM añadirá automáticamente unalambda:createdBy:SAM etiqueta a esta aplicación. Además, si esta aplicación proviene delAWS Serverless Application Repository, SAM también generará automáticamente las dos etiquetas adicionalesserverlessrepo:applicationId:ApplicationId yserverlessrepo:semanticVersion:SemanticVersion.

TimeoutInMinutes

El periodo 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 periodo 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.

Tipo: entero

Obligatorio: no

AWS CloudFormationcompatibilidad: esta propiedad se pasa directamente a laTimeoutInMinutes propiedad de unAWS::CloudFormation::Stack recurso.

Valores devueltos

Ref.

Cuando se proporciona el ID lógico de este recurso a la funciónRef intrínseca, devuelve el nombre delAWS::CloudFormation::Stack recurso subyacente.

Para obtener más información sobre el uso de laRef función, consulte Refla Guía delAWS CloudFormation usuario.

Aficionado::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 sobre el usoFn::GetAtt, consulte Fn::GetAttla Guía delAWS CloudFormation usuario.

Outputs.ApplicationOutputName

El valor de la salida de la pila con nombreApplicationOutputName.

Ejemplos

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