All Products
Search
Document Center

WUYING Workspace:DescribeNASFileSystems

Last Updated:Apr 03, 2024

Queries the information about Apsara File Storage NAS (NAS) file systems.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The ID of the region.

cn-hangzhou
OfficeSiteIdstringNo

The ID of the workspace.

cn-hangzhou+dir-363353****
MaxResultsintegerNo

The number of entries to return on each page.

Maximum value: 100.

Default value: 10.

10
NextTokenstringNo

The token that determines the start point of the query.

caeba0bbb2be03f84eb48b699f0a4883
FileSystemIdarrayNo

The IDs of the NAS file system.

stringNo

The ID of the NAS file system.

04f314****
MatchCompatibleProfilebooleanNo

Specifies whether to filter NAS file systems that only support the user profile management (UPM) feature.

false

Response parameters

ParameterTypeDescriptionExample
object
NextTokenstring

The token that determines the start point of the next query. This parameter is empty if no additional results exist.

caeba0bbb2be03f84eb48b699f0a4883
RequestIdstring

The ID of the request.

269BDB16-2CD8-4865-84BD-11C40BC21DB0
FileSystemsobject []

Details about the NAS file systems.

Capacitylong

The total capacity of the NAS file system. Unit: GiB.

  • The Capacity type has 10 PiB of storage, which is equal to 10,485,760 GiB.
  • The Performance type has 1 PiB of storage, which is equal to 1,048,576 GiB.
10485760
MountTargetStatusstring

The status of the mount target. The possible values include:

  • Pending: The mount target is being created.
  • Active: The mount target is enabled.
  • Inactive: The mount target is disabled.
  • Deleting: The mount target is being deleted.
  • Invalid: The mount target is invalid.
Active
CreateTimestring

The time when the NAS file system was created.

2021-05-10T11:39Z
OfficeSiteIdstring

The ID of the workspace.

cn-hangzhou+dir-363353****
SupportAclboolean

Indicates whether the Server Message Block (SMB) access control list (ACL) feature was enabled.

false
StorageTypestring

The storage type of the NAS file system. Valid values:

  • Capacity
  • Performance
Capacity
OfficeSiteNamestring

The name of the workspace.

test
RegionIdstring

The ID of the region.

cn-hangzhou
FileSystemIdstring

The ID of the NAS file system.

04f314****
FileSystemTypestring

The type of the NAS file system. Valid value: Universal NAS. This value indicates that the NAS file system is a General-purpose one.

standard
FileSystemNamestring

The name of the NAS file system.

testNAS
MeteredSizelong

The used storage of the NAS file system. Unit: byte.

0
MountTargetDomainstring

The domain name of the mount target.

04f314****-at***.cn-hangzhou.nas.aliyuncs.com
Descriptionstring

The description of the NAS file system.

testDescription
ZoneIdstring

The ID of the zone where the NAS file system resides.

cn-hangzhou-f
FileSystemStatusstring

The status of the NAS file system. The possible values include:

  • Pending: The NAS file system is being created.
  • Running: The NAS file system is running.
  • Stopped: The NAS file system is stopped.
  • Deleting: The NAS file system is being deleted.
  • Deleted: The NAS file system is deleted.
  • Invalid: The NAS file system is invalid.
Running
EncryptionEnabledboolean

Indicates whether disk encryption is enabled.

false
ProfileCompatibleboolean

Indicates whether the User Profile Management (UPM) feature is supported.

false
DesktopGroupsobject []

The desktop groups that are associated with the NAS file systems that support the UPM feature.

DesktopGroupIdstring

The ID of the desktop group.

dg-9eeyf15b25nyl****
DesktopGroupNamestring

The name of the desktop group.

test_dg

Examples

Sample success responses

JSONformat

{
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "RequestId": "269BDB16-2CD8-4865-84BD-11C40BC21DB0",
  "FileSystems": [
    {
      "Capacity": 10485760,
      "MountTargetStatus": "Active",
      "CreateTime": "2021-05-10T11:39Z",
      "OfficeSiteId": "cn-hangzhou+dir-363353****",
      "SupportAcl": false,
      "StorageType": "Capacity",
      "OfficeSiteName": "test",
      "RegionId": "cn-hangzhou",
      "FileSystemId": "04f314****",
      "FileSystemType": "standard",
      "FileSystemName": "testNAS",
      "MeteredSize": 0,
      "MountTargetDomain": "04f314****-at***.cn-hangzhou.nas.aliyuncs.com",
      "Description": "testDescription",
      "ZoneId": "cn-hangzhou-f",
      "FileSystemStatus": "Running",
      "EncryptionEnabled": false,
      "ProfileCompatible": false,
      "DesktopGroups": [
        {
          "DesktopGroupId": "dg-9eeyf15b25nyl****",
          "DesktopGroupName": "test_dg"
        }
      ]
    }
  ]
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history