

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

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.


<table>
<thead>
  <tr><th>Tipo di istanza</th><th>Fasi</th><th></th></tr>
</thead>
<tbody>
  <tr><td>IP address (Indirizzo IP)</td><td> <ol><li> In <b>Attributi standard</b>, per <b>IPv4indirizzo</b>, fornisci un IPv4 indirizzo, se disponibile, a cui l'applicazione può accedere alla risorsa associata a questa istanza di servizio. </li><li> Per <b>IPv6 l'indirizzo</b>, fornisci un indirizzo IPv6 IP, se disponibile, a cui le applicazioni possono accedere alla risorsa associata a questa istanza di servizio. </li><li>  Per <b>Porta</b>, specifica qualsiasi porta che l'applicazione deve includere per accedere alla risorsa associata a questa istanza di servizio. La <b>porta</b> è necessaria quando il servizio include un record SRV o un controllo dello stato di Amazon Route 53. </li><li> (Facoltativo) In <b>Attributi personalizzati</b>, specifica le coppie chiave-valore che desideri associare alla risorsa. <br /> </li></ol> </td><td></td></tr>
  <tr><td>Istanza EC2</td><td> <ol><li> Per l'<b>ID dell'istanza EC2</b>, seleziona l'ID dell'istanza Amazon EC2 che desideri registrare come istanza AWS Cloud Map di servizio. </li><li> (Facoltativo) In <b>Attributi personalizzati</b>, specifica le coppie chiave-valore che desideri associare alla risorsa. </li></ol> </td><td></td></tr>
  <tr><td>Informazioni di identificazione per un'altra risorsa</td><td> <ol><li> <b>In <b>Attributi standard</b>, se la configurazione del servizio include un record DNS <b>CNAME</b>, vedrai un campo CNAME.</b> Per <b>CNAME, specifica il nome</b> di dominio che desideri che Route 53 restituisca in risposta alle query DNS (ad esempio,). <code>example.com</code> </li><li> In <b>Attributi personalizzati</b>, specifica qualsiasi informazione identificativa per una risorsa che non sia un indirizzo IP o un ID di istanza Amazon EC2 come coppia chiave-valore. Ad esempio, è possibile registrare una funzione Lambda specificando una chiave chiamata <code>function</code> e fornendo il nome della funzione Lambda come valore. È inoltre possibile specificare una chiave chiamata <code>name</code> e fornire un nome da utilizzare per il rilevamento programmatico delle istanze. </li></ol> </td><td></td></tr>
</tbody>
</table>


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': {
           '...': '...',
       },
   }
   ```

------