

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.

# Ressourcen für Tag-Verbindungen
<a name="connections-tag"></a>

Ein *Tag* ist eine benutzerdefinierte Attributbezeichnung, die Sie einer AWS Ressource AWS zuweisen oder zuweisen. Jedes AWS Tag besteht aus zwei Teilen:
+ einem *Tag-Schlüssel* (z. B. `CostCenter`, `Environment` oder `Project`). Bei Tag-Schlüsseln wird zwischen Groß- und Kleinschreibung unterschieden.
+ einem optionalen Feld, das als *Tag-Wert* bezeichnet wird (z. B. `111122223333`, `Production` oder ein Team-Name). Ein nicht angegebener Tag-Wert entspricht einer leeren Zeichenfolge. Wie bei Tag-Schlüsseln wird auch bei Tag-Werten zwischen Groß- und Kleinschreibung unterschieden.

Dies werden als *Schlüssel-Wert-Paare* bezeichnet.

Sie können Ressourcen über die Konsole oder CLI mit Tags markieren.

Sie können die folgenden Ressourcentypen in AWS taggen CodeConnections:
+ Verbindungen
+ Hosts

Bei diesen Schritten wird davon ausgegangen, dass Sie bereits eine aktuelle Version von installiert AWS CLI oder auf die aktuelle Version aktualisiert haben. Weitere Informationen finden Sie unter [Installieren der AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) im *AWS Command Line Interface -Benutzerhandbuch*.

Neben der Identifizierung, Organisation und Nachverfolgung Ihrer Ressource mithilfe von Tags können Sie mithilfe von Tags in AWS Identity and Access Management (IAM-) Richtlinien steuern, wer Ihre Ressource aufrufen und mit ihnen interagieren kann. Beispiele für Tag-basierte Zugriffsrichtlinien finden Sie unter [Verwendung von Tags zur Steuerung des Zugriffs auf Ressourcen AWS CodeConnections](connections-tag-based-access-control.md).

**Topics**
+ [Markieren von Ressourcen (Konsole)](#connections-tag-console)
+ [Markieren von Ressourcen mit Tags (CLI)](#connections-tag-cli)

## Markieren von Ressourcen (Konsole)
<a name="connections-tag-console"></a>

Sie können mit der Konsole Tags auf einer Verbindungsressource hinzufügen, ändern oder entfernen.

**Topics**
+ [Hinzufügen von Tags zu einer Verbindungsressource (Konsole)](#connections-tag-console-add)
+ [Anzeigen von Tags für eine Verbindungsressource (Konsole)](#connections-tag-console-view)
+ [Bearbeiten von Tags für eine Verbindungsressource (Konsole)](#connections-tag-console-edit)
+ [Entfernen von Tags aus einer Verbindungsressource (Konsole)](#connections-tag-console-remove)

### Hinzufügen von Tags zu einer Verbindungsressource (Konsole)
<a name="connections-tag-console-add"></a>

Sie können mit der Konsole Tags zu einer vorhandenen Verbindung/einem vorhandenen Host hinzufügen.

**Anmerkung**  
Wenn Sie eine Verbindung für einen installierten Anbieter wie GitHub Enterprise Server herstellen und auch eine Hostressource für Sie erstellt wird, werden die Tags bei der Erstellung nur der Verbindung hinzugefügt. Auf diese Weise können Sie einen Host separat markieren, wenn Sie ihn für eine neue Verbindung wiederverwenden möchten. Gehen Sie wie folgt vor, wenn Sie den Host mit Tags versehen möchten.

****Tags für eine Verbindung hinzufügen****

1. Melden Sie sich an der Konsole an. Wählen Sie im Navigationsbereich **Settings (Einstellungen)** aus.

1. Wählen Sie unter **Einstellungen (Settings)** die Option **Connections (Verbindungen)** aus. Wählen Sie die Registerkarte **Connections (Verbindungen)** aus.

1. Wählen Sie die Verbindung aus, die Sie bearbeiten möchten. Die Seite mit dem Verbindungseinstellungen wird angezeigt.

1. Wählen Sie unter **Connection tags (Verbindungs-Tags)**die Option **Edit (Bearbeiten)** aus. Die Seite **Edit Connection tags (Verbindungs-Tags bearbeiten)** erscheint.

1. Geben Sie in die Felder **Key (Schlüssel)** und **Value (Wert)** ein Schlüsselpaar für jeden hinzuzufügenden Tag-Satz ein. (Das Feld **Value (Wert)** ist optional.) Geben Sie beispielsweise für **Key (Schlüssel)** **Project** ein. Geben Sie unter **Value (Wert)** **ProjectA** ein.  
![\[Connection tags interface with fields for Key and Value, and buttons to Add tag and Remove tag.\]](http://docs.aws.amazon.com/de_de/dtconsole/latest/userguide/images/connections-tags.png)

1. (Optional) Wählen Sie **Add tag (Tag hinzufügen)** aus, um weitere Zeilen hinzuzufügen und weitere Tags einzugeben.

1. Wählen Sie **Submit (Absenden)** aus. Die Tags werden unter den Verbindungs-Einstellungen aufgeführt.

****Tags für einen Host hinzufügen****

1. Melden Sie sich an der Konsole an. Wählen Sie im Navigationsbereich **Settings (Einstellungen)** aus.

1. Wählen Sie unter **Einstellungen (Settings)** die Option **Connections (Verbindungen)** aus. Wählen Sie die Registerkarte **Hosts**.

1. Wählen Sie den Host aus, den Sie bearbeiten möchten. Die Seite mit den Hosteinstellungen erscheint.

1. Wählen Sie unter **Host tags (Host-Tags)**, die Option **Edit (Bearbeiten)** aus. Die Seite **Host tags (Host-Tags)** erscheint.

1. Geben Sie in die Felder **Key (Schlüssel)** und **Value (Wert)** ein Schlüsselpaar für jeden hinzuzufügenden Tag-Satz ein. (Das Feld **Value (Wert)** ist optional.) Geben Sie beispielsweise für **Key (Schlüssel)** **Project** ein. Geben Sie unter **Value (Wert)** **ProjectA** ein.  
![\[Edit Host tags interface with fields for Key and Value, and buttons to Add tag and Remove tag.\]](http://docs.aws.amazon.com/de_de/dtconsole/latest/userguide/images/hosts-tag.png)

1. (Optional) Wählen Sie **Add tag (Tag hinzufügen)** aus, um mehr Zeilen hinzuzufügen und weitere Host-Tags einzugeben.

1. Wählen Sie **Absenden** aus. Die Tags werden unter den Host-Einstellungen aufgeführt.

### Anzeigen von Tags für eine Verbindungsressource (Konsole)
<a name="connections-tag-console-view"></a>

Sie können mit der Konsole die Tags für vorhandene Ressourcen anzeigen.

**Tags für eine Verbindung anzeigen**

1. Melden Sie sich an der Konsole an. Wählen Sie im Navigationsbereich **Settings (Einstellungen)** aus.

1. Wählen Sie unter **Einstellungen (Settings)** die Option **Connections (Verbindungen)** aus. Wählen Sie die Registerkarte **Connections (Verbindungen)** aus.

1. Wählen Sie die Verbindung aus, die Sie anzeigen möchten. Die Seite mit dem Verbindungseinstellungen wird angezeigt.

1. Sehen Sie unter **Connection tags (Verbindungs-Tags)** die Tags für die Verbindung in den Spalten **Key (Schlüssel)** und **Value (Wert)** an.

**Tags für einen Host anzeigen**

1. Melden Sie sich an der Konsole an. Wählen Sie im Navigationsbereich **Settings (Einstellungen)** aus.

1. Wählen Sie unter **Einstellungen (Settings)** die Option **Connections (Verbindungen)** aus. Wählen Sie die Registerkarte **Hosts**.

1. Wählen Sie den Host aus, den Sie anzeigen möchten.

1. Sehen Sie unter **Host tags (Host-Tags)** die Tags für den Host in den Spalten **Key (Schlüssel)** und **Value (Wert)** an.

### Bearbeiten von Tags für eine Verbindungsressource (Konsole)
<a name="connections-tag-console-edit"></a>

Sie können über die Konsole Tags bearbeiten, die Verbindungsressourcen hinzugefügt wurden.

**Tags für eine Verbindung bearbeiten**

1. Melden Sie sich an der Konsole an. Wählen Sie im Navigationsbereich **Settings (Einstellungen)** aus.

1. Wählen Sie unter **Einstellungen (Settings)** die Option **Connections (Verbindungen)** aus. Wählen Sie die Registerkarte **Connections (Verbindungen)** aus.

1. Wählen Sie die Verbindung aus, die Sie bearbeiten möchten. Die Seite mit dem Verbindungseinstellungen wird angezeigt.

1. Wählen Sie unter **Connection tags (Verbindungs-Tags)**die Option **Edit (Bearbeiten)** aus. Die Seite mit den **Verbindungs-Tags** wird angezeigt.

1. Aktualisieren Sie in den Feldern **Key (Schlüssel)** und **Value (Wert)** die Werte nach Bedarf. Ändern Sie beispielsweise für den Schlüssel **Project** unter **Value (Wert)** die Angabe **ProjectA** in **ProjectB**.

1. Wählen Sie **Absenden** aus.

**Tags für einen Host bearbeiten**

1. Melden Sie sich an der Konsole an. Wählen Sie im Navigationsbereich **Settings (Einstellungen)** aus.

1. Wählen Sie unter **Einstellungen (Settings)** die Option **Connections (Verbindungen)** aus. Wählen Sie die Registerkarte **Hosts**.

1. Wählen Sie den Host aus, den Sie bearbeiten möchten. Die Seite mit den Hosteinstellungen erscheint.

1. Wählen Sie unter **Host tags (Host-Tags)**, die Option **Edit (Bearbeiten)** aus. Die Seite **Host tags (Host-Tags)** erscheint.

1. Aktualisieren Sie in den Feldern **Key (Schlüssel)** und **Value (Wert)** die Werte nach Bedarf. Ändern Sie beispielsweise für den Schlüssel **Project** unter **Value (Wert)** die Angabe **ProjectA** in **ProjectB**.

1. Wählen Sie **Absenden** aus.

### Entfernen von Tags aus einer Verbindungsressource (Konsole)
<a name="connections-tag-console-remove"></a>

Sie können mit der Konsole Tags aus Verbindungsressourcen entfernen. Wenn Sie Tags aus der zugehörigen Ressource entfernen, werden die Tags gelöscht.

**Tags für eine Verbindung entfernen**

1. Melden Sie sich an der Konsole an. Wählen Sie im Navigationsbereich **Settings (Einstellungen)** aus.

1. Wählen Sie unter **Einstellungen (Settings)** die Option **Connections (Verbindungen)** aus. Wählen Sie die Registerkarte **Connections (Verbindungen)** aus.

1. Wählen Sie die Verbindung aus, die Sie bearbeiten möchten. Die Seite mit dem Verbindungseinstellungen wird angezeigt.

1. Wählen Sie unter **Connection tags (Verbindungs-Tags)**die Option **Edit (Bearbeiten)** aus. Die Seite mit den **Verbindungs-Tags** wird angezeigt.

1. Wählen Sie neben dem Schlüssel und Wert für jedes zu löschende Tag **Remove tag (Tag entfernen)** aus.

1. Wählen Sie **Absenden** aus.

**Tags für einen Host entfernen**

1. Melden Sie sich an der Konsole an. Wählen Sie im Navigationsbereich **Settings (Einstellungen)** aus.

1. Wählen Sie unter **Einstellungen (Settings)** die Option **Connections (Verbindungen)** aus. Wählen Sie die Registerkarte **Hosts**.

1. Wählen Sie den Host aus, den Sie bearbeiten möchten. Die Seite mit den Hosteinstellungen erscheint.

1. Wählen Sie unter **Host tags (Host-Tags)**, die Option **Edit (Bearbeiten)** aus. Die Seite **Host tags (Host-Tags)** erscheint.

1. Wählen Sie neben dem Schlüssel und Wert für jedes zu löschende Tag **Remove tag (Tag entfernen)** aus.

1. Wählen Sie **Absenden** aus.

## Markieren von Ressourcen mit Tags (CLI)
<a name="connections-tag-cli"></a>

Sie können mit der CLI Tags auf einer Verbindungsressource hinzufügen, ändern oder entfernen.

**Topics**
+ [Hinzufügen von Tags zu einer Verbindungsressource (CLI)](#connections-tag-add)
+ [Anzeigen von Tags für eine Verbindungsressource (CLI)](#connections-tag-view)
+ [Bearbeiten von Tags für eine Verbindungsressource (CLI)](#connections-tag-edit)
+ [Entfernen von Tags aus einer Verbindungsressource (CLI)](#connections-tag-delete)

### Hinzufügen von Tags zu einer Verbindungsressource (CLI)
<a name="connections-tag-add"></a>

Sie können die verwenden AWS CLI , um Ressourcen in Verbindungen zu kennzeichnen.

Führen Sie am Terminal oder in der Befehlszeile den Befehl **tag-resource** aus und geben Sie dabei den Amazon-Ressourcennamen (ARN) der Ressource an, für die Sie Tags hinzufügen möchten, sowie den Schlüssel und Wert des hinzuzufügenden Tags. Sie können mehr als ein Tag hinzufügen. 

****Tags für eine Verbindung hinzufügen****

1. Rufen Sie den ARN für Ihre Ressource ab. Verwenden Sie den Befehl **list-connections** (zu finden in [Auflisten von Verbindungen](connections-list.md)), um den Verbindungs-ARN abzurufen.

1. Führen Sie in einem Terminal oder über die Befehlszeile den Befehl **tag-resource** aus. 

   Verwenden Sie beispielsweise den folgenden Befehl, um eine Verbindung mit zwei Tags zu kennzeichnen, einem Tag-Schlüssel *Project* mit dem Tag-Wert von *ProjectA* und einem Tag-Schlüssel *ReadOnly* mit dem Tag-Wert von*true*.

   ```
   aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true
   ```

   Bei erfolgreicher Ausführung gibt dieser Befehl nichts zurück.

****Tags für einen Host hinzufügen****

1. Rufen Sie den ARN für Ihre Ressource ab. Verwenden Sie den Befehl **list-hosts** (zu finden in [Auflisten von Hosts](connections-host-list.md)), um den Host-ARN abzurufen.

1. Führen Sie in einem Terminal oder über die Befehlszeile den Befehl **tag-resource** aus.

   Verwenden Sie beispielsweise den folgenden Befehl, um einen Host mit zwei Tags zu taggen, einem Tag-Schlüssel *Project* mit dem Tag-Wert von *ProjectA* und einem Tag-Schlüssel *IscontainerBased* mit dem Tag-Wert von*true*.

   ```
   aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605 --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true
   ```

   Bei erfolgreicher Ausführung gibt dieser Befehl nichts zurück.

### Anzeigen von Tags für eine Verbindungsressource (CLI)
<a name="connections-tag-view"></a>

Sie können den verwenden AWS CLI , um die AWS Tags für eine Verbindungsressource anzuzeigen. Wenn keine Tags hinzugefügt wurden, ist die zurückgegebene Liste leer. Verwenden Sie den Befehl **list-tags-for-resource**, um Tags anzuzeigen, die einer Verbindung oder einem Host hinzugefügt wurden.

****Tags für eine Verbindung anzeigen****

1. Rufen Sie den ARN für Ihre Ressource ab. Verwenden Sie den Befehl **list-connections** (zu finden in [Auflisten von Verbindungen](connections-list.md)), um den Verbindungs-ARN abzurufen.

1. Führen Sie in einem Terminal oder über die Befehlszeile den Befehl **list-tags-for-resource** aus. Verwenden Sie beispielsweise den folgenden Befehl, um eine Liste von Tag-Schlüsseln und Tag-Werten für eine Verbindung anzuzeigen.

   ```
   aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f
   ```

   Dieser Befehl gibt die Tags zurück, die der Ressource zugeordnet sind. In diesem Beispiel haben wir zwei Schlüssel-Wert-Paare, die für eine Verbindung zurückgegeben werden.

   ```
   {
       "Tags": [
           {
               "Key": "Project",
               "Value": "ProjectA"
           },
           {
               "Key": "ReadOnly",
               "Value": "true"
           }
       ]
   }
   ```

****Tags für einen Host anzeigen****

1. Rufen Sie den ARN für Ihre Ressource ab. Verwenden Sie den Befehl **list-hosts** (zu finden in [Auflisten von Hosts](connections-host-list.md)), um den Host-ARN abzurufen.

1. Führen Sie in einem Terminal oder über die Befehlszeile den Befehl **list-tags-for-resource** aus. Verwenden Sie beispielsweise den folgenden Befehl, um eine Liste von Tag-Schlüsseln und Tag-Werten für einen Host anzuzeigen.

   ```
   aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605
   ```

   Dieser Befehl gibt die Tags zurück, die der Ressource zugeordnet sind. In diesem Beispiel werden zwei Schlüssel-Wert-Paare angezeigt, die für eine Verbindung zurückgegeben wurden.

   ```
   {
       "Tags": [
           {
               "Key": "IscontainerBased",
               "Value": "true"
           },
           {
               "Key": "Project",
               "Value": "ProjectA"
           }
       ]
   }
   ```

### Bearbeiten von Tags für eine Verbindungsressource (CLI)
<a name="connections-tag-edit"></a>

Sie können den verwenden AWS CLI , um ein Tag für eine Ressource zu bearbeiten. Sie können den Wert für einen vorhandenen Schlüssel ändern oder einen anderen Schlüssel hinzufügen.

Führen Sie am Terminal oder über die Befehlszeile den Befehl **tag-resource** aus und geben Sie dabei den ARN der Ressource an, für die Sie ein Tag aktualisieren möchten, sowie den Tag-Schlüssel und Tag-Wert.

Wenn Sie Tags bearbeiten, werden alle nicht angegebenen Tag-Schlüssel beibehalten und alles mit demselben Schlüssel aber neuem Wert aktualisiert. Neue Schlüssel, die mit dem Befehl „edit“ hinzugefügt werden, werden als neues Schlüssel-Wert-Paar hinzugefügt.

****Tags für eine Verbindung bearbeiten****

1. Rufen Sie den ARN für Ihre Ressource ab. Verwenden Sie den Befehl **list-connections** (zu finden in [Auflisten von Verbindungen](connections-list.md)), um den Verbindungs-ARN abzurufen.

1. Führen Sie in einem Terminal oder über die Befehlszeile den Befehl **tag-resource** aus.

   In diesem Beispiel wird der Wert für den Schlüssel `Project` in `ProjectB` geändert.

   ```
   aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project,Value=ProjectB
   ```

   Bei erfolgreicher Ausführung gibt dieser Befehl nichts zurück. Um die der Verbindung zugeordneten Tags zu überprüfen, führen Sie den Befehl **list-tags-for-resource** aus.

****Tags für einen Host bearbeiten****

1. Rufen Sie den ARN für Ihre Ressource ab. Verwenden Sie den Befehl **list-hosts** (zu finden in [Auflisten von Hosts](connections-host-list.md)), um den Host-ARN abzurufen.

1. Führen Sie in einem Terminal oder über die Befehlszeile den Befehl **tag-resource** aus.

   In diesem Beispiel wird der Wert für den Schlüssel `Project` in `ProjectB` geändert.

   ```
   aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605 --tags Key=Project,Value=ProjectB
   ```

   Bei erfolgreicher Ausführung gibt dieser Befehl nichts zurück. Um die dem Host zugeordneten Tags zu überprüfen, führen Sie den Befehl **list-tags-for-resource** aus.

### Entfernen von Tags aus einer Verbindungsressource (CLI)
<a name="connections-tag-delete"></a>

Gehen Sie wie folgt vor, AWS CLI um mit dem ein Tag aus einer Ressource zu entfernen. Wenn Sie Tags aus der zugehörigen Ressource entfernen, werden die Tags gelöscht.

**Anmerkung**  
Wenn Sie eine Verbindungsressource löschen, werden alle Tag-Zuordnungen aus der gelöschten Ressource entfernt. Sie müssen keine Tags entfernen, bevor Sie eine Verbindungsressource löschen.

Führen Sie am Terminal oder über die Befehlszeile den Befehl **untag-resource** aus und geben Sie dabei den ARN der Ressource an, für die Sie Tags entfernen möchten, sowie den Tag-Schlüssel des zu entfernenden Tags. Verwenden Sie beispielsweise den folgenden Befehl, um mehrere Tags auf einer Verbindung mit den Tag-Schlüsseln *Project* und *ReadOnly* zu entfernen.

```
aws codestar-connections untag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tag-keys Project ReadOnly
```

Bei erfolgreicher Ausführung gibt dieser Befehl nichts zurück. Um die der Ressource zugeordneten Tags zu überprüfen, führen Sie den Befehl **list-tags-for-resource** aus. Die Ausgabe zeigt, dass alle Tags entfernt wurden.

```
{
    "Tags": []
}
```