Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
DescribeLocationEfs
Mengembalikan metadata tentang AWS DataSync lokasi Anda untuk sistem file Amazon EFS.
Sintaksis Permintaan
{
"LocationArn": "string
"
}
Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.
Permintaan menerima data berikut dalam format JSON.
- LocationArn
-
Amazon Resource Name (ARN) dari lokasi sistem file Amazon EFS yang Anda inginkan informasi tentang.
Jenis: String
Batasan Panjang: Panjang maksimum 128.
Pola:
^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}$
Diperlukan: Ya
Sintaksis Respons
{
"AccessPointArn": "string",
"CreationTime": number,
"Ec2Config": {
"SecurityGroupArns": [ "string" ],
"SubnetArn": "string"
},
"FileSystemAccessRoleArn": "string",
"InTransitEncryption": "string",
"LocationArn": "string",
"LocationUri": "string"
}
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- AccessPointArn
-
ARN titik akses yang DataSync digunakan untuk mengakses sistem file Amazon EFS.
Jenis: String
Batasan Panjang: Panjang maksimum 128.
Pola:
^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
-
Waktu lokasi dibuat.
Tipe: Timestamp
- Ec2Config
-
Subnet dan grup keamanan yang AWS DataSync digunakan untuk mengakses sistem file Amazon EFS Anda.
Tipe: Objek Ec2Config
- FileSystemAccessRoleArn
-
Peran AWS Identity and Access Management (IAM) yang DataSync mengasumsikan ketika memasang sistem file Amazon EFS.
Jenis: String
Batasan Panjang: Panjang maksimum 2048.
Pola:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$
- InTransitEncryption
-
Menjelaskan apakah DataSync menggunakan enkripsi Transport Layer Security (TLS) saat menyalin data ke atau dari sistem file Amazon EFS.
Jenis: String
Nilai yang Valid:
NONE | TLS1_2
- LocationArn
-
ARN dari lokasi sistem file Amazon EFS.
Jenis: String
Batasan Panjang: Panjang maksimum 128.
Pola:
^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
-
URL dari lokasi sistem file Amazon EFS.
Jenis: String
Batasan Panjang: Panjang maksimum 4360.
Pola:
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$
Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.
- InternalException
-
Pengecualian ini dilontarkan ketika terjadi kesalahan dalam layanan AWS DataSync.
Kode Status HTTP: 500
- InvalidRequestException
-
Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format.
Kode Status HTTP: 400
Contoh
Contoh Permintaan
Contoh berikut menunjukkan cara mendapatkan informasi tentang lokasi sistem file Amazon EFS.
{ "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678" }
Contoh Respons
Contoh berikut menampilkan detail lokasi tentang sistem file 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/" }
Contoh Respons: Menjelaskan lokasi untuk sistem file Amazon EFS yang dibatasi
Contoh berikut menampilkan detail lokasi tentang sistem file Amazon EFS dengan akses terbatas, termasukAccessPointArn
,FileSystemAccessRoleArn
, dan InTransitEncryption
elemen.
{ "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" }] }
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK yang spesifik bahasa, lihat berikut ini: