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à.
# Alias KMS \$1 Crea
Crea un alias per una chiave master del cliente (CMK) AWS Key Management Service (KMS).
**Classificazione completa:** Distribuzione \$1 Componenti dello stack avanzati \$1 Alias KMS \$1 Create
## Dettagli del tipo di modifica
****
| | |
| --- |--- |
| Cambia tipo ID | ct-2svg4k2fqi4ak |
| Versione corrente | 1.0 |
| Durata di esecuzione prevista | 60 minuti |
| Approvazione AWS | Richiesto |
| Approvazione del cliente | Campo non obbligatorio |
| Modalità di esecuzione | Automatizzata |
## Informazioni aggiuntive
### Crea un AWS KMS alias
#### Creazione di un alias con AWS KMS la console
Schermata di questo tipo di modifica nella console AMS:
![\[Form to create an alias for an AWS KMS customer master key, showing description and ID fields.\]](http://docs.aws.amazon.com/it_it/managedservices/latest/ctref/images/guiKmsAliasCreateCT.png)
Come funziona:
1. Vai alla pagina **Crea RFC**: nel riquadro di navigazione a sinistra della console AMS, fai clic **RFCs**per aprire la pagina di RFCs elenco, quindi fai clic su **Crea** RFC.
1. Scegli un tipo di modifica (CT) popolare nella visualizzazione predefinita **Sfoglia i tipi di modifica** o seleziona un CT nella visualizzazione **Scegli per categoria**.
+ **Naviga per tipo di modifica**: puoi fare clic su un CT popolare nell'area di **creazione rapida** per aprire immediatamente la pagina **Run RFC**. Nota che non puoi scegliere una versione CT precedente con creazione rapida.
Per ordinare CTs, utilizzate l'area **Tutti i tipi di modifica** nella vista a **scheda** o **tabella**. In entrambe le visualizzazioni, selezionate un CT, quindi fate clic su **Crea RFC** per aprire la pagina **Esegui RFC**. Se applicabile, accanto al **pulsante Crea **RFC viene visualizzata l'opzione Crea** con una versione precedente**.
+ **Scegli per categoria**: seleziona una categoria, sottocategoria, articolo e operazione e la casella dei dettagli CT si apre con l'opzione **Crea con una versione precedente, se applicabile**. Fai clic su **Crea RFC** per aprire la pagina **Esegui RFC**.
1. Nella pagina **Run RFC**, apri l'area del nome CT per visualizzare la casella dei dettagli CT. È richiesto un **oggetto** (questo campo viene compilato automaticamente se si sceglie il CT nella vista **Sfoglia i tipi di modifica**). Apri l'area **di configurazione aggiuntiva** per aggiungere informazioni sull'RFC.
Nell'area di **configurazione dell'esecuzione**, utilizza gli elenchi a discesa disponibili o inserisci i valori per i parametri richiesti. Per configurare i parametri di esecuzione opzionali, aprite l'area di **configurazione aggiuntiva**.
1. Al termine, fate clic su **Esegui**. Se non sono presenti errori, viene visualizzata la pagina **RFC creata correttamente** con i dettagli RFC inviati e l'output iniziale di **Run**.
1. Apri l'area dei **parametri di esecuzione** per visualizzare le configurazioni inviate. Aggiorna la pagina per aggiornare lo stato di esecuzione RFC. Facoltativamente, annulla la RFC o creane una copia con le opzioni nella parte superiore della pagina.
#### Creazione di un AWS KMS alias con la CLI
Come funziona:
1. Utilizzate Inline Create (emettete un `create-rfc` comando con tutti i parametri RFC e di esecuzione inclusi) o Template Create (create due file JSON, uno per i parametri RFC e uno per i parametri di esecuzione) ed emettete il `create-rfc` comando con i due file come input. Entrambi i metodi sono descritti qui.
1. Invia il `aws amscm submit-rfc --rfc-id ID` comando RFC: con l'ID RFC restituito.
Monitora il comando RFC:. `aws amscm get-rfc --rfc-id ID`
Per verificare la versione del tipo di modifica, usa questo comando:
```
aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID
```
**Nota**
È possibile utilizzare qualsiasi `CreateRfc` parametro con qualsiasi RFC, indipendentemente dal fatto che faccia parte o meno dello schema per il tipo di modifica. Ad esempio, per ricevere notifiche quando lo stato RFC cambia, aggiungi questa riga `--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"` alla parte dei parametri RFC della richiesta (non ai parametri di esecuzione). Per un elenco di tutti i CreateRfc parametri, consulta l'[AMS Change Management API](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html) Reference.
*CREAZIONE IN LINEA*:
Esegui il comando create RFC con i parametri di esecuzione forniti in linea (evita le virgolette quando fornisci i parametri di esecuzione in linea), quindi invia l'ID RFC restituito. Ad esempio, puoi sostituire il contenuto con qualcosa del genere:
```
aws amscm create-rfc --title create-kms-alias --change-type-id ct-2svg4k2fqi4ak --change-type-version 1.0 --execution-parameters '{"DocumentName": "AWSManagedServices-CreateKMSAlias", "Region": "us-east-1", "Parameters": {"TargetKeyId": ["12345678-90ab-cdef-1234-567890abcdef"], "AliasName": ["my-test-key"]}}'
```
*CREAZIONE DEL MODELLO*:
1. Esporta lo schema JSON dei parametri di esecuzione per questo tipo di modifica in un file; questo esempio lo chiama CreateKmsAliasParams .json:
```
aws amscm get-change-type-version --change-type-id "ct-2svg4k2fqi4ak" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateKmsAliasParams.json
```
1. Modifica e salva il file. CreateKmsAliasParams Ad esempio, puoi sostituire il contenuto con qualcosa del genere:
```
{
"DocumentName": "AWSManagedServices-CreateKMSAlias",
"Region": "us-east-1",
"Parameters": {
"TargetKeyId": ["12345678-90ab-cdef-1234-567890abcdef"]
"AliasName": ["my-test-key"]
}
}
```
1. Esporta il file JSON del modello RFC in un file; questo esempio lo CreateKmsAliasRfc chiama .json:
```
aws amscm create-rfc --generate-cli-skeleton > CreateKmsAliasRfc.json
```
1. Modifica e salva il file.json. CreateKmsAliasRfc Ad esempio, puoi sostituire il contenuto con qualcosa del genere:
```
{
"ChangeTypeVersion": "1.0",
"ChangeTypeId": "ct-2svg4k2fqi4ak",
"Title": "create-kms-alias"
}
```
1. Crea la RFC, specificando il file CreateKmsAlias Rfc e il file: CreateKmsAliasParams
```
aws amscm create-rfc --cli-input-json file://CreateKmsAliasRfc.json --execution-parameters file://CreateKmsAliasParams.json
```
Nella risposta ricevi l'ID della nuova RFC e puoi utilizzarlo per inviare e monitorare la RFC. Finché non la invii, la RFC rimane nello stato di modifica e non si avvia.
#### Suggerimenti
## Parametri di input di esecuzione
Per informazioni dettagliate sui parametri di input di esecuzione, vedere[Schema per il tipo di modifica ct-2svg4k2fqi4ak](schemas.md#ct-2svg4k2fqi4ak-schema-section).
## Esempio: parametri obbligatori
```
{
"DocumentName" : "AWSManagedServices-CreateKMSAlias",
"Region" : "us-east-1",
"Parameters" : {
"TargetKeyId" : [
"58c399bf-1662-4d55-8bbe-fb6d26bd72b9"
],
"AliasName" : [
"test-alias"
]
}
}
```
## Esempio: tutti i parametri
```
{
"DocumentName" : "AWSManagedServices-CreateKMSAlias",
"Region" : "us-east-1",
"Parameters" : {
"TargetKeyId" : [
"arn:aws:kms:us-east-1:123456789012:key/58c399bf-1662-4d55-8bbe-fb6d26bd72b9"
],
"AliasName" : [
"test-alias"
]
}
}
```