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.
DescribeLocationS3
Gibt Metadaten, wie beispielsweise den Bucket-Namen, über den Speicherort eines Amazon S3 S3-Buckets zurück.
Anforderungssyntax
{
"LocationArn": "string"
}Anfrageparameter
Informationen zu den Parametern, die allen Aktionen gemeinsam sind, finden Sie unter Allgemeine Parameter.
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
- LocationArn
-
Der Amazon Resource Name (ARN) des Amazon-S3-Bucket-Speicherortes, der beschrieben werden soll.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge von 128.
Pattern:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$Erforderlich: Ja
Antwortsyntax
{
"AgentArns": [ "string" ],
"CreationTime": number,
"LocationArn": "string",
"LocationUri": "string",
"S3Config": {
"BucketAccessRoleArn": "string"
},
"S3StorageClass": "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.
- AgentArns
-
Wenn Sie DataSync auf einem AWS Outpost den Amazon Resource Name (ARNs) der EC2-Agenten verwenden, die auf Ihrem Outpost bereitgestellt werden. Weitere Informationen zum Starten eines DataSync Agenten auf einem AWS Outpost findest du unter Deployment your DataSync agent on AWS Outposts.
Typ: Zeichenfolge-Array
Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 4 Elemente.
Längenbeschränkungen: Maximale Länge von 128.
Pattern:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$ - CreationTime
-
Die Uhrzeit, zu der der der Amazon-S3-Bucket-Speicherort erstellt wurde.
Typ: Zeitstempel
- LocationArn
-
Der Amazon Resource Name (ARN) des Amazon S3 S3-Buckets oder Access Points.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge von 128.
Pattern:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$ - LocationUri
-
Die URL des Amazon S3 S3-Speicherorts, der beschrieben wurde.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge von 4360.
Pattern:
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$ - S3Config
-
Der Amazon-Ressourcenname (ARN) für eine AWS Identity and Access Management (IAM)-Rolle, die für den Zugriff auf den S3-Bucket verwendet wird.
Ausführliche Informationen zur Verwendung einer solchen Rolle finden Sie unter Erstellen eines Speicherorts für Amazon S3 im Benutzerhandbuch für AWS DataSync.
Typ: S3Config Objekt
- S3StorageClass
-
Die Amazon S3 S3-Speicherklasse, in der Sie Ihre Dateien speichern möchten, wenn dieser Speicherort als Aufgabenziel verwendet wird. Weitere Informationen zu S3-Speicherklassen finden Sie unter Amazon S3-Speicherklassen
. Einige Speicherklassen weisen Verhaltensweisen auf, die sich auf Ihre S3-Speicherkosten auswirken können. Ausführliche Informationen finden Sie unter Hinweise zur Arbeit von S3-Speicherklassen unter DataSync. Typ: Zeichenfolge
Zulässige Werte:
STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL
Fehler
Hinweise zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unterHäufige Fehler.
- InternalException
-
Diese Ausnahme wird ausgelöst, wenn ein Fehler im AWS DataSync Dienst auftritt.
HTTP Status Code: 500
- InvalidRequestException
-
Diese Ausnahme wird ausgelöst, wenn der Client eine fehlerhafte Anfrage sendet.
HTTP Status Code: 400
Beispiele
Beispiel
Das folgende Beispiel gibt Informationen über den in der Beispielanforderung angegebenen S3-Speicherort zurück.
Beispielanforderung
{
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3"
}Beispiel
Dieses Beispiel veranschaulicht eine Verwendung von DescribeLocation S3.
Beispielantwort
{
"CreationTime": 1532660733.39,
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3",
"LocationUri": "MyBucket.",
"S3Config": {
"BucketAccessRoleArn": "arn:aws:iam::111222333444:role/MyBucketAccessRole",
}
"S3StorageClass": "STANDARD"
}Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter:
