调用DescribeAccessRules接口查询权限规则描述。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
AccessGroupName String 是 classic-test

权限组名称。
AccessRuleId String 否 1

规则序号。
PageSize Integer 否 1

分页查询时，每个分页包含的文件系统个数。

取值范围：1~100

默认值：10
PageNumber Integer 否 1

文件系统列表的分页页码。

起始值（默认值）：1
FileSystemType String 否 standard

文件系统类型。

取值：

  • standard（默认值）：通用型NAS
  • extreme：极速型NAS

返回数据

名称 类型 示例值 描述
TotalCount Integer 1

权限规则的总个数。
RequestId String 86D89E82-4297-4343-8E1E-A2495B35****

请求ID。
PageSize Integer 1

每个分页包含的权限规则个数。
PageNumber Integer 1

文件系统列表的分页页码。
AccessRules Array of AccessRule

权限规则信息集合。
AccessRule
AccessRuleId String 1

权限规则ID。
SourceCidrIp String 10.0.*.*/**

地址或地址段。
Ipv6SourceCidrIp String 2001:250:6000::***

源端IPv6 CIDR地址段。
RWAccess String RDWR

授权对象对文件系统的读写权限。

取值：

  • RDWR（默认值）：读写
  • RDONLY：只读
UserAccess String no_squash

授权对象的系统用户对文件系统的访问权限。

取值：

  • no_squash：允许使用root用户访问文件系统。
  • root_squash：以root用户身份访问时，映射nobody用户。
  • all_squash：无论以何种用户身份访问，均映射为nobody用户。

nobody用户是Linux系统的默认用户，只能访问服务器上的公共内容，具有低权限，高安全性的特点。
Priority Integer 1

优先级。

当同一个授权对象匹配到多条规则时，高优先级规则生效。

取值范围：1~100，1为最高优先级。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeAccessRules
&AccessGroupName=classic-test
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeAccessRulesResponse>
    <TotalCount>1</TotalCount>
    <PageSize>1</PageSize>
    <RequestId>86D89E82-4297-4343-8E1E-A2495B35****</RequestId>
    <PageNumber>1</PageNumber>
    <AccessRules>
        <AccessRule>
            <RWAccess>RDWR</RWAccess>
            <UserAccess>no_squash</UserAccess>
            <Priority>1</Priority>
            <SourceCidrIp>10.0.*.*/**</SourceCidrIp>
            <Ipv6SourceCidrIp>2001:250:6000::***</Ipv6SourceCidrIp>
            <AccessRuleId>1</AccessRuleId>
        </AccessRule>
    </AccessRules>
</DescribeAccessRulesResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "PageSize" : 1,
  "RequestId" : "86D89E82-4297-4343-8E1E-A2495B35****",
  "PageNumber" : 1,
  "AccessRules" : {
    "AccessRule" : [ {
      "RWAccess" : "RDWR",
      "UserAccess" : "no_squash",
      "Priority" : 1,
      "SourceCidrIp" : "10.0.*.*/**",
      "Ipv6SourceCidrIp" : "2001:250:6000::***",
      "AccessRuleId" : "1"
    } ]
  }
}

错误码

访问错误中心查看更多错误码。