Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
AddStorageSystem
Crea una AWS risorsa per un sistema di storage locale su cui desideri che DataSync Discovery raccolga informazioni.
Sintassi della richiesta
{
"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
"
}
]
}
Parametri della richiesta
Per informazioni sui parametri comuni a tutte le azioni, vedere Parametri comuni.
La richiesta accetta i seguenti dati in formato JSON.
- AgentArns
-
Specifica il nome della risorsa Amazon (ARN) dell'DataSyncagente che si connette e legge dall'interfaccia di gestione del sistema di storage locale.
Tipo: matrice di stringhe
Membri dell'array: numero minimo di 1 elemento.
Limitazioni di lunghezza: lunghezza massima di 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}$
Campo obbligatorio: sì
- ClientToken
-
Specifica un token client per assicurarsi che le richieste con questa operazione API siano idempotenti. Se non si specifica un token client, ne DataSync genera.
Tipo: stringa
Pattern:
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}
Campo obbligatorio: sì
- CloudWatchLogGroupArn
-
Specifica l'ARN del gruppo di CloudWatch log Amazon per il monitoraggio e la registrazione degli eventi del processo di rilevamento.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 562.
Modello:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$
Required: No
- Credentials
-
Specifica il nome utente e la password per accedere all'interfaccia di gestione del sistema di storage locale.
Tipo: Credentials oggetto
Campo obbligatorio: sì
- Name
-
Specifica un nome familiare per il sistema di storage locale.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 256 caratteri.
Modello:
^[\p{L}\p{M}\p{N}\s+=._:@\/-]+$
Required: No
- ServerConfiguration
-
Specifica il nome del server e la porta di rete necessari per connettersi all'interfaccia di gestione del sistema di storage locale.
Tipo: DiscoveryServerConfiguration oggetto
Campo obbligatorio: sì
- SystemType
-
Specifica il tipo di sistema di storage locale su cui si desidera che DataSync Discovery raccolga informazioni.
Nota
DataSyncDiscovery attualmente supporta i sistemi NetApp Fabric-Attached Storage (FAS) e All Flash FAS (AFF) che eseguono ONTAP 9.7 o versione successiva.
Tipo: String
Valori validi:
NetAppONTAP
Campo obbligatorio: sì
- Tags
-
Specifica le etichette che consentono di classificare, filtrare e cercare le risorse AWS. È consigliabile creare almeno un tag di nome per il sistema di storage locale.
Tipo: matrice di oggetti TagListEntry
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.
Required: No
Sintassi della risposta
{
"StorageSystemArn": "string"
}
Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- StorageSystemArn
-
L'ARN del sistema di storage locale che puoi usare con DataSync Discovery.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 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}$
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- InternalException
-
Questa eccezione viene generata quando si verifica un errore nel AWS DataSync servizio.
Codice di stato HTTP: 500
- InvalidRequestException
-
Questa eccezione viene generata quando il client invia una richiesta non valida.
Codice di stato HTTP: 400
Esempi
Richiesta di esempio
L'esempio seguente aggiunge un sistema di storage locale a DataSync Discovery.
{ "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" } }
Risposta di esempio
Una risposta restituisce l'ARN del sistema di storage locale appena aggiunto a DataSync Discovery.
{ "StorageSystemArn": "arn:aws:datasync:us-east-1:111222333444:system/storage-system-abcdef01234567890" }
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: