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à.

# `cdk flags`
<a name="ref-cli-cmd-flags"></a>

Visualizza e modifica le configurazioni dei feature flag per la CLI CDK.

I flag di funzionalità controllano il comportamento della CLI CDK e possono essere utilizzati per abilitare o disabilitare funzionalità specifiche. Utilizzate il `cdk flags` comando per visualizzare le configurazioni correnti dei feature flag e modificarle secondo necessità.

**avvertimento**  
Il `cdk flags` comando è in fase di sviluppo per il AWS CDK. Le funzionalità correnti di questo comando sono considerate pronte per la produzione e sicure da usare. Tuttavia, l'ambito di questo comando e le relative funzionalità sono soggetti a modifiche. Pertanto, è necessario attivare il consenso fornendo la `unstable=flags` possibilità di utilizzare questo comando.

## Utilizzo
<a name="ref-cli-cmd-flags-usage"></a>

```
$ cdk flags <arguments> <options>
```

## Argomenti
<a name="ref-cli-cmd-flags-args"></a><a name="ref-cli-cmd-flags-args-flagname"></a>

 **NOME DELLA BANDIERA**   
Il nome del flag di funzionalità specifico che si desidera visualizzare o modificare.  
 *Tipo:* stringa  
 *Required*: No

## Opzioni
<a name="ref-cli-cmd-flags-options"></a>

Per un elenco di opzioni globali che funzionano con tutti i comandi CDK CLI, [vedete](ref-cli-cmd.md#ref-cli-cmd-options) Opzioni globali.<a name="ref-cli-cmd-flags-options-set"></a>

 `--set <BOOLEAN>`   
Modifica la configurazione di un flag di funzionalità.<a name="ref-cli-cmd-flags-options-all"></a>

 `--all <BOOLEAN>`   
Modifica o visualizza tutti i flag di funzionalità.<a name="ref-cli-cmd-flags-options-recommended"></a>

 `--recommended <BOOLEAN>`   
Cambia i flag negli stati consigliati.<a name="ref-cli-cmd-flags-options-default"></a>

 `--default <BOOLEAN>`   
Cambia le bandiere in stati predefiniti.<a name="ref-cli-cmd-flags-options-unconfigured"></a>

 `--unconfigured <BOOLEAN>`   
Modifica i flag delle funzionalità non configurati.<a name="ref-cli-cmd-flags-options-value"></a>

 `--value <STRING>`   
Il valore su cui impostare la configurazione dei feature flag.  
 *requireARG: true*<a name="ref-cli-cmd-flags-options-safe"></a>

 `--safe <BOOLEAN>`   
Abilita tutte le funzionalità che non influiscono sull'applicazione.<a name="ref-cli-cmd-flags-options-interactive"></a>

 `--interactive, -i <BOOLEAN>`   
Opzione interattiva per il comando flags.

## Esempi
<a name="ref-cli-cmd-flags-examples"></a>

### Visualizza le configurazioni dei flag delle funzionalità
<a name="ref-cli-cmd-flags-examples-1"></a>

Esegui `cdk flags` per visualizzare un rapporto sulle configurazioni dei tuoi feature flag che differiscono dai nostri stati consigliati. I flag non configurati sono etichettati con `<unset>` per indicare che al momento non hanno alcun valore. Le bandiere vengono visualizzate nel seguente ordine:
+ Bandiere impostate su un valore che non corrisponde al nostro valore consigliato
+ Bandiere che non hai configurato

```
$ cdk flags --unstable=flags
Feature Flag                           Recommended                       User
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         <unset>
```

Puoi anche correre `cdk flags --all` per visualizzare un report di tutti i flag di funzionalità nel seguente ordine:
+ Bandiere impostate su un valore che corrisponde al nostro valore consigliato
+ Bandiere impostate su un valore che non corrisponde al nostro valore consigliato
+ Bandiere che non hai configurato

```
$ cdk flags --unstable=flags --all
Feature Flag                              Recommended                     User
@aws-cdk/...                                true                         true
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         <unset>
```

### Modifica i valori dei flag delle funzionalità
<a name="ref-cli-cmd-flags-examples-2"></a>

Per modificare i flag delle funzionalità in modo interattivo, esegui `cdk flags --interactive` (o`cdk flags -i`) per visualizzare un elenco di opzioni di menu.

Per modificare ogni flag di funzionalità secondo il valore consigliato, esegui. `cdk flags --set --recommended --all` Questo comando mantiene la configurazione dei feature flag up-to-date con le ultime configurazioni dei feature flag di CDK. Tieni presente che l'esecuzione di questo comando può potenzialmente sovrascrivere i valori configurati esistenti.

```
$ cdk flags --unstable=flags --set --recommended --all
Feature Flag                              Recommended Value            User Value
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         <unset>
  Synthesizing...
    Resources
    [~] AWS::S3::Bucket MyBucket
    └─ [~] Properties
        └─ [~] Encryption
                ...
    Number of stacks with differences: 2
  Do you want to accept these changes? (y/n) y
  Resynthesizing...
```

Se vuoi preservare lo stato dei flag configurati esistenti, esegui. `cdk flags --set --recommended --unconfigured` Questa opzione modifica solo i flag delle funzionalità non configurate in base ai valori consigliati.

```
$ cdk flags --unstable=flags --set --recommended --unconfigured
Feature Flag                              Recommended Value            User Value
* @aws-cdk/...                              true                         <unset>
* @aws-cdk/...                              true                         <unset>
  Synthesizing...
    Resources
    [~] AWS::S3::Bucket MyBucket
    └─ [~] Properties
        └─ [~] Encryption
            ├─ [-] None
            └─ [+] ServerSideEncryptionConfiguration:
                    - ...
            ...
    Number of stacks with differences: 2
  Do you want to accept these changes? (y/n) y
  Resynthesizing...
```

Se vuoi assicurarti che i flag di funzionalità non configurati non interferiscano con l'applicazione, esegui il `cdk flags --set --default --unconfigured` comando per riportare i flag non configurati ai valori predefiniti. Ad esempio, se non è configurato, `@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021` viene visualizzata una notifica dopo l'esecuzione. `cdk synth` Tuttavia, se imposti il flag allo stato predefinito (false), verrà configurato, disattivato e non avrà alcun impatto sull'applicazione.

```
$ cdk flags --unstable=flags --set --default --unconfigured
Feature Flag                              Recommended Value            User Value
* @aws-cdk/...                              true                         <unset>
* @aws-cdk/...                              true                         <unset>
  Synthesizing...

  Do you want to accept these changes? (y/n) y
  Resynthesizing...
```

### Ispeziona le bandiere di funzionalità specifiche
<a name="ref-cli-cmd-flags-examples-3"></a>

#### Visualizza ulteriori informazioni su una bandiera
<a name="_view_more_information_about_a_flag"></a>

Oltre a eseguire `cdk flags` e `cdk flags --all` visualizzare la configurazione del flag di funzionalità, potete anche `cdk flags "FLAGNAME"` ispezionare un flag di funzionalità specifico e scoprire a cosa serve il flag. Questo può essere utile nei casi in cui desideri comprendere un particolare flag e il suo impatto sull'applicazione.

```
$ cdk flags --unstable=flags "@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021"
    Description: Enable this feature flag to have cloudfront distributions use the security policy TLSv1.2_2021 by default.
    Recommended Value: true
    User Value: true
```

#### Filtra i flag per sottostringa
<a name="_filter_flags_by_substring"></a>

Puoi anche eseguire l'operazione `cdk flags substring` per visualizzare tutti i flag di funzionalità corrispondenti. Se esiste un solo flag di funzionalità che corrisponde a quella sottostringa, vengono visualizzati dettagli specifici.

```
$ cdk flags --unstable=flags ebs
@aws-cdk/aws-ec2:ebsDefaultGp3Volume
    Description: When enabled, the default volume type of the EBS volume will be GP3
    Recommended Value: true
    User Value: true
```

Se più flag corrispondono alla sottostringa, tutti i flag corrispondenti vengono visualizzati in una tabella. Se si inseriscono più sottostringhe, vengono restituiti tutti i flag corrispondenti che contengono una qualsiasi delle sottostringhe.

```
$ cdk flags --unstable=flags s3 lambda
Feature Flag                              Recommended                     User
* @aws-cdk/s3...                            true                         false
* @aws-cdk/lambda...                        true                         false
* @aws-cdk/lambda...                        true                         <unset>
```

#### Modifica un flag specifico
<a name="_modify_a_specific_flag"></a>

Se devi modificare il valore di un flag e vuoi assicurarti di impostarlo su uno stato corretto e supportato, esegui`cdk flags --set "FLAGNAME" --value="state"`.

```
$ cdk flags --unstable=flags --set "@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021" --value="true"
  Synthesizing...
    Resources
    [~] AWS::CloudFront::Distribution MyDistribution
    └─ [~] Properties
        └─ [~] DefaultSecurityPolicy
            ├─ [-] TLSv1.0
            └─ [+] TLSv1.2_2021
                    - ...
    Number of stacks with differences: 2
  Do you want to accept these changes? (y/n) y
  Resynthesizing...
```