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.
AddStorageSystem
Erstellt eine AWS Ressource für ein Premises-Premises-Premises-Premises-System, über das DataSync Discovery Informationen sammeln soll.
Anforderungssyntax
{
"AgentArns": [ "string" ],
"ClientToken": "string",
"CloudWatchLogGroupArn": "string",
"Credentials": {
"Password": "string",
"Username": "string"
},
"Name": "string",
"ServerConfiguration": {
"ServerHostname": "string",
"ServerPort": number
},
"SystemType": "string",
"Tags": [
{
"Key": "string",
"Value": "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.
- AgentArns
-
Gibt den Amazon-Ressourcennamen (ARN) des DataSync Agenten an, der eine Verbindung zur Verwaltungsschnittstelle Ihres Premises-Premises-Premises-Premises-systems verwendet.
Typ: Zeichenfolge-Array
Array-Mitglieder: Feste Anzahl von 1 Element.
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}$Erforderlich: Ja
- ClientToken
-
Gibt ein Client-Token an, um sicherzustellen, dass Anfragen mit dieser API-Operation idempotent sind. Sie können kein DataSync automatisch zu.
Typ: Zeichenfolge
Pattern:
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}Erforderlich: Ja
- CloudWatchLogGroupArn
-
Gibt den ARN der CloudWatch Amazon-Protokollgruppe für die Überwachung und Protokollierung von Discovery-Job-Ereignissen an.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge von 562.
Pattern:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$Erforderlich: Nein
- Credentials
-
Gibt den Benutzernamen und das Kennwort für den Zugriff auf die Verwaltungsschnittstelle Ihres Premises-Premises-Premises-Premises-Premises-Systems an.
Typ: Credentials Objekt
Erforderlich: Ja
- Name
-
Gibt einen vertrauten Namen für Ihr lokales Speichersystem an.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 256 Zeichen.
Pattern:
^[\p{L}\p{M}\p{N}\s+=._:@\/-]+$Erforderlich: Nein
- ServerConfiguration
-
Gibt den Servernamen und den Netzwerkport an, die für die Verbindung mit der Verwaltungsschnittstelle Ihres lokalen Speichersystems erforderlich sind.
Typ: DiscoveryServerConfiguration Objekt
Erforderlich: Ja
- SystemType
-
Gibt den Typ des lokalen Speichersystems an, über das DataSync Discovery Informationen sammeln soll.
Anmerkung
DataSyncDiscovery unterstützt derzeit NetApp Fabric-Attached Storage (FAS) - und All Flash FAS (AFF) -Systeme, auf denen ONTAP 9.7 oder höher ausgeführt wird.
Typ: Zeichenfolge
Zulässige Werte:
NetAppONTAPErforderlich: Ja
- Tags
-
Gibt Bezeichnungen an, mit denen Sie Ihre AWS-Ressourcen kategorisieren, filtern und suchen können. Wir empfehlen, zumindest ein Namensschild für Ihr Premises-Premises-Premises-Premises-system zu erstellen.
Typ: Array von TagListEntry-Objekten
Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente.
Required: No
Antwortsyntax
{
"StorageSystemArn": "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.
- StorageSystemArn
-
Der ARN des lokalen Speichersystems, das Sie mit DataSync Discovery verwenden können.
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}:system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$
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
Beispielanforderung
Im folgenden Beispiel wird DataSync Discovery ein lokales Speichersystem hinzugefügt.
{ "ServerConfiguration": { "ServerHostname": "172.16.0.0", "ServerPort": 443 }, "SystemType": "NetAppONTAP", "AgentArns": [ "arn:aws:datasync:us-east-1:111222333444:agent/agent-012345abcde012345" ], "CloudWatchLogGroupArn": "arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync/discovery:*", "Tags": [ { "Key": "Migration Plan", "Value": "1" } ], "Name": "MyOnPremStorage", "Credentials": { "Username": "admin", "Password": "1234" } }
Beispielantwort
Eine Antwort gibt den ARN des lokalen Speichersystems zurück, das Sie gerade zu DataSync Discovery hinzugefügt haben.
{ "StorageSystemArn": "arn:aws:datasync:us-east-1:111222333444:system/storage-system-abcdef01234567890" }
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter:
