AWS::Serverless::CapacityProvider - AWS Serverless Application Model
SintaxisPropiedadesvalores devueltosEjemplos

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::CapacityProvider

Crea un proveedor de capacidad para AWS Lambda funciones que permite ejecutar instancias gestionadas por Lambda en instancias de Amazon Elastic Compute Cloud propiedad del cliente. Este recurso forma parte de la función de instancias gestionadas por Lambda, que optimiza los costes de las cargas de trabajo de Lambda a gran escala mediante el uso de modelos de precios. EC2

El proveedor de capacidad administra el ciclo de vida de las EC2 instancias y proporciona la infraestructura necesaria para que las funciones de Lambda se ejecuten en los recursos informáticos propiedad del cliente, al tiempo que mantiene el modelo de programación sin servidor.

nota

Cuando las implementa AWS CloudFormation, AWS SAM transforma sus AWS SAM recursos en recursos. CloudFormation Para obtener más información, consulte Recursos de CloudFormation 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::CapacityProvider
Properties:
  CapacityProviderName: String
  VpcConfig: VpcConfig
  OperatorRole: String
  Tags: Map
  PropagateTags: Boolean
  InstanceRequirements: InstanceRequirements
  ScalingConfig: ScalingConfig
  KMSKeyArn: String

Propiedades

CapacityProviderName

El nombre del proveedor de capacidad. Este nombre debe ser único en tu AWS cuenta y región.

Tipo: cadena

Obligatorio: no

CloudFormation compatibilidad: esta propiedad es similar a la CapacityProviderName propiedad de un AWS::Lambda::CapacityProvider recurso.

VpcConfig

La configuración de VPC para el proveedor de capacidad. Especifica las subredes de VPC y los grupos de seguridad en los que se lanzarán EC2 las instancias de Amazon.

Tipo: VpcConfig

Obligatorio: sí

CloudFormation compatibilidad: esta propiedad se transfiere directamente a la VpcConfigpropiedad de un AWS::Lambda::CapacityProvider recurso.

OperatorRole

El ARN del rol de operador de Lambda con permisos para crear y administrar EC2 instancias de Amazon y recursos relacionados en la cuenta del cliente. Si no se proporciona, genera AWS SAM automáticamente un rol con los permisos necesarios.

Tipo: cadena

Obligatorio: no

CloudFormation compatibilidad: esta propiedad se transfiere directamente a la PermissionsConfigpropiedad de un AWS::Lambda::CapacityProvider recurso.

Tags

Un mapa de pares clave-valor para aplicarlo al proveedor de capacidad y sus recursos asociados.

Tipo: mapa

Obligatorio: no

CloudFormation compatibilidad: esta propiedad se transfiere directamente a la Tags propiedad de un AWS::Lambda::CapacityProvider recurso. La Tags propiedad se AWS SAM compone de pares clave-valor (mientras que en CloudFormation esta propiedad se compone de una lista de objetos Tag). Además, agrega AWS SAM automáticamente una lambda:createdBy:SAM etiqueta a esta función Lambda y a las funciones predeterminadas generadas para esta función.

PropagateTags

Indica si se deben pasar o no las etiquetas de la propiedad Tags a los recursos AWS::Serverless::CapacityProvider generados. TrueConfigúrelo para propagar las etiquetas en los recursos generados.

Tipo: Booleano

Obligatorio: no

CloudFormation compatibilidad: esta propiedad es exclusiva de AWS SAM y no tiene un CloudFormation equivalente.

InstanceRequirements

Especificaciones de los tipos de instancias informáticas que puede usar el proveedor de capacidad. Esto incluye los requisitos de arquitectura allowed o los tipos de excluded instancias.

Tipo: InstanceRequirements

Obligatorio: no

CloudFormation compatibilidad: AWS SAM asigna esta propiedad aInstanceRequirements.

ScalingConfig

La configuración de escalado del proveedor de capacidad. Define cómo el proveedor de capacidad escala las EC2 instancias de Amazon en función de la demanda.

Tipo: ScalingConfig

Obligatorio: no

CloudFormation compatibilidad: esta propiedad se transfiere directamente a la CapacityProviderScalingConfig propiedad de un AWS::Lambda::CapacityProvider recurso

KMSKeyArn

El ARN de la AWS KMS clave utilizada para cifrar los datos en reposo y en tránsito para el proveedor de capacidad.

Tipo: cadena

Obligatorio: no

CloudFormation compatibilidad: esta propiedad se transfiere directamente a la KmsKeyArn propiedad de un AWS::Lambda::Function recurso.

valores devueltos

Ref.

Cuando se proporciona el identificador lógico de este recurso a la función Ref intrínseca, devuelve el nombre del proveedor de capacidad.

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 .

Fn:: 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 .

Arn

El ARN del proveedor de capacidad.

Ejemplos

Proveedor de capacidad básica

En el siguiente ejemplo, se crea un proveedor de capacidad básico con una configuración de VPC.

MyCapacityProvider:
  Type: AWS::Serverless::CapacityProvider
  Properties:
    CapacityProviderName: my-capacity-provider
    VpcConfig:
      SubnetIds:
        - subnet-12345678
        - subnet-87654321
      SecurityGroupIds:
        - sg-12345678
    Tags:
      Environment: Production
      Team: ServerlessTeam

Proveedor de capacidad avanzado con escalado

En el siguiente ejemplo, se crea un proveedor de capacidad con requisitos de instancia personalizados y una configuración de escalado.

AdvancedCapacityProvider:
  Type: AWS::Serverless::CapacityProvider
  Properties:
    CapacityProviderName: advanced-capacity-provider
    VpcConfig:
      SubnetIds:
        - subnet-12345678
        - subnet-87654321
      SecurityGroupIds:
        - sg-12345678
    OperatorRole: arn:aws:iam::123456789012:role/MyCapacityProviderRole
    PropagateTags: true
    InstanceRequirements:
      Architectures:
        - x86_64
      ExcludedTypes:
        - t2.micro
    ScalingConfig:
      MaxInstanceCount: 10
      ManualScalingPolicies:
        AverageCPUUtilization: 70.0
    KMSKeyArn: arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012
    Tags:
      Environment: Production
      CostCenter: Engineering