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à.
CreateLocationEfs
Crea un endpoint per un file system Amazon EFS a cui AWS DataSync può accedere per un trasferimento. Per ulteriori informazioni, consulta Creazione di una posizione per Amazon EFS.
Sintassi della richiesta
{
"AccessPointArn": "string
",
"Ec2Config": {
"SecurityGroupArns": [ "string
" ],
"SubnetArn": "string
"
},
"EfsFilesystemArn": "string
",
"FileSystemAccessRoleArn": "string
",
"InTransitEncryption": "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.
- AccessPointArn
-
Il nome della risorsa Amazon (ARN) del punto di accesso che DataSync usa per accedere al file system Amazon EFS.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 128.
Modello:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$
Required: No
- Ec2Config
-
Specifica la sottorete e i gruppi di sicurezza DataSync utilizzati da per accedere al file system Amazon EFS.
Tipo: Ec2Config oggetto
Campo obbligatorio: sì
- EfsFilesystemArn
-
Specifica l'ARN per il file system Amazon EFS.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 128.
Pattern:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]*:[0-9]{12}:file-system/fs-.*$
Campo obbligatorio: sì
- FileSystemAccessRoleArn
-
Specifica un ruolo AWS Identity and Access Management (IAM) DataSync assunto durante il montaggio del file system Amazon EFS.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 2048.
Pattern:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$
Required: No
- InTransitEncryption
-
Specifica se desideri DataSync utilizzare la crittografia Transport Layer Security (TLS) 1.2 quando copia i dati dal o nel file system Amazon EFS.
Se specifichi un punto di accesso utilizzando
AccessPointArn
o un ruolo IAM utilizzandoFileSystemAccessRoleArn
, è necessario impostare questo parametro suTLS1_2
.Tipo: String
Valori validi:
NONE | TLS1_2
Required: No
- Subdirectory
-
Specifica un percorso di montaggio per il tuo file system Amazon EFS. È qui che DataSync legge o scrive dati (a seconda che si tratti di una posizione di origine o di destinazione). Per impostazione predefinita, DataSync utilizza la directory principale, ma è possibile includere anche sottodirectory.
Nota
È necessario specificare un valore con barre (ad esempio,
/path/to/folder
).Tipo: String
Limitazioni di lunghezza: lunghezza massima di 4096.
Modello:
^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$
Required: No
- Tags
-
Specifica la coppia chiave-valore che rappresenta un tag che si desidera aggiungere alla risorsa. Il valore può essere una stringa vuota. Questo valore consente di gestire, filtrare e cercare le risorse. È consigliabile creare un tag di nome per la posizione.
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 Amazon EFS 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 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 crea una posizione per un file system Amazon EFS.
{ "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:11122233344:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:11122233344:security-group/sg-1234567890abcdef2" ] }, "EfsFilesystemArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:file-system/fs-021345abcdef6789", "Subdirectory": "/mount/path", "Tags": [{ "Key": "Name", "Value": "ElasticFileSystem-1" }] }
Richiesta di esempio: creazione di una posizione per un file system Amazon EFS soggetto a restrizioni
L'esempio seguente crea una posizione per un file system Amazon EFS con accesso limitato. In questo tipo di scenario, potrebbe essere necessario specificare i valori per AccessPointArn
e InTransitEncryption
nella richiesta. FileSystemAccessRoleArn
{ "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:access-point/fsap-1234567890abcdef0", "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2" ] }, "FileSystemAccessRoleArn": "arn:aws:iam::111222333444:role/AwsDataSyncFullAccessNew", "InTransitEncryption": "TLS1_2", "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890", "LocationUri": "efs://us-east-2.fs-021345abcdef6789/", "Subdirectory": "/mount/path", "Tags": [{ "Key": "Name", "Value": "ElasticFileSystem-1" }] }
Risposta di esempio
Una risposta restituisce l'ARN della posizione del file system Amazon EFS.
{ "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678" }
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: