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.
ListTags
Gibt die der Ressource zugewiesenen Tags zurück, z. B. einen Zielwiederherstellungspunkt, einen Backup-Plan oder einen Backup-Tresor.
Dieser Vorgang gibt Ergebnisse zurück, die vom Ressourcentyp abhängen, der im Wert für verwendet wurderesourceArn. Beispielsweise haben Wiederherstellungspunkte von Amazon DynamoDB mit erweiterten Einstellungen einen ARN (Amazon Resource Name), der mit beginnt. arn:aws:backup Wiederherstellungspunkte (Backups) von DynamoDB ohne aktivierte erweiterte Einstellungen haben einen ARN, der mit beginnt. arn:aws:dynamodb
Wenn dieser Vorgang aufgerufen wird und Sie Werte angebenresourceArn, die einen anderen ARN als habenarn:aws:backup, kann er eine der unten aufgeführten Ausnahmen zurückgeben. Um diese Ausnahme zu verhindern, sollten Sie nur Werte angeben, die Ressourcentypen repräsentieren, die vollständig von verwaltet werden AWS Backup. Diese haben einen ARN, der beginnt, arn:aws:backup und sie sind in der Tabelle Verfügbarkeit von Funktionen nach Ressourcen vermerkt.
Anforderungssyntax
GET /tags/resourceArn/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
- MaxResults
-
Die maximale Anzahl der zurückzugebenden Elemente.
Gültiger Bereich: Mindestwert 1. Maximaler Wert von 1 000.
- NextToken
-
Das nächste Element folgt auf eine unvollständige Liste der zurückgegebenen Elemente. Wenn beispielsweise eine Anforderung zur Rückgabe der
MaxResultsAnzahl von Elementen gestellt wird, ermöglicht IhnenNextToken, mehr Elemente in Ihrer Liste zurückzugeben, beginnend mit der Position, auf die das nächste Token verweist. - resourceArn
-
Ein Amazon-Ressourcenname (ARN), der eine Ressource eindeutig identifiziert. Das Format eines ARN hängt vom Ressourcentyp ab. Gültige Ziele für
ListTagssind Wiederherstellungspunkte, Backup-Pläne und Backup-Tresore.Erforderlich: Ja
Anforderungstext
Der Anforderung besitzt keinen Anforderungstext.
Antwortsyntax
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Tags": {
"string" : "string"
}
}Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
- NextToken
-
Das nächste Element folgt auf eine unvollständige Liste der zurückgegebenen Elemente. Wenn beispielsweise eine Anforderung zur Rückgabe der
MaxResultsAnzahl von Elementen gestellt wird, ermöglicht IhnenNextToken, mehr Elemente in Ihrer Liste zurückzugeben, beginnend mit der Position, auf die das nächste Token verweist.Typ: Zeichenfolge
- Tags
-
Informationen zu den Tags.
Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge
Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehlertypen.
- InvalidParameterValueException
-
Zeigt an, dass etwas mit dem Wert eines Parameters nicht stimmt. Beispielsweise liegt der Wert außerhalb des zulässigen Bereichs.
- Context
- Type
HTTP-Statuscode: 400
- MissingParameterValueException
-
Zeigt an, dass ein erforderlicher Parameter fehlt.
- Context
- Type
HTTP-Statuscode: 400
- ResourceNotFoundException
-
Eine Ressource, die für die Aktion erforderlich ist, ist nicht vorhanden.
- Context
- Type
HTTP-Statuscode: 400
- ServiceUnavailableException
-
Die Anforderung ist aufgrund eines temporären Fehlers des Servers fehlgeschlagen.
- Context
- Type
HTTP Status Code: 500
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
