本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
DescribeFileSystemPolicy
傳回指FileSystemPolicy
定EFS檔案系統的。
這項操作需要 elasticfilesystem:DescribeFileSystemPolicy
動作的許可。
請求語法
GET /2015-02-01/file-systems/FileSystemId
/policy HTTP/1.1
URI請求參數
請求使用下列URI參數。
- FileSystemId
-
指定要擷取的EFS檔案系
FileSystemPolicy
統。長度限制:長度上限為 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檔案系統
FileSystemPolicy
的JSON格式化。類型:字串
長度限制:長度下限為 1。長度上限為 20,000。
模式:
[\s\S]+
錯誤
- BadRequest
-
如果請求格式錯誤或包含錯誤,例如無效的參數值或缺少必要參數,則傳回。
HTTP狀態碼:
- FileSystemNotFound
-
如果請求者中不存在指定的
FileSystemId
AWS 帳戶值,則返回。HTTP狀態碼:
- InternalServerError
-
如果伺服器端發生錯誤,則傳回。
HTTP狀態碼:5
- PolicyNotFound
-
如果預設檔案系統原則對指定的EFS檔案系統有效,則傳回。
HTTP狀態碼:
範例
範例
此範例說明的一種用法 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"
}
]
}
}
另請參閱
如需有關API在其中一種特定語言中使用此功能的詳細資訊 AWS SDKs,請參閱下列內容: