全部產品
Search
文件中心

Cloud Parallel File Storage:DescribeAccessGroups

更新時間:Jun 25, 2026

查詢權限組資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

nas:DescribeAccessGroups

list

*AccessGroup

acs:nas:{#regionId}:{#accountId}:accessgroup/{#accessgroupName}

請求參數

名稱

類型

必填

描述

樣本值

AccessGroupName

string

權限組名稱。

限制:

  • 長度為 3~64 個字元。

  • 必須以大小寫字母開頭,可以包含英文字母、數字、底線(_)或短橫線(-)。

DEFAULT_VPC_GROUP_NAME

PageSize

integer

每個分頁包含的權限組個數。

取值範圍:1~100。

預設值:10。

2

PageNumber

integer

清單的分頁頁碼。

起始值(預設值):1。

1

UseUTCDateTime

boolean

指定傳回的時間是否依照 UTC 標準格式表示。

取值:

  • true(預設值):傳回的時間為 UTC 標準格式。

  • false:傳回的時間為非 UTC 標準格式。

true

FileSystemType

string

檔案系統類型。

取值:

  • standard(預設值):通用型 NAS。

  • extreme:極速型 NAS。

  • cpfs:CPFS。

枚舉值:

  • standard :

    通用型 NAS

  • cpfs :

    檔案儲存 CPFS

  • extreme :

    極速型 NAS

standard

返回參數

名稱

類型

描述

樣本值

object

AccessGroups

object

AccessGroup

array<object>

權限組資訊集合。

object

AccessGroupName

string

權限組名稱。

DEFAULT_VPC_GROUP_NAME

Description

string

權限組描述資訊。

This is a test access group.

CreateTime

string

權限組的建立時間。

依照 ISO8601 標準表示,傳回格式:yyyy-MM-ddTHH:mm:ssZ。

2020-01-05T16:00:00Z

AccessGroupType

string

權限組類型。取值為 Vpc,表示專有網路。

Vpc

RuleCount

integer

此權限組中包含的權限組規則數量。

0

MountTargetCount

integer

套用此權限組的掛載點數量。

0

FileSystemType

string

檔案系統類型。

取值:

  • standard(預設值):通用型 NAS。

  • extreme:極速型 NAS。

  • cpfs:CPFS。

standard

RegionId

string

地域 ID。

cn-hangzhou

TotalCount

integer

權限組的總個數。

1

RequestId

string

請求 ID。

2514F97E-FFF0-4A1F-BF04-729CEAC6****

PageSize

integer

每個分頁包含的權限組個數。

2

PageNumber

integer

清單的分頁頁碼。

1

樣本

正常返回樣本

JSON格式

{
  "AccessGroups": {
    "AccessGroup": [
      {
        "AccessGroupName": "DEFAULT_VPC_GROUP_NAME",
        "Description": "This is a test access group.",
        "CreateTime": "2020-01-05T16:00:00Z",
        "AccessGroupType": "Vpc",
        "RuleCount": 0,
        "MountTargetCount": 0,
        "FileSystemType": "standard",
        "RegionId": "cn-hangzhou"
      }
    ]
  },
  "TotalCount": 1,
  "RequestId": "2514F97E-FFF0-4A1F-BF04-729CEAC6****",
  "PageSize": 2,
  "PageNumber": 1
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情