CreateLocationNfs - 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à.

CreateLocationNfs

Definisce un file system in un server NFS (Network File System) in cui è possibile leggere o scrivere.

Sintassi della richiesta

{ "MountOptions": { "Version": "string" }, "OnPremConfig": { "AgentArns": [ "string" ] }, "ServerHostname": "string", "Subdirectory": "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.

MountOptions

Le opzioni di montaggio NFS cheDataSync è possibile utilizzare per montare la condivisione NFS.

Tipo: NfsMountOptions oggetto

Required: No

OnPremConfig

Contiene un elenco di Amazon Resource Name (ARN) degli agenti utilizzati per connettersi a un server NFS.

Se si stanno copiando dati da o da un dispositivo AWS Snowcone, vedere NFS Server su AWS Snowcone per ulteriori informazioni.

Tipo: OnPremConfig oggetto

Campo obbligatorio: sì

ServerHostname

Il nome del server NFS. Questo valore è l'indirizzo IP o il nome DNS (Domain Name Service) del server NFS. Un agente installato on-premise utilizza questo nome host per montare il server NFS in una rete.

Se si stanno copiando dati da o da un dispositivo AWS Snowcone, vedere NFS Server su AWS Snowcone per ulteriori informazioni.

Nota

Questo nome deve essere conforme a DNS o deve essere un indirizzo IP versione 4 (IPv4).

Tipo: String

Limitazioni di lunghezza: lunghezza massima di 255.

Pattern: ^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$

Campo obbligatorio: sì

Subdirectory

La sottodirectory del file system NFS utilizzata per leggere i dati dalla posizione di origine NFS o scrivere dati nella destinazione NFS. Il percorso NFS deve essere un percorso esportato dal server NFS o una sottodirectory di tale percorso. Questo percorso deve essere tale da poter essere montato da altri client NFS della rete.

Per visualizzare tutti i percorsi esportati dal tuo server NFS, esegui "showmount -e nfs-server-name" da un client NFS con accesso ai server. Puoi specificare qualsiasi directory visualizzata nei risultati e qualsiasi sottodirectory di tale directory. Verifica che sia possibile accedere all'esportazione NFS senza l'autenticazione Kerberos.

Per trasferire tutti i dati nella cartella specificata, è necessario che DataSync disponga delle autorizzazioni per leggere tutti i dati. A tale scopo, configura l'esportazione NFS conno_root_squash, o assicurati che siano impostate le autorizzazioni per tutti i file per i quali si desidera che siano impostate leDataSync autorizzazioni per tutti gli utenti. Entrambe le operazioni permettono all'agente di leggere i file. Affinché l'agente possa accedere alle directory, è necessario inoltre abilitare l'accesso in esecuzione a tutti gli utenti.

Se si stanno copiando dati da o da un dispositivo AWS Snowcone, vedere NFS Server su AWS Snowcone per ulteriori informazioni.

Per informazioni sulla configurazione dell'esportazione NFS, consulta 18.7. Il file di configurazione /etc/exports nella documentazione di Red Hat Enterprise Linux.

Tipo: String

Vincoli di lunghezza: lunghezza massima di 4096.

Pattern: ^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]+$

Campo obbligatorio: sì

Tags

La coppia chiave-valore che rappresenta il tag che si desidera aggiungere alla posizione. Il valore può essere una stringa vuota. Si consiglia di utilizzare tag per assegnare un nome alle risorse.

Tipo: matrice di oggetti TagListEntry

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.

Required: No

Sintassi della risposta

{ "LocationArn": "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.

LocationArn

L'Amazon Resource Name (ARN) della posizione del file system NFS che viene creato.

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}:location/loc-[0-9a-z]{17}$

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

InternalException

Questa eccezione viene generata quando si verifica un errore nelAWS 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

Esempio

L'esempio seguente crea un endpoint per un file system NFS utilizzando la versione NFS specificata come opzione di montaggio.

Richiesta di esempio

{ "MountOptions": { "Version": : "NFS4_0" }, "OnPremConfig": { "AgentArn": [ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs" ] }, "ServerHostname": "MyServer@amazon.com", "Subdirectory": "/MyFolder", "Tags": [ { "Key": "Name", "Value": "ElasticFileSystem-1" } ] }

Esempio

La risposta restituisce l'Amazon Resource Name (ARN) della posizione NFS.

Risposta di esempio

{ "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa" }

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: