You need to enable JavaScript to run this app.
导航
ListOrganizationalUnits - 获取企业组织所有单元列表
最近更新时间:2025.02.06 22:26:30首次发布时间:2024.01.11 17:42:36

获取企业组织所有单元列表

注意事项

最多返回 500 条记录,本接口不再维护,建议使用 2022-01-01 版本的 ListOrganizationalUnitsForParent 接口。

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

参数
类型
是否必填
示例值
描述
Action
String

ListOrganizationalUnits

要执行的操作,取值:ListOrganizationalUnits。

Version
String

2022-01-01

API的版本,取值:2022-01-01。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数
类型
示例值
描述
SubUnitList
Array of Object

"SubUnitList": [
{
"ID": "uuXUSAwQdmZ",
"CreatedTime": "aaxs",
"UpdatedTime": "R9gCri3E",
"DeletedTime": "8LQd",
"Owner": "Z6wxMsnUq81",
"OrgID": "8I0f2AIlNOJ",
"OrgType": 474,
"ParentID": "gk",
"Depth": 375,
"Name": "WF4i",
"Description": "B3vZTqZA",
"DeleteUk": "d5YG"
}
]

单元列表详情

请求示例

POST /?Action=ListOrganizationalUnits&Version=2022-01-01 HTTP/1.1
Host: open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20250206T084420Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250206/cn-beijing/organization/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202502061644321500131610778D8DDB",
    "Action": "ListOrganizationalUnits",
    "Version": "2022-01-01",
    "Service": "organization",
    "Region": "cn-beijing"
  },
  "Result": {
    "SubUnitList": [
      {
        "ID": "uuXUSAwQdmZ",
        "CreatedTime": "aaxs",
        "UpdatedTime": "R9gCri3E",
        "DeletedTime": "8LQd",
        "Owner": "Z6wxMsnUq81",
        "OrgID": "8I0f2AIlNOJ",
        "OrgType": 474,
        "ParentID": "gk",
        "Depth": 375,
        "Name": "WF4i",
        "Description": "B3vZTqZA"
      }
    ]
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
400
InvalidParam

The parameter %v[%v] is invalid.

参数不合法

400
PermissionError

No permission to perform action[%s] on resource %s

无权限,没有对该资源进行该操作的权限

500
InternalError

Unknown internal error: %v

未知错误,根据错误信息判断详情