

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 una risorsa come istanza di servizio AWS Cloud Map
<a name="registering-instances"></a>

Puoi registrare le risorse dell'applicazione come istanze in un servizio. AWS Cloud Map Ad esempio, supponiamo di aver creato un servizio chiamato `users` per tutte le risorse dell'applicazione che gestiscono i dati degli utenti. È quindi possibile registrare una tabella DynamoDB utilizzata per archiviare i dati utente come istanza in questo servizio.

**Nota**  
Le seguenti funzionalità non sono disponibili sulla AWS Cloud Map console:  
Quando registri un'istanza di servizio utilizzando la console, non puoi creare un record di alias che indirizza il traffico verso un sistema di bilanciamento del carico Elastic Load Balancing (ELB). Quando si registra un'istanza, è necessario includere l'attributo `AWS_ALIAS_DNS_NAME`. Per ulteriori informazioni, consulta [RegisterInstance](https://docs.aws.amazon.com/cloud-map/latest/api/API_RegisterInstance.html) nella *documentazione di riferimento dell’API AWS Cloud Map *.
Se si registra un'istanza che utilizza un servizio che include un controllo dello stato personalizzato, non è possibile specificare lo stato iniziale del controllo di stato personalizzato. Per impostazione predefinita, lo stato iniziale per i controlli di stato personalizzati è **Healthy (Integro)**. Se si desidera impostare lo stato iniziale su **Unhealthy (Non integro)**, registrare l'istanza in modo programamtico e includere lattributo `AWS_INIT_HEALTH_STATUS`. Per ulteriori informazioni, consulta [RegisterInstance](https://docs.aws.amazon.com/cloud-map/latest/api/API_RegisterInstance.html) nella *documentazione di riferimento dell’API AWS Cloud Map *.

Per registrare un'istanza in un servizio, segui questi passaggi.

------
#### [ Console di gestione AWS ]

1. Accedi a Console di gestione AWS e apri la AWS Cloud Map console all'indirizzo [https://console.aws.amazon.com/cloudmap/](https://console.aws.amazon.com/cloudmap/).

1. Nel riquadro di navigazione, selezionare **Namespaces**.

1. Nella pagina **Namespaces (Spazi dei nomi)**, scegliere lo spazio dei nomi che contiene il servizio che si desidera utilizzare come modello per registrare l'istanza di un servizio.

1. Nella *namespace-name* pagina **Namespace:**, scegli il servizio che desideri utilizzare.

1. Nella *service-name* pagina **Servizio:**, scegli **Registra istanza del servizio**.

1. Nella pagina **Registra istanza del servizio**, scegli un **tipo di istanza**. A seconda della configurazione del namespace Instance Discovery, puoi scegliere di specificare un indirizzo IP, un ID di istanza Amazon EC2 o altre informazioni identificative per una risorsa che non dispone di un indirizzo IP.
**Nota**  
Puoi scegliere un'**istanza EC2** solo nei namespace HTTP.

1. Per **Service Instance ID**, fornisci un identificatore associato all'istanza del servizio.
**Nota**  
Se desideri aggiornare un'istanza esistente, fornisci l'identificatore associato all'istanza che desideri aggiornare. Quindi, utilizza i passaggi successivi per aggiornare i valori e registrare nuovamente l'istanza.

1. In base al **tipo di istanza** scelto, esegui i seguenti passaggi.
**Importante**  
Non è possibile utilizzare il `AWS_` prefisso (senza distinzione tra maiuscole e minuscole) in una chiave quando si specifica un attributo personalizzato.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/cloud-map/latest/dg/registering-instances.html)

1. Selezionare **Register service instance (Registra istanza del servizio)**.

------
#### [ AWS CLI ]
+ 

  Quando invii una `RegisterInstance` richiesta:
  + Per ogni record DNS definito nel servizio specificato da`ServiceId`, viene creato o aggiornato un record nella zona ospitata associata allo spazio dei nomi corrispondente.
  + Se il servizio include`HealthCheckConfig`, viene creato un controllo dello stato di salute in base alle impostazioni nella configurazione del controllo dello stato.
  + Tutti i controlli sanitari sono associati a ciascuno dei record nuovi o aggiornati.

  Registra un'istanza di servizio con il `[register-instance](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/register-instance.html)` comando (sostituisci i *red* valori con i tuoi).

  ```
  aws servicediscovery register-instance \
      --service-id srv-xxxxxxxxx \
      --instance-id myservice-xx \
      --attributes=AWS_INSTANCE_IPV4=172.2.1.3,AWS_INSTANCE_PORT=808
  ```

------
#### [ AWS SDK for Python (Boto3) ]

1. Se non l'hai ancora `Boto3` installata, puoi trovare le istruzioni per l'installazione, la configurazione e l'utilizzo `Boto3` [qui](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation).

1. Importa `Boto3` e usa `servicediscovery` come servizio.

   ```
   import boto3
   client = boto3.client('servicediscovery')
   ```

1. 

   Quando invii una `RegisterInstance` richiesta:
   + Per ogni record DNS definito nel servizio specificato da`ServiceId`, viene creato o aggiornato un record nella zona ospitata associata allo spazio dei nomi corrispondente.
   + Se il servizio include`HealthCheckConfig`, viene creato un controllo dello stato di salute in base alle impostazioni nella configurazione del controllo dello stato.
   + Tutti i controlli sanitari sono associati a ciascuno dei record nuovi o aggiornati.

   Registra un'istanza di servizio con `register_instance()` (sostituisci i *red* valori con i tuoi).

   ```
   response = client.register_instance(
       Attributes={
           'AWS_INSTANCE_IPV4': '172.2.1.3',
           'AWS_INSTANCE_PORT': '808',
       },
       InstanceId='myservice-xx',
       ServiceId='srv-xxxxxxxxx',
   )
   # If you want to see the response
   print(response)
   ```

   Esempio di output di risposta

   ```
   {
       'OperationId': '4yejorelbukcjzpnr6tlmrghsjwpngf4-k95yg2u7',
       'ResponseMetadata': {
           '...': '...',
       },
   }
   ```

------