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