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à.
DescribeLocationEfs
Restituisce i metadati sulla AWS DataSync posizione dell'utente per un file system Amazon EFS.
Sintassi della richiesta
{
"LocationArn": "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.
- LocationArn
-
L'Amazon Resource Name (ARN) della posizione del file system Amazon EFS sul quale desideri informazioni.
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}$Campo obbligatorio: sì
Sintassi della risposta
{
"AccessPointArn": "string",
"CreationTime": number,
"Ec2Config": {
"SecurityGroupArns": [ "string" ],
"SubnetArn": "string"
},
"FileSystemAccessRoleArn": "string",
"InTransitEncryption": "string",
"LocationArn": "string",
"LocationUri": "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.
- AccessPointArn
-
L'ARN del punto di accesso che DataSync usa per accedere al 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}:access-point/fsap-[0-9a-f]{8,40}$ - CreationTime
-
L'ora in cui è stata creata la posizione.
Tipo: Timestamp
- Ec2Config
-
La sottorete e i gruppi di sicurezza utilizzati da AWS DataSync per accedere al file system Amazon EFS.
Tipo: Ec2Config oggetto
- FileSystemAccessRoleArn
-
Il 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/.*$ - InTransitEncryption
-
Descrive se DataSync usa la crittografia Transport Layer Security (TLS) durante la copia dei dati dal o nel file system Amazon EFS.
Tipo: String
Valori validi:
NONE | TLS1_2 - LocationArn
-
L'ARN della posizione del 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):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$ - LocationUri
-
L'URL della posizione del file system Amazon EFS.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 4360.
Pattern:
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$
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 mostra come ottenere informazioni sulla posizione di una posizione del file system Amazon EFS.
{ "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678" }
Risposta di esempio
Nell'esempio seguente vengono restituiti i dettagli sulla posizione di un file system Amazon EFS.
{ "CreationTime": 1653319021.353, "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2" ] }, "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890", "LocationUri": "efs://us-east-2.fs-021345abcdef6789/" }
Esempio di risposta: descrizione della posizione di un file system Amazon EFS soggetto a restrizioni
L'esempio seguente restituisce i dettagli sulla posizione di un file system Amazon EFS con accesso limitato AccessPointArnFileSystemAccessRoleArn, inclusi gli InTransitEncryption elementi e.
{ "CreationTime": 1653319021.353, "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" }] }
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
