Questa è la AWS CDK v2 Developer Guide. Il vecchio CDK v1 è entrato in manutenzione il 1° giugno 2022 e ha terminato il supporto il 1° giugno 2023.
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à.
# Usa le risorse del registro AWS CloudFormation pubblico
Il registro AWS CloudFormation pubblico ti consente di gestire le estensioni, sia pubbliche che private, come risorse, moduli e hook disponibili per l'uso nel tuo AWS account. Puoi utilizzare le estensioni delle risorse pubbliche nelle tue applicazioni AWS Cloud Development Kit (AWS CDK) con il [https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.CfnResource.html](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.CfnResource.html)costrutto.
Per ulteriori informazioni sul registro AWS CloudFormation pubblico, consulta [Uso del AWS CloudFormation registro nella Guida](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) per l'* AWS CloudFormation utente*.
Tutte le estensioni pubbliche pubblicate da AWS sono disponibili per tutti gli account in tutte le regioni senza alcuna azione da parte dell'utente. Tuttavia, devi attivare ogni estensione di terze parti che desideri utilizzare, in ogni account e regione in cui desideri utilizzarla.
**Nota**
Se utilizzi tipi AWS CloudFormation di risorse di terze parti, dovrai sostenere dei costi. I costi si basano sul numero di operazioni del gestore eseguite ogni mese e sulla durata delle operazioni del gestore. Consulta [CloudFormation i prezzi per i](https://aws.amazon.com/cloudformation/pricing/) dettagli completi.
Per ulteriori informazioni sulle estensioni pubbliche, consulta la sezione [Uso delle estensioni pubbliche CloudFormation nella](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-public.html) *Guida AWS CloudFormation per l'utente*
## Attiva una risorsa di terze parti nel tuo account e nella tua regione
Le estensioni pubblicate da AWS non richiedono l'attivazione. Sono sempre disponibili in ogni account e regione. È possibile attivare un'estensione di terze parti tramite la Console di AWS gestione, tramite l'interfaccia a riga di AWS comando o distribuendo una AWS CloudFormation risorsa speciale.
**Per attivare un'estensione di terze parti tramite la console di AWS gestione o vedere quali risorse sono disponibili**
1. Accedi all' AWS account in cui desideri utilizzare l'estensione, quindi passa alla regione in cui desideri utilizzarla.
1. Accedi alla CloudFormation console tramite il menu **Servizi**.
1. Scegli **Estensioni pubbliche** nella barra di navigazione, quindi attiva il pulsante di opzione **Terze parti** in **Publisher**. Viene visualizzato un elenco delle estensioni pubbliche di terze parti disponibili. (Puoi anche ** AWS **scegliere di visualizzare un elenco delle estensioni pubbliche pubblicate da AWS, anche se non è necessario attivarle).
1. Sfoglia l'elenco e trova l'estensione che desideri attivare. In alternativa, cercala, quindi attiva il pulsante di opzione nell'angolo in alto a destra della scheda dell'estensione.
1. Scegli il pulsante **Attiva** nella parte superiore dell'elenco per attivare l'estensione selezionata. Viene visualizzata la pagina **Attiva** dell'estensione.
1. Nella pagina **Activate**, è possibile sovrascrivere il nome predefinito dell'estensione e specificare un ruolo di esecuzione e una configurazione di registrazione. Puoi anche scegliere se aggiornare automaticamente l'estensione quando viene rilasciata una nuova versione. Dopo aver impostato queste opzioni come preferisci, scegli **Attiva estensione** nella parte inferiore della pagina.
**Per attivare un'estensione di terze parti utilizzando la AWS CLI**
+ Utilizza il comando `activate-type`. Sostituisci l'ARN del tipo personalizzato che desideri utilizzare dove indicato.
Di seguito è riportato un esempio:
```
aws cloudformation activate-type --public-type-arn --auto-update-activated
```
**Per attivare un'estensione di terze parti tramite CloudFormation il nostro CDK**
1. Implementate una risorsa di tipo ` AWS::CloudFormation::TypeActivation` e specificate le seguenti proprietà:
1. `TypeName`- Il nome del tipo, ad esempio`AWSQS::EKS::Cluster`.
1. `MajorVersion`- Il numero di versione principale dell'estensione desiderata. Omettilo se desideri la versione più recente.
1. `AutoUpdate`- Se aggiornare automaticamente questa estensione quando l'editore rilascia una nuova versione secondaria. (Gli aggiornamenti delle versioni principali richiedono una modifica esplicita della `MajorVersion` proprietà.)
1. `ExecutionRoleArn`- L'ARN del ruolo IAM in base al quale verrà eseguita questa estensione.
1. `LoggingConfig`- La configurazione di registrazione per l'estensione.
La `TypeActivation` risorsa può essere distribuita dal CDK utilizzando il costrutto. [https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.CfnResource.html](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.CfnResource.html) Questo è illustrato per le estensioni effettive nella sezione seguente.
## Aggiungi una risorsa dal registro AWS CloudFormation pubblico alla tua app CDK
Usa il [https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.CfnResource.html](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.CfnResource.html)costrutto per includere una risorsa del registro AWS CloudFormation pubblico nella tua applicazione. Questo costrutto si trova nel modulo del CDK. `aws-cdk-lib`
Ad esempio, supponete che esista una risorsa pubblica denominata `MY::S5::UltimateBucket` che desiderate utilizzare nell'applicazione CDK. AWS Questa risorsa ha una proprietà: il nome del bucket. L'`CfnResource`istanziazione corrispondente ha questo aspetto.
**Example**
```
const ubucket = new CfnResource(this, 'MyUltimateBucket', {
type: 'MY::S5::UltimateBucket::MODULE',
properties: {
BucketName: 'UltimateBucket'
}
});
```
```
const ubucket = new CfnResource(this, 'MyUltimateBucket', {
type: 'MY::S5::UltimateBucket::MODULE',
properties: {
BucketName: 'UltimateBucket'
}
});
```
```
ubucket = CfnResource(self, "MyUltimateBucket",
type="MY::S5::UltimateBucket::MODULE",
properties=dict(
BucketName="UltimateBucket"))
```
```
CfnResource.Builder.create(this, "MyUltimateBucket")
.type("MY::S5::UltimateBucket::MODULE")
.properties(java.util.Map.of( // Map.of requires Java 9+
"BucketName", "UltimateBucket"))
.build();
```
```
new CfnResource(this, "MyUltimateBucket", new CfnResourceProps
{
Type = "MY::S5::UltimateBucket::MODULE",
Properties = new Dictionary
{
["BucketName"] = "UltimateBucket"
}
});
```