调用DescribeAccessPoint接口查询接入点详情-文件存储NAS-阿里云-文件存储NAS(NAS)-阿里云帮助中心

查询接入点详情。

接口说明

仅通用型 NAS NFS 协议文件系统支持该功能。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

nas:DescribeAccessPoint

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
FileSystemId	string	是	文件系统 ID。	31a8e4****
AccessPointId	string	是	接入点 ID。	ap-ie15yd****

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
AccessPoint	object	接入点信息。
ARN	string	接入点 ARN。	acs:nas:cn-hangzhou:178321033379**:accesspoint/ap-ie15yd**
AccessGroup	string	权限组名称。	test
AccessPointId	string	接入点 ID。	ap-ie15yd****
AccessPointName	string	接入点名称。	test
CreateTime	string	接入点的创建时间。	1709619668276167
DomainName	string	接入点域名。	ap-ie15ydanoz.001014**-w**.cn-hangzhou.nas.aliyuncs.com
EnabledRam	boolean	是否启用 RAM 策略。	false
FileSystemId	string	文件系统 ID。	31a8e4****
ModifyTime	string	接入点修改时间。	1709619668276167
RootPathPermission	object	根目录创建权限。
OwnerGroupId	integer	属主用户组 ID。	123
OwnerUserId	integer	属主用户 ID。	1
Permission	string	POSIX 权限。	0755
PosixUser	object	Posix 用户。
PosixGroupId	integer	Posix 用户组 ID。	12
PosixUserId	integer	Posix 用户 ID。	123
PosixSecondaryGroupIds	array	第二用户组 ID。
	integer	第二用户组 ID。	[123,123]
RootPath	string	根目录。	/
RootPathStatus	string	当前根目录状态。包括： 0：rootpath 状态未知 1：rootpath 不存在（可能被用户删除了） 2：rootpath 状态正常	2
Status	string	当前接入点状态。包括： Active：可用 Inactive：不可用 Pending：创建中 Deleting：删除中	Active
VSwitchId	string	交换机 ID。	vsw-2zevmwkwyztjuoffg****
VpcId	string	专有网络 ID。必须与待挂载的云服务器 ECS 选择相同的 VPC 网络。	vpc-2zesj9afh3y518k9o****
Tags	array<object>	接入点标签列表。
	object	接入点标签列表。
Key	string	标签键。	TestKey
Value	string	标签值。	TestValue
RegionId	string	地域 ID。	cn-hangzhou
AgenticSpaceId	string	AgenticSpace Id。	agentic-229oypxjgpau2****
CreateTimeUtc	string	AgenticSpace 创建时间。执行 ISO8601 标准表示，返回格式：yyyy-MM-ddTHH:mm:ssZ。	2026-06-10T10:08:08Z
ModifyTimeUtc	string	AgenticSpace 更新时间。执行 ISO8601 标准表示，返回格式：yyyy-MM-ddTHH:mm:ssZ。	2026-06-10T10:08:08Z

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "AccessPoint": {
    "ARN": "acs:nas:cn-hangzhou:178321033379****:accesspoint/ap-ie15yd****",
    "AccessGroup": "test\n",
    "AccessPointId": "ap-ie15yd****\n",
    "AccessPointName": "test",
    "CreateTime": "1709619668276167",
    "DomainName": "ap-ie15ydanoz.001014****-w****.cn-hangzhou.nas.aliyuncs.com",
    "EnabledRam": false,
    "FileSystemId": "31a8e4****",
    "ModifyTime": "1709619668276167",
    "RootPathPermission": {
      "OwnerGroupId": 123,
      "OwnerUserId": 1,
      "Permission": "0755"
    },
    "PosixUser": {
      "PosixGroupId": 12,
      "PosixUserId": 123,
      "PosixSecondaryGroupIds": [
        0
      ]
    },
    "RootPath": "/",
    "RootPathStatus": "2",
    "Status": "Active",
    "VSwitchId": "vsw-2zevmwkwyztjuoffg****",
    "VpcId": "vpc-2zesj9afh3y518k9o****",
    "Tags": [
      {
        "Key": "TestKey",
        "Value": "TestValue"
      }
    ],
    "RegionId": "cn-hangzhou",
    "AgenticSpaceId": "agentic-229oypxjgpau2****",
    "CreateTimeUtc": "2026-06-10T10:08:08Z",
    "ModifyTimeUtc": "2026-06-10T10:08:08Z"
  }
}

错误码

HTTP status code	错误码	错误信息	描述
404	InvalidAccessPointId.NotFound	The access point id does not exist.	指定的APid不存在。
404	InvalidFileSystem.NotFound	The specified file system does not exist.	指定的文件系统不存在。

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

变更历史

更多信息，参考变更详情。