本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
傳回指定 EFS 檔案系統的 FileSystemPolicy。
這項操作需要 elasticfilesystem:DescribeFileSystemPolicy 動作的許可。
請求語法
GET /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
URI 請求參數
請求會使用下列 URI 參數。
- FileSystemId
-
指定要擷取
FileSystemPolicy的 EFS 檔案系統。長度限制：長度上限為 128。
模式：
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$必要：是
請求主體
請求沒有請求主體。
回應語法
HTTP/1.1 200
Content-type: application/json
{
"FileSystemId": "string",
"Policy": "string"
}回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- FileSystemId
-
指定
FileSystemPolicy套用的 EFS 檔案系統。類型：字串
長度限制：長度上限為 128。
模式：
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$ - Policy
-
適用於 EFS 檔案系統的 JSON 格式化
FileSystemPolicy。類型：字串
長度限制：長度下限為 1。長度上限為 20,000。
模式：
[\s\S]+
錯誤
- BadRequest
-
如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。
HTTP 狀態碼：400
- FileSystemNotFound
-
如果指定的
FileSystemId值不存在於請求者的 中，則傳回 AWS 帳戶。HTTP 狀態碼：404
- InternalServerError
-
如果伺服器端發生錯誤，則傳回。
HTTP 狀態碼：500
- PolicyNotFound
-
如果為單區域 EFS 檔案系統指定 ，
no backup則傳回。HTTP 狀態碼：404
範例
範例
此範例說明了 DescribeFileSystemPolicy 的一種用法。
請求範例
GET /2015-02-01/file-systems/fs-01234567/policy HTTP/1.1回應範例
{
"FileSystemId": "fs-01234567",
"Policy": "{
"Version": "2012-10-17",
"Id": "efs-policy-wizard-cdef0123-aaaa-6666-5555-444455556666",
"Statement": [
{
"Sid": "efs-statement-abcdef01-1111-bbbb-2222-111122224444",
"Effect" : "Deny",
"Principal": {
"AWS": "*"
},
"Action": "*",
"Resource": "arn:aws:elasticfilesystem:us-east-2:111122223333:file-system/fs-01234567",
"Condition": {
"Bool": {
"aws:SecureTransport": "false"
}
}
},
{
"Sid": "efs-statement-01234567-aaaa-3333-4444-111122223333",
"Effect": "Allow",
"Principal": {
"AWS": "*"
},
"Action": [
"elasticfilesystem:ClientMount",
"elasticfilesystem:ClientWrite"
],
"Resource" : "arn:aws:elasticfilesystem:us-east-2:111122223333:file-system/fs-01234567"
}
]
}
}另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
