View a markdown version of this page

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 fornitore di capacità per AWS Lambda le 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 i modelli di prezzo di Amazon EC2.

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

Nota

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

Sintassi

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

Properties

CapacityProviderName

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

▬Tipo: stringa

Obbligatorio: no

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

VpcConfig

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

Tipo: VpcConfig

Obbligatorio: sì

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

OperatorRole

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

▬Tipo: stringa

Obbligatorio: no

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

Tags

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

Tipo: Mappa

Obbligatorio: no

CloudFormation compatibilità: questa proprietà viene passata direttamente alla Tags proprietà di una AWS::Lambda::CapacityProvider risorsa. La Tags proprietà in AWS SAM è costituita 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. Impostalo su True per propagare i tag nelle risorse generate.

Tipo: Booleano

Obbligatorio: 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 fornitore di capacità può utilizzare. Ciò include i requisiti di architettura allowed e/o i tipi di excluded istanza.

Tipo: InstanceRequirements

Obbligatorio: no

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

ScalingConfig

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

Tipo: ScalingConfig

Obbligatorio: no

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

LoggingConfig

Utilizzato LoggingConfig per configurare la registrazione del sistema per il fornitore di capacità. I log di sistema acquisiscono le attività di scalabilità e gli eventi operativi e li inviano a un gruppo di CloudWatch log di Amazon a un livello di registro configurabile.

Tipo: CapacityProviderLoggingConfig

Obbligatorio: no

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

KmsKeyArn

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

▬Tipo: stringa

Obbligatorio: no

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

ManagedResourceTags

Applica tag espliciti alle istanze Amazon Elastic Compute Cloud e ad altre risorse gestite che il fornitore di capacità fornisce per tuo conto.

Tipo: ManagedResourceTags

Obbligatorio: no

CloudFormation compatibilità: AWS SAM utilizza questa proprietà per costruire la PropagateTags proprietà di una risorsa. AWS::Lambda::CapacityProvider

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, consultare Ref 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'usoFn::GetAtt, consultare Fn::GetAtt la Guida per l'AWS CloudFormation utente.

Arn

L'ARN del fornitore di capacità.

Esempi

Fornitore di capacità di base

L'esempio seguente crea un fornitore 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à avanzato con scalabilità

L'esempio seguente crea un fornitore 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
    LoggingConfig:
      LogGroup: /aws/lambda/capacity-provider/advanced-capacity-provider
      SystemLogLevel: INFO
    ManagedResourceTags:
      Tags:
        CostCenter: cc-1234
        Environment: Production
    Tags:
      Environment: Production
      CostCenter: Engineering