AddStorageSystem - AWS DataSync

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: