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 con
no_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: