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.
# Tags für eine API-Stufe in API Gateway einrichten
In API Gateway können Sie einer API-Stufe ein Tag hinzufügen, das Tag aus der Stufe entfernen oder das Tag anzeigen. Dazu können Sie die API-Gateway-Konsole, die AWS CLI/das SDK oder die API-Gateway-REST-API verwenden.
Eine Stufe kann auch Tags von der übergeordneten REST-API erben. Weitere Informationen finden Sie unter [Tag-Vererbung in der Amazon API Gateway V1-API](apigateway-tagging-supported-resources.md#apigateway-tagging-inheritance).
Weitere Informationen über das Markieren mit Tags von API Gateway-Ressourcen finden Sie unter [API Gateway-Ressourcen taggen](apigateway-tagging.md).
**Topics**
+ [Einrichten von Tags für eine API-Stufe mit der API-Gateway-Konsole](#set-up-tags-using-console)
+ [Tags für eine API-Stufe mithilfe der AWS CLI-Konsole einrichten](#set-up-tags-using-cli)
+ [Einrichten von Tags für eine API-Stufe mit der API-Gateway-REST-API](#set-up-tags-using-api)
## Einrichten von Tags für eine API-Stufe mit der API-Gateway-Konsole
Die folgende Vorgehensweise beschreibt, wie Sie Tags für eine API-Stufe einrichten.
**So richten Sie Tags für eine API-Stufe mithilfe der API Gateway-Konsole ein**
1. Melden Sie sich bei der API Gateway-Konsole an.
1. Wählen Sie eine vorhandene API aus oder erstellen Sie eine neue API, die Ressourcen, Methoden und die entsprechenden Integrationen enthält.
1. Wählen Sie eine Stufe aus oder stellen Sie die API in einer neuen Stufe bereit.
1. Klicken Sie im Hauptnavigationsbereich auf **Stages** (Stufen).
1. Wählen Sie die Registerkarte **Tags** aus. Möglicherweise müssen Sie die rechte Pfeiltaste wählen, um die Registerkarte anzuzeigen.
1. Wählen Sie **Tags verwalten** aus.
1. Klicken Sie im **Tag Editor** (Tag-Editor) auf **Add Tag** (Tag hinzufügen). Geben Sie einen Tag-Schlüssel (z. B. `Department`) in das Feld **Schlüssel** und einen Tag-Wert (z. B. `Sales`) in das Feld **Wert** ein. Wählen Sie **Save** (Speichern) aus, um das Tag zu speichern.
1. Wiederholen Sie bei Bedarf Schritt 5, um der API-Stufe weitere Tags hinzuzufügen. Die maximale Anzahl der Tags pro Stufe beträgt 50.
1. Um ein vorhandenes Tag aus der Stufe zu entfernen, wählen Sie **Remove** (Entfernen) aus.
1. Wenn die API zuvor in der API Gateway-Konsole bereitgestellt wurde, müssen Sie sie erneut implementieren, damit die Änderungen wirksam werden.
## Tags für eine API-Stufe mithilfe der AWS CLI-Konsole einrichten
Sie können Tags für eine API-Stufe mithilfe von AWS CLI und dem Befehl [create-stage](https://docs.aws.amazon.com/cli/latest/reference/apigateway/create-stage.html) oder [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/apigateway/tag-resource.html) erstellen. Sie können einen oder mehrere Tags aus einer API-Stufe mithilfe des Befehls [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/apigateway/untag-resource.html) löschen.
Der folgende [create-stage](https://docs.aws.amazon.com/cli/latest/reference/apigateway/create-stage.html)-Befehl fügt beim Erstellen einer `test`-Stufe ein Tag hinzu:
```
aws apigateway create-stage --rest-api-id abc1234 --stage-name test --description 'Testing stage' --deployment-id efg456 --tag Department=Sales
```
Der folgende [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/apigateway/tag-resource.html)-Befehl fügt einer `prod`-Stufe ein Tag hinzu:
```
aws apigateway tag-resource --resource-arn arn:aws:apigateway:us-east-2::/restapis/abc123/stages/prod --tags Department=Sales
```
Der folgende [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/apigateway/untag-resource.html)-Befehl entfernt das Tag `Department=Sales` aus der `test`-Stufe:
```
aws apigateway untag-resource --resource-arn arn:aws:apigateway:us-east-2::/restapis/abc123/stages/test --tag-keys Department
```
## Einrichten von Tags für eine API-Stufe mit der API-Gateway-REST-API
Sie können Tags für eine API-Stufe mit Hilfe der API Gateway-REST-API einrichten, indem Sie eine der folgenden Aktionen ausführen:
+ Rufen Sie [https://docs.aws.amazon.com/apigateway/latest/api/API_TagResource.html](https://docs.aws.amazon.com/apigateway/latest/api/API_TagResource.html) auf, um eine API-Stufe mit einem Tag zu versehen.
+ Rufen Sie [https://docs.aws.amazon.com/apigateway/latest/api/API_UntagResource.html](https://docs.aws.amazon.com/apigateway/latest/api/API_UntagResource.html) auf, um einen oder mehrere Tags aus einer API-Stufe zu löschen.
+ Rufen Sie [https://docs.aws.amazon.com/apigateway/latest/api/API_CreateStage.html](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateStage.html) auf, um einen oder mehrere Tags zu einer API-Stufe, die Sie erstellen, hinzuzufügen.
Sie können außerdem [https://docs.aws.amazon.com/apigateway/latest/api/API_GetTags.html](https://docs.aws.amazon.com/apigateway/latest/api/API_GetTags.html) aufrufen, um Tags in einer API-Stufe zu beschreiben.
### Tag zu einer API-Stufe hinzufügen
Nach Bereitstellung einer API (`m5zr3vnks7`) für eine Stufe (`test`) versehen Sie die Stufe durch Aufruf von [https://docs.aws.amazon.com/apigateway/latest/api/API_TagResource.html](https://docs.aws.amazon.com/apigateway/latest/api/API_TagResource.html) mit einem Tag. Die erforderliche Amazon-Ressourcenname (ARN) (`arn:aws:apigateway:us-east-1::/restapis/m5zr3vnks7/stages/test`) der Stufe muss URL-codiert sein (`arn%3Aaws%3Aapigateway%3Aus-east-1%3A%3A%2Frestapis%2Fm5zr3vnks7%2Fstages%2Ftest`).
```
PUT /tags/arn%3Aaws%3Aapigateway%3Aus-east-1%3A%3A%2Frestapis%2Fm5zr3vnks7%2Fstages%2Ftest
{
"tags" : {
"Department" : "Sales"
}
}
```
Sie können auch die vorherige Anforderung verwenden, um einen bestehenden Tag auf einen neuen Wert zu aktualisieren.
Sie können Tags zu einer Stufe hinzufügen, wenn Sie [https://docs.aws.amazon.com/apigateway/latest/api/API_CreateStage.html](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateStage.html) aufrufen, um die Stufe zu erstellen:
```
POST /restapis//stages
{
"stageName" : "test",
"deploymentId" : "adr134",
"description" : "test deployment",
"cacheClusterEnabled" : "true",
"cacheClusterSize" : "500",
"variables" : {
"sv1" : "val1"
},
"documentationVersion" : "test",
"tags" : {
"Department" : "Sales",
"Division" : "Retail"
}
}
```
### Tag von einer API-Stufe entfernen
Rufen Sie [https://docs.aws.amazon.com/apigateway/latest/api/API_UntagResource.html](https://docs.aws.amazon.com/apigateway/latest/api/API_UntagResource.html) auf, um den `tags:untag`-Tag von der Stufe zu entfernen:
```
DELETE /tags/arn%3Aaws%3Aapigateway%3Aus-east-1%3A%3A%2Frestapis%2Fm5zr3vnks7%2Fstages%2Ftest?tagKeys=Department
Host: apigateway.us-east-1.amazonaws.com
Authorization: ...
```
Um mehrere Tags zu entfernen, verwenden Sie eine kommagetrennte Liste mit Tag-Schlüsseln im Abfrageausdruck (zum Beispiel `?tagKeys=Department,Division,…`).
### Beschreiben von Tags für eine API-Stufe
Um existierende Tags einer bestehenden Stufe zu beschreiben, rufen Sie [https://docs.aws.amazon.com/apigateway/latest/api/API_GetTags.html](https://docs.aws.amazon.com/apigateway/latest/api/API_GetTags.html) auf:
```
GET /tags/arn%3Aaws%3Aapigateway%3Aus-east-1%3A%3A%2Frestapis%2Fm5zr3vnks7%2Fstages%2Ftags
Host: apigateway.us-east-1.amazonaws.com
Authorization: ...
```
Eine erfolgreiche Antwort ähnelt dem folgenden Beispiel:
```
200 OK
{
"_links": {
"curies": {
"href": "http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-tags-{rel}.html",
"name": "tags",
"templated": true
},
"tags:tag": {
"href": "/tags/arn%3Aaws%3Aapigateway%3Aus-east-1%3A%3A%2Frestapis%2Fm5zr3vnks7%2Fstages%2Ftags"
},
"tags:untag": {
"href": "/tags/arn%3Aaws%3Aapigateway%3Aus-east-1%3A%3A%2Frestapis%2Fm5zr3vnks7%2Fstages%2Ftags{?tagKeys}",
"templated": true
}
},
"tags": {
"Department": "Sales"
}
}
```