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à.
# Cosa sono i tipi di modifica?
Il tipo di modifica si riferisce all'azione eseguita da una richiesta di modifica (RFC) di AWS Managed Services (AMS) e comprende l'azione di modifica stessa e il tipo di modifica: manuale o automatizzata. AMS dispone di un'ampia raccolta di tipi di modifiche non utilizzati da altri servizi web Amazon. Utilizzi questi tipi di modifica quando invii una richiesta di modifica (RFC) per distribuire, gestire o accedere a risorse.
**Topics**
+ [Automatizzato e manuale CTs](ug-automated-or-manual.md)
+ [Requisiti di approvazione CT](constrained-unconstrained-ctis.md)
+ [Cambia tipo di versioni](ct-versions.md)
+ [Creare tipi di modifica](ct-creates.md)
+ [Aggiorna i tipi di modifica](ct-updates.md)
+ [Tipi di modifiche solo interni](ct-internals.md)
+ [Cambia gli schemi dei tipi](ct-schemas.md)
+ [Gestione delle autorizzazioni per i tipi di modifica](ct-permissions.md)
+ [Oscurazione di informazioni sensibili dai tipi di modifiche](ct-redaction.md)
+ [Ricerca di un tipo di modifica, utilizzando l'opzione di interrogazione](ug-find-ct-ex-section.md)
# Automatizzato e manuale CTs
Un vincolo sui tipi di modifica è che siano automatici o manuali, questo è l'`AutomationStatusId`attributo change type, chiamato **modalità di esecuzione** nella console AMS.
I tipi di modifica automatizzata hanno i risultati e i tempi di esecuzione previsti e vengono eseguiti attraverso il sistema automatizzato AMS, in genere entro un'ora o meno (ciò dipende in gran parte dalle risorse che il CT fornisce). I tipi di modifica manuale sono rari, ma vengono trattati in modo diverso perché richiedono che un operatore AMS agisca sulla RFC prima che questa possa essere eseguita. A volte ciò significa comunicare con il mittente della RFC, pertanto i tipi di modifica manuale richiedono tempi diversi per essere completati.
Per tutti gli orari programmati RFCs, viene scritto che un'ora di fine non specificata corrisponde all'ora specificata `RequestedStartTime` più l'attributo del tipo di modifica inviato. `ExpectedExecutionDurationInMinutes` Ad esempio, se `ExpectedExecutionDurationInMinutes` è «60" (minuti) e il valore specificato `RequestedStartTime` è `2016-12-05T14:20:00Z` (5 dicembre 2016 alle 4:20), l'ora di fine effettiva sarà impostata sul 5 dicembre 2016 alle 5:20. Per trovare il tipo di modifica `ExpectedExecutionDurationInMinutes` per uno specifico, esegui questo comando:
```
aws amscm --profile saml get-change-type-version --change-type-id CHANGE_TYPE_ID --query "ChangeTypeVersion.{ExpectedDuration:ExpectedExecutionDurationInMinutes}"
```
**Nota**
Pianificato RFCs con **modalità di esecuzione** = Manuale, nella console, deve essere impostato per funzionare per almeno 24 ore nelle future settimane.
**Nota**
Quando si utilizza la CTs modalità manuale, AMS consiglia di utilizzare l'opzione ASAP **Scheduling** (scegliere **ASAP** nella console, lasciare vuote le date di inizio e fine nell'API/CLI) in quanto CTs richiedono che un operatore AMS esamini la RFC ed eventualmente comunichi con l'utente prima che possa essere approvata ed eseguita. Se li pianifichi RFCs, assicurati di attendere almeno 24 ore. Se l'approvazione non avviene prima dell'orario di inizio programmato, la RFC viene rifiutata automaticamente.
AMS intende rispondere a una TAC manuale entro quattro ore e risponderà il prima possibile, ma potrebbe essere necessario molto più tempo prima che la RFC venga effettivamente eseguita.
Per un elenco di quelli CTs che sono manuali e richiedono la revisione da parte di AMS, consulta il file CSV Change Type, disponibile nella pagina **Developer's Resources** della console.
**YouTube Video**: [Come posso trovare tipi di modifiche automatiche per AMS RFCs](https://www.youtube.com/watch?v=sOzDuCCOduI&list=PLhr1KZpdzukc_VXASRqOUSM5AJgtHat6-&index=2&t=1s)?
Per trovare la **modalità di esecuzione** per un CT nella console AMS, è necessario utilizzare l'opzione di ricerca **Sfoglia i tipi di modifica**. I risultati mostrano la modalità di esecuzione del tipo o dei tipi di modifica corrispondenti.
Per trovare un tipo di modifica specifico utilizzando la CLI AMS, esegui questo comando: `AutomationStatus`
```
aws amscm --profile saml get-change-type-version --change-type-id CHANGE_TYPE_ID --query "ChangeTypeVersion.{AutomationStatus:AutomationStatus.Name}"
```
Puoi anche cercare i tipi di modifica nell'[AMS Change Type Reference](https://docs.aws.amazon.com/managedservices/latest/ctref/index.html), che fornisce informazioni su tutti i tipi di modifica AMS.
**Nota**
API/CLI Gli AMS non fanno attualmente parte di AWSAPI/CLI. To access the AMS API/CLI, è possibile scaricare l'SDK AMS tramite la console AMS.
# Requisiti di approvazione CT
AMS prevede CTs sempre due condizioni di approvazione, **AwsApprovalId**CustomerApprovalId****che indicano se la RFC richiede ad AMS o all'utente o a chiunque altro di approvare l'esecuzione.
La condizione di approvazione è in qualche modo correlata alla modalità di esecuzione; per i dettagli, vedere. [Automatizzato e manuale CTs](ug-automated-or-manual.md)
Per scoprire le condizioni di approvazione per un CT, puoi consultare l'[AMS Change Type Reference](https://docs.aws.amazon.com/managedservices/latest/ctref/index.html) o eseguire [GetChangeTypeVersion](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_GetChangeTypeVersion.html). Entrambi ti offriranno anche la **modalità CT `AutomationStatusId` o Execution**.
Puoi approvare RFCs utilizzando la console AMS o con il seguente comando:
```
aws amscm approve-rfc --rfc-id RFC_ID
```
**Condizione di approvazione CT**
| Se la condizione di approvazione CT è | Richiede l'approvazione di | And |
| --- | --- | --- |
| `AwsApprovalId: Required` | Il sistema AMS cambia tipo, | Nessuna operazione richiesta. Questa condizione è tipica dell'automazione CTs. |
| `AwsApprovalId: NotRequiredIfSubmitter` | Il sistema AMS cambia tipo e nessun altro, se la RFC inviata riguarda l'account con cui è stata presentata, | Nessuna operazione richiesta. Questa condizione è tipica dei manuali, in CTs quanto verranno sempre esaminati dagli operatori AMS. |
| `CustomerApprovalId: NotRequired` | Il sistema AMS Change Type, | Se la RFC supera i controlli della sintassi e dei parametri, viene approvata automaticamente. |
| `CustomerApprovalId: Required` | Il sistema AMS cambia tipo e tu, | All'utente viene inviata una notifica ed è necessario approvare esplicitamente la RFC, rispondendo all'avviso o eseguendo l'operazione. [ApproveRfc](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_ApproveRfc.html) |
| `CustomerApprovalId: NotRequiredIfSubmitter` | Il sistema AMS cambia tipo e nessun altro, se hai inviato la RFC. | Se la RFC supera i controlli della sintassi e dei parametri, viene approvata automaticamente. |
| Incidente o patch di sicurezza urgente | AMS | È approvato e implementato automaticamente. |
# Cambia tipo di versioni
I tipi di modifica vengono versionati e la versione cambia quando viene apportato un aggiornamento importante al tipo di modifica.
Dopo aver selezionato un tipo di modifica utilizzando la console AMS, è possibile aprire l'area di **configurazione aggiuntiva** e selezionare una versione del tipo di modifica. È inoltre possibile specificare una versione del tipo di modifica nella API/CLI riga di comando. Potresti volerlo fare per vari motivi, tra cui:
+ Sai che la versione del tipo di modifica **Aggiorna** che desideri deve corrispondere alla versione del tipo **Crea** modifica che hai usato per creare la risorsa che ora desideri aggiornare. Ad esempio, potresti avere un'istanza Elastic Load Balancer (ELB) creata con ELB Create change type versione 1. Per aggiornarla, scegli ELB Update versione 1.
+ Desiderate utilizzare una versione del tipo di modifica con opzioni diverse rispetto al tipo di modifica più recente. Non lo consigliamo perché AMS aggiorna i tipi di modifica principalmente per motivi di sicurezza e ti consigliamo di scegliere sempre la versione più recente.
# Creare tipi di modifica
I tipi di modifica di creazione corrispondono ai tipi version-to-version di modifica di aggiornamento. In altre parole, la versione del tipo di modifica utilizzata per il provisioning di una risorsa deve corrispondere alla versione del tipo di modifica Update che verrà utilizzata in seguito per modificare tale risorsa. Ad esempio, se crei un bucket S3 con il tipo di modifica Create S3 Bucket versione 2.0 e successivamente desideri inviare una RFC per modificare quel bucket S3, devi utilizzare anche il tipo di modifica Update S3 Bucket versione 2.0, anche se esiste un tipo di modifica Update S3 Bucket con la versione 3.0.
Ti consigliamo di tenere traccia dell'ID del tipo di modifica e della versione che utilizzi quando fornisci a una risorsa il tipo Crea modifica nel caso in cui in seguito desideri utilizzare un tipo di modifica Aggiorna per modificarla.
# Aggiorna i tipi di modifica
AMS fornisce i tipi di modifica di aggiornamento per aggiornare le risorse create con Create change types. I tipi di modifica Update devono corrispondere version-to-version al tipo Create change originariamente utilizzato per fornire la risorsa.
Ti consigliamo di tenere traccia del tipo di modifica, dell'ID e della versione utilizzati per il provisioning di una risorsa per facilitarne l'aggiornamento.
**YouTube Video**: [Come posso utilizzare l'aggiornamento CTs per modificare le risorse in un account AWS Managed Services (AMS)?](https://www.youtube.com/watch?v=dqb31yaAXhc&list=PLhr1KZpdzukc_VXASRqOUSM5AJgtHat6-&index=8&t=30s)
# Tipi di modifiche solo interni
È possibile visualizzare i tipi di modifica solo per uso interno. In questo modo saprai quali azioni può o fa AMS. Se desideri rendere disponibile un tipo di modifica esclusivamente interno, invia una richiesta di assistenza.
Ad esempio, esiste una funzione Gestione \$1 Monitoraggio e notifica \$1 soppressione degli CloudWatch allarmi \$1 Update CT che è solo interna. AMS lo utilizza per implementare gli aggiornamenti dell'infrastruttura (come l'applicazione di patch) per disattivare le notifiche di allarme che gli aggiornamenti potrebbero attivare erroneamente. Una volta inviato questo CT, noterai la relativa RFC nell'elenco delle RFC. Qualsiasi CT esclusivamente interno implementato in una RFC viene visualizzato nell'elenco RFC.
# Cambia gli schemi dei tipi
Tutti i tipi di modifica forniscono uno schema JSON per l'input dell'utente nella creazione, modifica o accesso alle risorse. Lo schema fornisce i parametri e le relative descrizioni per la creazione di una richiesta di modifica (RFC).
L'esecuzione corretta di una RFC genera un output di esecuzione. Per il provisioning RFCs, l'output di esecuzione include un «stack\$1id» che rappresenta lo stack in CloudFormation e può essere cercato nella console. CloudFormation L'output di esecuzione a volte include l'output dell'ID dell'istanza creata e tale ID può essere utilizzato per cercare l'istanza nella console AWS corrispondente. Ad esempio, l'output di esecuzione Create ELB CT include uno «stack\$1id» ricercabile in CloudFormation e restituisce un valore key=ELB value= che è ricercabile nella console Amazon per Elastic Load Balancing. EC2
Esaminiamo uno schema CT. Questo è lo schema di CodeDeploy Application Create, uno schema abbastanza piccolo. Alcuni schemi hanno `Parameter` aree molto ampie.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/managedservices/latest/userguide/ct-schemas.html)
**Nota**
Questo schema consente fino a sette tag; tuttavia, EFS EC2, RDS e gli schemi di creazione multilivello consentono fino a 50 tag.
# Gestione delle autorizzazioni per i tipi di modifica
È possibile utilizzare una politica personalizzata per limitare i tipi di modifica (CTs) disponibili per diversi gruppi o utenti.
Per ulteriori informazioni su questa operazione, consulta la sezione [Impostazione delle autorizzazioni](https://docs.aws.amazon.com/managedservices/latest/userguide/setting-permissions.html) nella Guida per l'utente AMS.
# Oscurazione di informazioni sensibili dai tipi di modifiche
Gli schemi dei tipi di modifica AMS offrono un attributo di parametro, `"metadata":"ams:sensitive":"true"` che viene utilizzato per i parametri che potrebbero contenere informazioni riservate, come una password. Quando questo attributo è impostato, l'input fornito è oscurato. Tieni presente che non puoi impostare questo attributo del parametro; tuttavia, se stai lavorando con AMS per creare un tipo di modifica e desideri che un parametro venga oscurato all'input, puoi richiederlo.
# Ricerca di un tipo di modifica, utilizzando l'opzione di interrogazione
Questo esempio dimostra come utilizzare la console AMS per trovare il tipo di modifica appropriato per la RFC che si desidera inviare.
Puoi utilizzare la console o il API/CLI per trovare un ID del tipo di modifica (CT) o una versione. Esistono due metodi: la ricerca o la scelta della classificazione. Per entrambi i tipi di selezione, è possibile ordinare la ricerca scegliendo Usato **più di frequente, Usato** **più di recente** o **Alfabetico**.
**YouTube Video**: [Come posso creare una RFC utilizzando la CLI di AWS Managed Services e dove posso trovare lo schema CT](https://www.youtube.com/watch?v=IluDFwnJJFU&list=PLhr1KZpdzukc_VXASRqOUSM5AJgtHat6-&index=3&t=150s)?
Nella console AMS, nella **RFCs**pagina -> **Crea RFC:**
+ Con l'opzione **Sfoglia per tipo di modifica** selezionata (impostazione predefinita), puoi:
+ Utilizza l'area di **creazione rapida** per selezionare tra i più diffusi di AMS CTs. Fai clic su un'etichetta e si apre la pagina **Esegui RFC** con l'opzione **Oggetto** compilata automaticamente per te. Completa le opzioni rimanenti secondo necessità e fai clic su **Esegui** per inviare la RFC.
+ In alternativa, scorri verso il basso fino all'area **Tutti i tipi di modifica** e inizia a digitare un nome CT nella casella delle opzioni, non è necessario avere il nome esatto o completo del tipo di modifica. Puoi anche cercare un CT in base alla modifica dell'ID del tipo, alla classificazione o alla modalità di esecuzione (automatica o manuale) inserendo le parole pertinenti.
Con la visualizzazione **Carte** predefinita selezionata, le schede CT corrispondenti vengono visualizzate durante la digitazione, seleziona una scheda e fai clic su **Crea RFC**. Con la vista **Tabella** selezionata, scegli il CT pertinente e fai clic su **Crea RFC**. Entrambi i metodi aprono la pagina **Run RFC**.
+ In alternativa, e per esplorare le opzioni di modifica, fai clic su **Scegli per categoria nella** parte superiore della pagina per aprire una serie di caselle di opzioni a discesa.
+ **Scegli una **categoria**, una **sottocategoria**, un **articolo** e un'operazione.** Viene visualizzata la casella delle informazioni per quel tipo di modifica e nella parte inferiore della pagina viene visualizzato un pannello.
+ Quando sei pronto, premi **Invio** per visualizzare un elenco dei tipi di modifica corrispondenti.
+ Scegli un tipo di modifica dall'elenco. La casella delle informazioni per quel tipo di modifica viene visualizzata nella parte inferiore della pagina.
+ Dopo aver impostato il tipo di modifica corretto, scegli **Crea RFC**.
**Nota**
Affinché questi comandi funzionino, è necessario installare l'AMS CLI. Per installare l'API o la CLI AMS, vai alla pagina **Risorse per gli sviluppatori** della console AMS. Per il materiale di riferimento sull'API AMS CM o sull'API AMS SKMS, consulta la sezione AMS Information Resources nella Guida per l'utente. Potrebbe essere necessario aggiungere un'`--profile`opzione per l'autenticazione, `aws amsskms ams-cli-command --profile SAML` ad esempio. Potrebbe essere necessario aggiungere l'`--region`opzione anche perché tutti i comandi AMS non utilizzano us-east-1, ad esempio. `aws amscm ams-cli-command --region=us-east-1`
**Nota**
Gli endpoint AMS API/CLI (amscm e amsskms) si trovano nella regione AWS della Virginia settentrionale,. `us-east-1` A seconda di come è impostata l'autenticazione e della regione AWS in cui si trovano l'account e le risorse, potrebbe essere necessario aggiungerli `--region us-east-1` quando si emettono i comandi. Potrebbe anche essere necessario aggiungere`--profile saml`, se questo è il metodo di autenticazione utilizzato.
Per cercare un tipo di modifica utilizzando l'API AMS CM (vedi [ListChangeTypeClassificationSummaries](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_ListChangeTypeClassificationSummaries.html)) o la CLI:
Puoi utilizzare un filtro o una query per effettuare la ricerca. L' ListChangeTypeClassificationSummaries operazione dispone delle opzioni di [filtro](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_ListChangeTypeClassificationSummaries.html#amscm-ListChangeTypeClassificationSummaries-request-Filters) per `Category``Subcategory`,`Item`, e`Operation`, ma i valori devono corrispondere esattamente ai valori esistenti. Per risultati più flessibili quando si utilizza la CLI, è possibile utilizzare l'`--query`opzione.
**Filtraggio dei cambi di tipo con l'API/CLI AMS CM**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/managedservices/latest/userguide/ug-find-ct-ex-section.html)
1. Ecco alcuni esempi di classificazione dei tipi di modifica delle inserzioni:
Il comando seguente elenca tutte le categorie dei tipi di modifica.
```
aws amscm list-change-type-categories
```
Il comando seguente elenca le sottocategorie appartenenti a una categoria specificata.
```
aws amscm list-change-type-subcategories --category CATEGORY
```
Il comando seguente elenca gli elementi appartenenti a una categoria e sottocategoria specificate.
```
aws amscm list-change-type-items --category CATEGORY --subcategory SUBCATEGORY
```
1. Ecco alcuni esempi di ricerca dei tipi di modifica con le query CLI:
Il comando seguente cerca nei riepiloghi delle classificazioni CT quelli che contengono «S3" nel nome dell'elemento e crea l'output della categoria, della sottocategoria, dell'elemento, dell'operazione e dell'ID del tipo di modifica sotto forma di tabella.
```
aws amscm list-change-type-classification-summaries --query "ChangeTypeClassificationSummaries [?contains(Item, 'S3')].[Category,Subcategory,Item,Operation,ChangeTypeId]" --output table
```
```
+---------------------------------------------------------------+
| ListChangeTypeClassificationSummaries |
+----------+-------------------------+--+------+----------------+
|Deployment|Advanced Stack Components|S3|Create|ct-1a68ck03fn98r|
+----------+-------------------------+--+------+----------------+
```
1. È quindi possibile utilizzare l'ID del tipo di modifica per ottenere lo schema CT ed esaminare i parametri. Il comando seguente genera lo schema in un file JSON denominato Creates3Params.schema.json.
```
aws amscm get-change-type-version --change-type-id "ct-1a68ck03fn98r" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateS3Params.schema.json
```
[Per informazioni sull'utilizzo delle query CLI, vedere [Come filtrare l'output con l'opzione --query e il](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html#controlling-output-filter) riferimento al linguaggio di interrogazione, Specificazione. JMESPath ](http://jmespath.org/specification.html)
1. Dopo aver ottenuto l'ID del tipo di modifica, ti consigliamo di verificare la versione del tipo di modifica per assicurarti che sia la versione più recente. Usa questo comando per trovare la versione per un tipo di modifica specificato:
```
aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CHANGE_TYPE_ID
```
Per trovare la versione `AutomationStatus` per un tipo di modifica specifico, esegui questo comando:
```
aws amscm --profile saml get-change-type-version --change-type-id CHANGE_TYPE_ID --query "ChangeTypeVersion.{AutomationStatus:AutomationStatus.Name}"
```
Per trovare il tipo di modifica `ExpectedExecutionDurationInMinutes` per un tipo di modifica specifico, esegui questo comando:
```
aws amscm --profile saml get-change-type-version --change-type-id ct-14027q0sjyt1h --query "ChangeTypeVersion.{ExpectedDuration:ExpectedExecutionDurationInMinutes}"
```