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 für eine EFS-Ressource der obersten Ebene auf. Sie müssen die ID der Ressource angeben, für die Sie die Tags abrufen wollen.
Diese Operation erfordert Berechtigungen für die Aktion elasticfilesystem:DescribeAccessPoints.
Anforderungssyntax
GET /2015-02-01/resource-tags/ResourceId?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
- MaxResults
-
(Optional) Gibt die maximale Anzahl der Tag-Objekte an, die in der Antwort zurückgegeben werden können. Der Standardwert lautet 100.
Gültiger Bereich: Mindestwert 1.
- NextToken
-
(Optional) Sie können
NextTokenin einer nachfolgenden Anfrage verwenden, um die nächste Seite mit Zugangspunktbeschreibungen abzurufen, wenn die Antwortnutzlast paginiert wurde.Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern:
.+ - ResourceId
-
Gibt die EFS-Ressource an, für die Sie Tags abrufen möchten. Mit diesem API-Endpunkt können Sie Tags für EFS-Dateisysteme und Zugangspunkte abrufen.
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.
Pattern:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$Erforderlich: Ja
Anforderungstext
Der Anforderung besitzt keinen Anforderungstext.
Antwortsyntax
HTTP/1.1 200
Content-type: application/json
{
"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.
- NextToken
-
NextTokenist vorhanden, wenn die Antwort-Payload paginiert ist. Sie könnenNextTokenin einer nachfolgenden Anfrage verwenden, um die nächste Zugangspunktseite abzurufen.Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern:
.+ - Tags
-
Ein Array der Tags für die angegebene EFS-Ressource.
Typ: Array von Tag-Objekten
Fehler
- AccessPointNotFound
-
Wird zurückgegeben, wenn der angegebene
AccessPointIdWert im Wert des Anforderers nicht vorhanden ist AWS-Konto.- ErrorCode
-
Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten.
- Message
-
Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren.
HTTP-Statuscode: 404
- BadRequest
-
Wird zurückgegeben, wenn die Anfrage fehlerhaft ist oder einen Fehler enthält, z. B. einen ungültigen Parameterwert oder einen fehlenden erforderlichen Parameter.
- ErrorCode
-
Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten.
- Message
-
Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren.
HTTP-Statuscode: 400
- FileSystemNotFound
-
Wird zurückgegeben, wenn der angegebene
FileSystemIdWert im Wert des Anforderers nicht vorhanden ist. AWS-Konto- ErrorCode
-
Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten.
- Message
-
Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren.
HTTP-Statuscode: 404
- InternalServerError
-
Wird zurückgegeben, wenn auf der Serverseite ein Fehler aufgetreten ist.
- ErrorCode
-
Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten.
- Message
-
Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren.
HTTP Status Code: 500
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
