调用DescribeAccessRules接口用于返回权限规则描述。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeAccessRules

系统规定参数。默认取值:DescribeAccessRules。

AccessGroupName String classic-test

权限组名称。

AccessRuleId String 1

规则序号。

PageSize Integer 1

分页查询时,每个分页包含的文件系统个数。取值范围:1~100个,默认值为:10个。

PageNumber Integer 1

文件系统列表的分页页码。默认值:1。

FileSystemType String standard

文件系统类型。取值如下:

  • standard(默认值):通用型NAS
  • extreme:极速型NAS

返回数据

名称 类型 示例值 描述
AccessRules Array of AccessRule

权限规则描述信息。

AccessRule
AccessRuleId String 1

权限规则ID。

Ipv6SourceCidrIp String 2001:250:6000::***

源端IPv6 CIDR地址段。

Priority Integer 1

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

取值范围:1~100,1为最高优先级。

RWAccess String RDWR

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

  • RDWR(默认值):读写
  • RDONLY:只读
SourceCidrIp String 10.0.*.*/**

地址或地址段。

UserAccess String no_squash

授权对象的系统用户对文件系统的访问权限。取值如下:

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

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

PageNumber Integer 1

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

PageSize Integer 1

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

RequestId String 86D89E82-4297-4343-8E1E-A2495B35CC70

请求ID。

TotalCount Integer 1

权限规则的总个数。

示例

请求示例

https://nas.cn-hangzhou.aliyuncs.com/?Action=DescribeAccessRules
&AccessGroupName=classic-test
&<公共请求参数>

正常返回示例

XML 格式

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

JSON 格式

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

错误码

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