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
<a name="sam-resource-capacityprovider"></a>

 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 i modelli di prezzo di Amazon. EC2 

 Il provider di capacità gestisce il ciclo di vita delle EC2 istanze Amazon 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 su, trasforma le tue risorse in risorse. AWS CloudFormation AWS SAM AWS SAM CloudFormation Per ulteriori informazioni, consulta [CloudFormation Risorse generate per AWS SAM](sam-specification-generated-resources.md). 

## Sintassi
<a name="sam-resource-capacityprovider-syntax"></a>

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

### YAML
<a name="sam-resource-capacityprovider-syntax.yaml"></a>

```
Type: AWS::Serverless::CapacityProvider
Properties:
  [CapacityProviderName](#sam-capacityprovider-capacityprovidername): String
  [VpcConfig](#sam-capacityprovider-vpcconfig): VpcConfig
  [OperatorRole](#sam-capacityprovider-operatorrole): String
  [Tags](#sam-capacityprovider-tags): Map
  [PropagateTags](#sam-capacityprovider-propagatetags): Boolean
  [InstanceRequirements](#sam-capacityprovider-instancerequirements): InstanceRequirements
  [ScalingConfig](#sam-capacityprovider-scalingconfig): ScalingConfig
  [KmsKeyArn](#sam-capacityprovider-kmskeyarn): String
```

## Properties
<a name="sam-resource-capacityprovider-properties"></a>

 `CapacityProviderName`   <a name="sam-capacityprovider-capacityprovidername"></a>
Nome del provider di capacità. Questo nome deve essere unico all'interno del tuo AWS account e della tua regione.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[CapacityProviderName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-capacityprovidername)` proprietà di una `AWS::Lambda::CapacityProvider` risorsa. 

 `VpcConfig`   <a name="sam-capacityprovider-vpcconfig"></a>
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](sam-property-capacityprovider-vpcconfig.md)  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla proprietà di una risorsa. `[VpcConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-vpcconfig)` `AWS::Lambda::CapacityProvider` 

 `OperatorRole`   <a name="sam-capacityprovider-operatorrole"></a>
 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  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[CapacityProviderOperatorRoleArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-capacityproviderpermissionsconfig.html#cfn-lambda-capacityprovider-capacityproviderpermissionsconfig-capacityprovideroperatorrolearn)` proprietà `[PermissionsConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-permissionsconfig)` di una `AWS::Lambda::CapacityProvider` risorsa. 

 `Tags`   <a name="sam-capacityprovider-tags"></a>
Una mappa di coppie chiave-valore da applicare al provider di capacità e alle risorse associate.  
*Tipo: Mappa*  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Tags](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-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`   <a name="sam-capacityprovider-propagatetags"></a>
 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  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `InstanceRequirements`   <a name="sam-capacityprovider-instancerequirements"></a>
 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](sam-property-capacityprovider-instancerequirements.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[InstanceRequirements](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-instancerequirements)` proprietà di una `AWS::Lambda::CapacityProvider` risorsa. 

 `ScalingConfig`   <a name="sam-capacityprovider-scalingconfig"></a>
 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](sam-property-capacityprovider-scalingconfig.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[CapacityProviderScalingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-capacityproviderscalingconfig)` proprietà di una `AWS::Lambda::CapacityProvider` risorsa. 

 `KmsKeyArn`   <a name="sam-capacityprovider-kmskeyarn"></a>
L'ARN della AWS KMS chiave utilizzata per crittografare i dati inattivi e in transito per il provider di capacità.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[KmsKeyArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-kmskeyarn)` proprietà di una `AWS::Lambda::CapacityProvider` risorsa. 

## Valori restituiti
<a name="sam-resource-capacityprovider-return-values"></a>

### Ref
<a name="sam-resource-capacityprovider-return-values-ref"></a>

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, [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html)consultate la Guida per l'*AWS CloudFormation utente*. 

### Fn:: GetAtt
<a name="sam-resource-capacityprovider-return-values-fn--getatt"></a>

`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'utilizzo`Fn::GetAtt`, consulta [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html)la *Guida per l'AWS CloudFormation utente*. 

`Arn`  <a name="Arn-fn::getatt"></a>
L'ARN del fornitore di capacità.

## Esempi
<a name="sam-resource-capacityprovider-examples"></a>

### Fornitore di capacità di base
<a name="sam-resource-capacityprovider-examples-basic"></a>

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à
<a name="sam-resource-capacityprovider-examples-advanced"></a>

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
```

# VpcConfig
<a name="sam-property-capacityprovider-vpcconfig"></a>

Configura le impostazioni VPC per un provider di capacità, incluse le sottoreti e i gruppi di sicurezza in EC2 cui verranno avviate le istanze.

## Sintassi
<a name="sam-property-capacityprovider-vpcconfig-syntax"></a>

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

### YAML
<a name="sam-property-capacityprovider-vpcconfig-syntax.yaml"></a>

```
[SubnetIds](#sam-capacityprovider-vpcconfig-subnetids): List
[SecurityGroupIds](#sam-capacityprovider-vpcconfig-securitygroupids): List
```

## Properties
<a name="sam-property-capacityprovider-vpcconfig-properties"></a>

 `SubnetIds`   <a name="sam-capacityprovider-vpcconfig-subnetids"></a>
Un elenco di sottoreti IDs in cui verranno EC2 lanciate le istanze. È necessario specificare almeno una sottorete.  
Tipo: elenco  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[SubnetIds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-capacityprovidervpcconfig.html#cfn-lambda-capacityprovider-capacityprovidervpcconfig-subnetids)` proprietà `[VpcConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-vpcconfig) ` di una `AWS::Lambda::CapacityProvider` risorsa. 

 `SecurityGroupIds`   <a name="sam-capacityprovider-vpcconfig-securitygroupids"></a>
Un elenco di gruppi di sicurezza IDs da associare alle EC2 istanze. Se non specificato, verrà utilizzato il gruppo di sicurezza predefinito per il VPC.  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[SecurityGroupIds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-capacityprovidervpcconfig.html#cfn-lambda-capacityprovider-capacityprovidervpcconfig-securitygroupids)` proprietà della `[VpcConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-vpcconfig)` proprietà di una `AWS::Lambda::CapacityProvider` risorsa. 

## Esempi
<a name="sam-property-capacityprovider-vpcconfig-examples"></a>

### Configurazione VPC
<a name="sam-property-capacityprovider-vpcconfig-examples-basic"></a>

L'esempio seguente mostra una configurazione VPC con più sottoreti e gruppi di sicurezza.

```
VpcConfig:
  SubnetIds:
    - subnet-12345678
    - subnet-87654321
  SecurityGroupIds:
    - sg-12345678
    - sg-87654321
```

# InstanceRequirements
<a name="sam-property-capacityprovider-instancerequirements"></a>

Speciifica i requisiti per le EC2 istanze che verranno lanciate dal provider di capacità, incluse le architetture e i vincoli relativi al tipo di istanza.

## Sintassi
<a name="sam-property-capacityprovider-instancerequirements-syntax"></a>

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

### YAML
<a name="sam-property-capacityprovider-instancerequirements-syntax.yaml"></a>

```
[Architectures](#sam-capacityprovider-instancerequirements-architectures): List
[AllowedTypes](#sam-capacityprovider-instancerequirements-allowedtypes): List
[ExcludedTypes](#sam-capacityprovider-instancerequirements-excludedtypes): List
```

**Nota**  
È possibile scegliere di specificare una delle due opzioni `AllowedTypes` oppure `ExcludedTypes` quando si definiscono i requisiti di istanza per il provider di capacità, ma non entrambi.

## Properties
<a name="sam-property-capacityprovider-instancerequirements-properties"></a>

 `Architectures`   <a name="sam-capacityprovider-instancerequirements-architectures"></a>
Le architetture del set di istruzioni per le istanze del provider di capacità.  
*Valori validi*: `x86_64` o `arm64`  
Tipo: elenco  
*Obbligatorio:* no  
*Default*: `x86_64`  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Architectures](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-instancerequirements.html#cfn-lambda-capacityprovider-instancerequirements-architectures)` proprietà `[InstanceRequirements](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-instancerequirements)` di una risorsa. `AWS::Lambda::CapacityProvider` 

 `AllowedTypes`   <a name="sam-capacityprovider-instancerequirements-allowedtypes"></a>
Un elenco di tipi di EC2 istanza consentiti per l'istanza del provider di capacità.  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[AllowedInstanceTypes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-instancerequirements.html#cfn-lambda-capacityprovider-instancerequirements-allowedinstancetypes)` proprietà `[InstanceRequirements](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-instancerequirements)` di una `AWS::Lambda::CapacityProvider` risorsa. 

 `ExcludedTypes`   <a name="sam-capacityprovider-instancerequirements-excludedtypes"></a>
Un elenco di tipi di EC2 istanze da escludere dal fornitore di capacità.  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ExcludedInstanceTypes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-instancerequirements.html#cfn-lambda-capacityprovider-instancerequirements-excludedinstancetypes)` proprietà `[InstanceRequirements](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-instancerequirements)` di una `AWS::Lambda::CapacityProvider` risorsa. 

## Esempi
<a name="sam-property-capacityprovider-instancerequirements-examples"></a>

### Configurazione dei requisiti dell'istanza
<a name="sam-property-capacityprovider-instancerequirements-examples-basic"></a>

L'esempio seguente mostra i requisiti delle istanze con vincoli specifici di architettura e tipo di istanza.

```
InstanceRequirements:
  Architectures:
    - x86_64
  ExcludedTypes:
    - t2.micro
```

# ScalingConfig
<a name="sam-property-capacityprovider-scalingconfig"></a>

Configura il modo in cui il provider di capacità ridimensiona le EC2 istanze in base alla domanda, inclusi i limiti massimi di istanze e le politiche di scalabilità.

## Sintassi
<a name="sam-property-capacityprovider-scalingconfig-syntax"></a>

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

### YAML
<a name="sam-property-capacityprovider-scalingconfig-syntax.yaml"></a>

```
[MaxVCpuCount](#sam-capacityprovider-scalingconfig-maxvcpucount): Integer
[AverageCPUUtilization](#sam-capacityprovider-scalingconfig-averagecpuutilization): Double
```

## Properties
<a name="sam-property-capacityprovider-scalingconfig-properties"></a>

 `MaxVCpuCount`   <a name="sam-capacityprovider-scalingconfig-maxvcpucount"></a>
Il numero massimo di v CPUs che il provider di capacità può fornire su tutte le istanze di calcolo.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MaxVCpuCount](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-capacityproviderscalingconfig.html#cfn-lambda-capacityprovider-capacityproviderscalingconfig-maxvcpucount)` proprietà `[CapacityProviderScalingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-capacityproviderscalingconfig)` di una `AWS::Lambda::CapacityProvider` risorsa. 

 `AverageCPUUtilization`   <a name="sam-capacityprovider-scalingconfig-averagecpuutilization"></a>
La percentuale media di utilizzo della CPU prevista (0-100) per le decisioni di scalabilità. Quando l'utilizzo medio della CPU supera questa soglia, il provider di capacità scalerà le istanze Amazon EC2 . Quando specificato, AWS SAM costruisce `[CapacityProviderScalingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-capacityproviderscalingconfig)` una `AWS::Lambda::CapacityProvider` risorsa con set to e `[ScalingMode](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-capacityproviderscalingconfig.html#cfn-lambda-capacityprovider-capacityproviderscalingconfig-scalingmode)` set to`'Manual'`. `[ScalingPolicies](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-capacityproviderscalingconfig.html#cfn-lambda-capacityprovider-capacityproviderscalingconfig-scalingpolicies)` `[{PredefinedMetricType: 'LambdaCapacityProviderAverageCPUUtilization', TargetValue: <this value>}]`   
*Tipo:* numero a doppia precisione  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente. 

## Esempi
<a name="sam-property-capacityprovider-scalingconfig-examples"></a>

### Scaling configuration (Configurazione dimensionamento)
<a name="sam-property-capacityprovider-scalingconfig-examples-basic"></a>

L'esempio seguente mostra una configurazione di scalabilità con VCpu conteggio massimo e utilizzo medio della CPU.

```
ScalingConfig:
  MaxVCpuCount: 10
  AverageCPUUtilization: 70.0
```