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

# Registrazione di un’estensione privata di terze parti nel tuo account
<a name="registry-register-private-extension"></a>

Questa sezione tratta i passaggi per registrare un’estensione privata di terze parti condivisa con te in modo che sia disponibile per l’uso nel tuo account.

**Nota**  
Prima di continuare, verifica di disporre delle [autorizzazioni IAM](registry-private.md#registry-register-permissions) necessarie per la registrazione di un’estensione privata.

**Registrazione di un’estensione privata condivisa con te (AWS CLI)**

1. Individua il bucket Amazon S3 che contiene il pacchetto del progetto per l’estensione privata che desideri registrare nell’account.

1. Utilizza il comando [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/register-type.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/register-type.html) per registrare l’estensione nell’account:

   Ad esempio, il comando seguente registra il tipo di risorsa `My::Resource::Example` nell’ Account AWS specificato:

   ```
   aws cloudformation register-type --type {{RESOURCE}} \
     --type-name {{My::Resource::Example}} \
     --schema-handler-package {{[s3 object path]}} --region {{us-west-2}}
   ```

   `RegisterType` è un’operazione asincrona e restituisce un token di registrazione che è possibile utilizzare per monitorare lo stato di avanzamento della richiesta di registrazione.

   ```
   {
       "RegistrationToken": "f5525280-104e-4d35-bef5-8f1fexample"
   }
   ```

   Se le tue chiamate AWS APIs di estensione fanno parte della sua funzionalità, devi creare un ruolo di esecuzione IAM che includa le autorizzazioni necessarie per chiamarle AWS APIs e fornire tale ruolo di esecuzione nel tuo account. È quindi possibile specificare questo ruolo di esecuzione utilizzando l'`--execution-role-arn`opzione. CloudFormation assume quindi quel ruolo di esecuzione per fornire al tipo di risorsa le credenziali appropriate.

   ```
   --execution-role-arn {{arn:aws:iam::123456789012:role/MyIAMRole}}
   ```

1. (Facoltativo) Utilizza il token di registrazione con il comando [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-type-registration.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-type-registration.html) per monitorare lo stato di avanzamento della richiesta di registrazione.

   Quando CloudFormation completa la richiesta di registrazione, imposta lo stato di avanzamento della richiesta su. `COMPLETE`

   Nell’esempio seguente viene utilizzato il token di registrazione restituito dal comando `describe-type-registration` sopra per restituire le informazioni sullo stato della registrazione.

   ```
   aws cloudformation describe-type-registration \
     --registration-token {{f5525280-104e-4d35-bef5-8f1fexample}} \
     --region {{us-west-2}}
   ```

   Questo comando restituisce il seguente output.

   ```
   {
       "ProgressStatus": "COMPLETE",
       "TypeArn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Resource-Example",
       "Description": "Deployment is currently in DEPLOY_STAGE of status COMPLETED; ",
       "TypeVersionArn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Resource-Example/00000001"
   }
   ```

**Importante**  
Se l’estensione che stai registrando è un Hook, il prossimo passaggio è necessario. È necessario specificare `ENABLED` per la proprietà `HookInvocationStatus`. Questa operazione abilita le proprietà dell’Hook definite nella sezione relativa allo schema dell’Hook `properties`. Per ulteriori informazioni, consulta [Hook configuration schema syntax reference](https://docs.aws.amazon.com/cloudformation-cli/latest/hooks-userguide/hook-configuration-schema.html) nella *Guida per l’utente sugli Hook di CloudFormation *.

**Specificazione dei dati di configurazione per un Hook (AWS CLI)**

1. Ottieni l’ARN per l’Hook e salvalo. Puoi ottenere l'ARN di un Hook usando o. Console di gestione AWS AWS CLI Per ulteriori informazioni, consulta [Visualizza le estensioni disponibili e attivate nel CloudFormation registro](registry-view.md). 

   ```
   export HOOK_TYPE_ARN="{{arn:aws:cloudformation:us-west-2:123456789012:type/hook/Organization-Service-Hook/}}"
   ```

1. Utilizza il comando [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-configuration.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-configuration.html) per specificare la configurazione del traffico. Il JSON trasmesso per `--configuration` deve essere convalidato a fronte dello schema della configurazione dell’Hook. Per attivare l’Hook, è necessario impostare la proprietà `HookInvocationStatus` su `ENABLED` nella sezione `HookConfiguration`.

   ```
   aws cloudformation set-type-configuration \
     --configuration {{"{"CloudFormationConfiguration":{"HookConfiguration":{"HookInvocationStatus": "ENABLED", "FailureMode": "FAIL", "Properties":{}}}}"}} \
     --type-arn ${{HOOK_TYPE_ARN}} --region {{us-west-2}}
   ```

   Per ulteriori informazioni, consulta [Riferimento alla sintassi dello schema di configurazione Hook](https://docs.aws.amazon.com/cloudformation-cli/latest/hooks-userguide/hook-configuration-schema.html) nella *Guida per l’utente sugli Hook di CloudFormation *.