DescribeLocationEfs - AWS DataSync

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

DescribeLocationEfs

傳回中繼資料,例如與 Amazon EFS 位置的路徑相關資訊。

請求語法

{ "LocationArn": "string" }

請求參數

如需所有動作通用參數的相關資訊,請參閱一般參數

請求接受採用 JSON 格式的下列資料。

LocationArn

EFS 位置的 Amazon Resource Name (ARN) 來描述。

類型:字串

長度限制:長度上限為 128。

模式:^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}$

必要:是

回應語法

{ "CreationTime": number, "Ec2Config": { "SecurityGroupArns": [ "string" ], "SubnetArn": "string" }, "LocationArn": "string", "LocationUri": "string" }

回應元素

如果動作成功,則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

CreationTime

建立 EFS 位置的時間。

類型:時間戳記

Ec2Config

DataSync 用於存取目標 EFS 檔案系統的子網路和安全群組。子網路必須具有該檔案系統至少一個掛載目標。您所提供的安全群組,必須能夠與指定子網路中掛載目標上的安全群組進行通訊。

類型:Ec2Config 物件

LocationArn

EFS 位置的 Amazon Resource Name (ARN)。

類型:字串

長度限制:長度上限為 128。

模式:^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

EFS 位置所描述。

類型:字串

長度限制:長度上限為 4356。

模式:^(efs|nfs|s3|smb|fsxw|fsxl)://[a-zA-Z0-9.\-]+$

Errors

如需所有動作常見的錯誤相關資訊,請參閱常見錯誤

InternalException

當發生錯誤時,就會擲出此例外狀況AWS DataSync服務。

HTTP 狀態碼:500

InvalidRequestException

當用戶端提交格式錯誤的要求時,就會擲出此例外狀況。

HTTP 狀態碼:400

Examples

Example

以下範例會傳回範例請求中指定的 Amazon EFS 位置的相關資訊。

請求範例

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

Example

此範例說明 DescribeLocationEfs 的一種用法。

回應範例

{ "CreationTime": "", "Ec2Config": { SecurityGroupArns": ["arn:aws:ec2:us-east-2:11122233344:security-group/sg-0117195988293d62f"], "SubnetArn": "arn:aws:ec2:us-east-2:11122233344:subnet/subnet-f45a0e678", }, "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50fb", "LocationUri": "us-east-2.fs-abcd1234. ", }

另請參閱

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊,請參閱下列說明: