Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Eine Ressource als Dienstinstanz registrieren AWS Cloud Map
<a name="registering-instances"></a>

Sie können die Ressourcen Ihrer Anwendung als Instanzen in einem AWS Cloud Map Dienst registrieren. Nehmen wir beispielsweise an, Sie haben einen Dienst erstellt, der `users` für alle Anwendungsressourcen aufgerufen wird, die Benutzerdaten verwalten. Anschließend können Sie eine DynamoDB-Tabelle, die zum Speichern von Benutzerdaten verwendet wird, als Instanz in diesem Dienst registrieren.

**Anmerkung**  
Die folgenden Funktionen sind auf der AWS Cloud Map Konsole nicht verfügbar:  
Wenn Sie eine Service-Instance über die Konsole registrieren, können Sie keinen Aliaseintrag erstellen, der den Traffic an einen Elastic Load Balancing (ELB) -Load Balancer weiterleitet. Wenn Sie eine Instance registrieren, müssen Sie das Attribut `AWS_ALIAS_DNS_NAME` einschließen. Weitere Informationen finden Sie unter [RegisterInstance](https://docs.aws.amazon.com/cloud-map/latest/api/API_RegisterInstance.html) in der *AWS Cloud Map -API-Referenz*.
Wenn Sie eine Instance mit einem Service registrieren, der eine benutzerdefinierte Zustandsprüfung enthält, können Sie nicht den anfänglichen Status für die benutzerdefinierte Zustandsprüfung angeben. Standardmäßig lautet der anfängliche Status einer benutzerdefinierten Zustandsprüfung **Fehlerfrei**. Wenn Sie möchten, dass der anfängliche Status **Fehlerhaft** lautet, registrieren Sie die Instance programmgesteuert und schließen Sie das Attribut `AWS_INIT_HEALTH_STATUS` ein. Weitere Informationen finden Sie unter [RegisterInstance](https://docs.aws.amazon.com/cloud-map/latest/api/API_RegisterInstance.html) in der *AWS Cloud Map -API-Referenz*.

Gehen Sie folgendermaßen vor, um eine Instance in einem Service zu registrieren.

------
#### [ AWS-Managementkonsole ]

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die AWS Cloud Map Konsole unter [https://console.aws.amazon.com/cloudmap/](https://console.aws.amazon.com/cloudmap/).

1. Wählen Sie im Navigationsbereich **Namespaces** aus.

1. Wählen Sie auf der Seite **Namespaces** den Namespace aus, der den Service enthält, den Sie als Vorlage für die Registrierung einer Service-Instance verwenden möchten.

1. Wählen Sie auf der *namespace-name* Seite **Namespace:** den Dienst aus, den Sie verwenden möchten.

1. Wählen Sie auf der *service-name* Seite **Service:** die Option **Dienstinstanz registrieren** aus.

1. Wählen Sie auf der Seite **Dienstinstanz registrieren** einen **Instanztyp** aus. Abhängig von der Konfiguration der Namespace-Instance-Erkennung können Sie wählen, ob Sie eine IP-Adresse, eine Amazon EC2 EC2-Instance-ID oder andere identifizierende Informationen für eine Ressource angeben möchten, die keine IP-Adresse hat.
**Anmerkung**  
Sie können die **EC2-Instance** nur in HTTP-Namespaces auswählen.

1. Geben Sie für die **Service-Instance-ID** einen Bezeichner an, der der Dienstinstanz zugeordnet ist.
**Anmerkung**  
Wenn Sie eine bestehende Instanz aktualisieren möchten, geben Sie die ID an, die der Instanz zugeordnet ist, die Sie aktualisieren möchten. Verwenden Sie dann die nächsten Schritte, um Werte zu aktualisieren und die Instanz erneut zu registrieren.

1. Führen Sie je nach Wahl des **Instanztyps** die folgenden Schritte aus.
**Wichtig**  
Sie können das `AWS_` Präfix (ohne Berücksichtigung von Groß- und Kleinschreibung) nicht in einem Schlüssel verwenden, wenn Sie ein benutzerdefiniertes Attribut angeben.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/cloud-map/latest/dg/registering-instances.html)

1. Wählen Sie **Register service instance (Service-Instance registrieren)** aus.

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

  Wenn Sie eine `RegisterInstance` Anfrage einreichen:
  + Für jeden DNS-Eintrag, den Sie in dem von angegebenen Dienst definieren`ServiceId`, wird ein Eintrag in der Hosting-Zone erstellt oder aktualisiert, der dem entsprechenden Namespace zugeordnet ist.
  + Wenn der Dienst Folgendes umfasst`HealthCheckConfig`, wird eine Integritätsprüfung auf der Grundlage der Einstellungen in der Integritätsprüfungskonfiguration erstellt.
  + Alle Integritätsprüfungen sind jedem der neuen oder aktualisierten Datensätze zugeordnet.

  Registrieren Sie eine Dienstinstanz mit dem `[register-instance](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/register-instance.html)` Befehl (ersetzen Sie die *red* Werte durch Ihre eigenen).

  ```
  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. Falls Sie es noch nicht `Boto3` installiert haben, finden Sie `Boto3` [hier](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation) Anweisungen zur Installation, Konfiguration und Verwendung.

1. Importieren `Boto3` und `servicediscovery` als Service verwenden.

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

1. 

   Wenn Sie eine `RegisterInstance` Anfrage einreichen:
   + Für jeden DNS-Eintrag, den Sie in dem von angegebenen Dienst definieren`ServiceId`, wird ein Eintrag in der Hosting-Zone erstellt oder aktualisiert, der dem entsprechenden Namespace zugeordnet ist.
   + Wenn der Dienst Folgendes umfasst`HealthCheckConfig`, wird eine Integritätsprüfung auf der Grundlage der Einstellungen in der Integritätsprüfungskonfiguration erstellt.
   + Alle Integritätsprüfungen sind jedem der neuen oder aktualisierten Datensätze zugeordnet.

   Registrieren Sie eine Dienstinstanz mit `register_instance()` (ersetzen Sie die *red* Werte durch Ihre eigenen).

   ```
   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)
   ```

   Beispiel für eine Antwortausgabe

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

------