ListTagsForResource - AWS Transfer Family
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerBeispieleWeitere Informationen finden Sie unter:

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.

ListTagsForResource

Listet alle Tags auf, die dem von Ihnen angegebenen Amazon-Ressourcennamen (ARN) zugeordnet sind. Die Ressource kann ein Benutzer, ein Server oder eine Rolle sein.

Anforderungssyntax

{
   "Arn": "string",
   "MaxResults": number,
   "NextToken": "string"
}

Anforderungsparameter

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter Allgemeine Parameter.

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

Arn

Fordert die Tags an, die einem bestimmten Amazon-Ressourcennamen (ARN) zugeordnet sind. Ein ARN ist eine Kennung für eine bestimmte AWS Ressource, z. B. einen Server, einen Benutzer oder eine Rolle.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 20. Maximale Länge beträgt 1600 Zeichen.

Pattern: arn:\S+

Erforderlich: Ja

MaxResults

Gibt die Anzahl der Tags an, die als Antwort auf die ListTagsForResource Anforderung zurückgegeben werden sollen.

Typ: Ganzzahl

Gültiger Bereich: Mindestwert 1. Maximaler Wert von 1 000.

Erforderlich: Nein

NextToken

Wenn Sie zusätzliche Ergebnisse aus der -ListTagsForResourceOperation anfordern, wird ein NextToken Parameter in der Eingabe zurückgegeben. Anschließend können Sie einen nachfolgenden Befehl an den NextToken Parameter übergeben, um weitere Tags aufzulisten.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 6144.

Erforderlich: Nein

Antwortsyntax

{
   "Arn": "string",
   "NextToken": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "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.

Arn

Der ARN, den Sie zum Auflisten der Tags angegeben haben.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 20. Maximale Länge beträgt 1600 Zeichen.

Pattern: arn:\S+

NextToken

Wenn Sie zusätzliche Ergebnisse aus dem ListTagsForResource Aufruf erhalten können, wird in der Ausgabe ein NextToken Parameter zurückgegeben. Anschließend können Sie einen nachfolgenden Befehl an den NextToken Parameter übergeben, um weitere Tags aufzulisten.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 6144.

Tags

Schlüssel-Wert-Paare, die einer Ressource zugewiesen sind, dienen normalerweise der Gruppierung und Suche von Elementen. Tags sind Metadaten, die Sie definieren.

Typ: Array von Tag-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 50 Elemente.

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

InternalServiceError

Diese Ausnahme wird ausgelöst, wenn ein Fehler im AWS Transfer Family Service auftritt.

HTTP Status Code: 500

InvalidNextTokenException

Der übergebene NextToken Parameter ist ungültig.

HTTP Status Code: 400

InvalidRequestException

Diese Ausnahme wird ausgelöst, wenn der Client eine fehlerhafte Anforderung sendet.

HTTP Status Code: 400

ServiceUnavailableException

Die Anforderung ist fehlgeschlagen, da der AWSTransfer Family-Service nicht verfügbar ist.

HTTP Status Code: 500

Beispiele

Beispiel

Im folgenden Beispiel werden die Tags für die Ressource mit dem von Ihnen angegebenen ARN aufgelistet.

Beispielanforderung


{
   "Arn": "arn:aws:transfer:us-east-1:176354371281:server/s-01234567890abcdef"
}

Beispiel

Dieses Beispiel veranschaulicht eine Verwendung von ListTagsForResource.

Beispielantwort


{
   "Tags": [ 
      { 
         "Key": "Name",
         "Value": "MyServer"
      }
   ]
}

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: