DescribeFileSystemPolicy - Amazon Elastic File System
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

DescribeFileSystemPolicy

返回指定 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。最大长度为 20000。

模式:[\s\S]+

错误

BadRequest

如果请求格式错误或包含错误(例如参数值无效或缺少必填参数),则返回此内容。

HTTP 状态代码:400

FileSystemNotFound

如果请求者的 Amazon Web Services 账户中不存在指定的 FileSystemId 值,则返回此内容。

HTTP 状态代码:404

InternalServerError

如果服务器端发生错误,则返回此内容。

HTTP 状态代码:500

PolicyNotFound

如果默认文件系统策略对指定的 EFS 文件系统有效,则返回。

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" } ] } }

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: