AWS::Serverless::CapacityProvider - AWS Serverless Application Model
SintassiPropertiesValori restituitiEsempi

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWS::Serverless::CapacityProvider

Crea un provider di capacità per AWS Lambda funzioni che consente l'esecuzione di istanze gestite Lambda su istanze Amazon Elastic Compute Cloud di proprietà del cliente. Questa risorsa fa parte della funzionalità Lambda Managed Instances, che fornisce l'ottimizzazione dei costi per carichi di lavoro Lambda su larga scala utilizzando modelli di prezzo. EC2

Il provider di capacità gestisce il ciclo di vita delle EC2 istanze e fornisce l'infrastruttura necessaria per l'esecuzione delle funzioni Lambda su risorse di elaborazione di proprietà del cliente, mantenendo al contempo il modello di programmazione serverless.

Nota

Quando esegui la distribuzione in, trasforma le tue risorse in risorse. AWS CloudFormation AWS SAM AWS SAM CloudFormation Per ulteriori informazioni, consulta CloudFormation Risorse generate per AWS SAM.

Sintassi

Per dichiarare questa entità nel tuo modello AWS Serverless Application Model (AWS SAM), usa la seguente sintassi.

YAML

Type: AWS::Serverless::CapacityProvider
Properties:
  CapacityProviderName: String
  VpcConfig: VpcConfig
  OperatorRole: String
  Tags: Map
  PropagateTags: Boolean
  InstanceRequirements: InstanceRequirements
  ScalingConfig: ScalingConfig
  KMSKeyArn: String

Properties

CapacityProviderName

Nome del provider di capacità. Questo nome deve essere unico all'interno del tuo AWS account e della tua regione.

▬Tipo: stringa

Required: No

CloudFormation compatibilità: questa proprietà è simile alla CapacityProviderName proprietà di una AWS::Lambda::CapacityProvider risorsa.

VpcConfig

La configurazione VPC per il provider di capacità. Speciifica le sottoreti VPC e i gruppi di sicurezza in cui verranno lanciate le istanze EC2 Amazon.

Tipo: VpcConfig

Campo obbligatorio: sì

CloudFormation compatibilità: questa proprietà viene passata direttamente alla proprietà di una risorsa. VpcConfigAWS::Lambda::CapacityProvider

OperatorRole

L'ARN del ruolo operatore per Lambda con le autorizzazioni per creare e gestire EC2 istanze Amazon e risorse correlate nell'account cliente. Se non viene fornito, genera AWS SAM automaticamente un ruolo con le autorizzazioni necessarie.

▬Tipo: stringa

Required: No

CloudFormation compatibilità: questa proprietà viene passata direttamente alla PermissionsConfigproprietà di una AWS::Lambda::CapacityProvider risorsa.

Tags

Una mappa di coppie chiave-valore da applicare al provider di capacità e alle risorse associate.

Tipo: Mappa

Required: No

CloudFormation compatibilità: questa proprietà viene passata direttamente alla Tags proprietà di una AWS::Lambda::CapacityProvider risorsa. La Tags proprietà in AWS SAM è composta da coppie chiave-valore (mentre in CloudFormation questa proprietà è costituita da un elenco di oggetti Tag). Inoltre, aggiunge AWS SAM automaticamente un lambda:createdBy:SAM tag a questa funzione Lambda e ai ruoli predefiniti generati per questa funzione.

PropagateTags

Indica se passare o meno i tag dalla proprietà Tags alle risorse AWS::Serverless::CapacityProvider generate. Imposta questa opzione True per propagare i tag nelle risorse generate.

Tipo: Booleano

Required: No

CloudFormation compatibilità: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

InstanceRequirements

Specifiche per i tipi di istanze di calcolo che il provider di capacità può utilizzare. Ciò include i requisiti di architettura allowed e/o i tipi di excluded istanza.

Tipo: InstanceRequirements

Required: No

CloudFormation compatibilità: AWS SAM associa questa proprietà aInstanceRequirements.

ScalingConfig

La configurazione di scalabilità per il provider di capacità. Definisce in che modo il provider di capacità ridimensiona le EC2 istanze Amazon in base alla domanda.

Tipo: ScalingConfig

Required: No

CloudFormation compatibilità: questa proprietà viene passata direttamente alla CapacityProviderScalingConfig proprietà di una risorsa AWS::Lambda::CapacityProvider

KMSKeyArn

L'ARN della AWS KMS chiave utilizzata per crittografare i dati inattivi e in transito per il provider di capacità.

▬Tipo: stringa

Required: No

CloudFormation compatibilità: questa proprietà viene passata direttamente alla KmsKeyArn proprietà di una AWS::Lambda::Function risorsa.

Valori restituiti

Ref

Quando l'ID logico di questa risorsa viene fornito alla funzione Ref intrinseca, restituisce il nome del fornitore di capacità.

Per ulteriori informazioni sull'uso della Ref funzione, Refconsultate la Guida per l'AWS CloudFormation utente.

Fn:: GetAtt

Fn::GetAtt restituisce un valore per un attributo specificato di questo tipo. Di seguito sono riportati gli attributi disponibili e i valori restituiti di esempio.

Per ulteriori informazioni sull'utilizzoFn::GetAtt, consulta Fn::GetAttla Guida per l'AWS CloudFormation utente.

Arn

L'ARN del fornitore di capacità.

Esempi

Fornitore di capacità di base

L'esempio seguente crea un provider di capacità di base con configurazione 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

Provider di capacità avanzata con scalabilità

L'esempio seguente crea un provider di capacità con requisiti di istanza personalizzati e configurazione di scalabilità.

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