¶ 修改顶层组织机构
更新时间: 2025-08-20 12:33:28
通过组织 code,修改顶层组织机构,可以选择部门描述、新组织 code、组织名称等。
¶ 请求参数
| 名称 | 类型 | 必填 | 默认值 | 描述 | 示例值 | 
|---|---|---|---|---|---|
| organizationCode | string | 是 | - | 组织 code。 | steamory | 
| description | string | 否 | - | 部门描述。 | 技术研发部门 | 
| openDepartmentId | string | 否 | - | 根节点自定义 ID。 | 60b49eb83fd80adb96f26e68 | 
| leaderUserIds | string[] | 否 | - | 部门负责人 ID。 | ["60b49eb83fd80adb96f26e68"] | 
| i18n | OrganizationNameI18nDto | 否 | - | 多语言设置。 | {"organizationName":{"zh-CN":{"enabled":false,"value":"中文"},"en-US":{"enabled":false,"value":"English"}}} | 
| organizationNewCode | string | 否 | - | 新组织 code。 | steamory2 | 
| organizationName | string | 否 | - | 组织名称。 | 蒸汽记忆 | 
¶ 示例代码
using Authing.CSharp.SDK.Models;
using Authing.CSharp.SDK.Services;
using Authing.CSharp.SDK.Utils;
using Authing.CSharp.SDK.UtilsImpl;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
namespace Example
{
    class Program
    {
      private static ManagementClientOptions options;
      private static string ACCESS_Key_ID = "AUTHING_USERPOOL_ID";
      private static string ACCESS_KEY_SECRET = "AUTHING_USERPOOL_SECRET";
      static void Main(string[] args)
      {
          MainAsync().GetAwaiter().GetResult();
      }
      private static async Task MainAsync()
      {
          options = new ManagementClientOptions()
          {
              AccessKeyId = ACCESS_Key_ID,
              AccessKeySecret = ACCESS_KEY_SECRET,
          };
          ManagementClient managementClient = new ManagementClient(options);
        
          OrganizationSingleRespDto  result = await managementClient.UpdateOrganization
          (  new UpdateOrganizationReqDto{                  OrganizationCode= "steamory" ,
                  Description= "技术研发部门" ,
                  OpenDepartmentId= "60b49eb83fd80adb96f26e68" ,
                  LeaderUserIds= new List<string>{"60b49eb83fd80adb96f26e68",} ,
                I18n= new OrganizationNameI18nDto
                {
                        OrganizationName= new LangObject
                {
                        Zh-CN= new LangUnit
                {
                          Enabled= false ,
          Value= false ,
        },
        En-US= new LangUnit
                {
                          Enabled= false ,
          Value= false ,
        },
        },
        },
                  OrganizationNewCode= "steamory2" ,
                  OrganizationName= "蒸汽记忆" ,
            }
          );
        }
    }
}
¶ 请求响应
类型: OrganizationSingleRespDto
| 名称 | 类型 | 描述 | 
|---|---|---|
| statusCode | number | 业务状态码,可以通过此状态码判断操作是否成功,200 表示成功。 | 
| message | string | 描述信息 | 
| apiCode | number | 细分错误码,可通过此错误码得到具体的错误类型。 | 
| data | OrganizationDto | 响应数据 | 
示例结果:
{
  "statusCode": 200,
  "message": "操作成功",
  "apiCode": 20001,
  "data": {
    "organizationCode": "steamory",
    "organizationName": "蒸汽记忆",
    "description": "组织描述信息",
    "departmentId": "60b49eb83fd80adb96f26e68",
    "openDepartmentId": "60b49eb83fd80adb96f26e68",
    "hasChildren": true,
    "leaderUserIds": "[\"60b49eb83fd80adb96f26e68\"]",
    "membersCount": 150,
    "i18n": {
      "organizationName": {
        "zh-CN": {
          "enabled": false,
          "value": "中文"
        },
        "en-US": {
          "enabled": false,
          "value": "English"
        }
      }
    }
  }
}
¶ 数据结构
¶ OrganizationNameI18nDto
| 名称 | 类型 | 必填 | 描述 | 
|---|---|---|---|
| organizationName | 是 | 支持多语言的字段。嵌套类型:LangObject。 示例值: [object Object] | 
¶ LangObject
| 名称 | 类型 | 必填 | 描述 | 
|---|---|---|---|
| zh-CN | 是 | 多语言的中文内容。嵌套类型:LangUnit。 示例值: [object Object] | |
| en-US | 是 | 多语言的英文内容。嵌套类型:LangUnit。 示例值: [object Object] | 
¶ LangUnit
| 名称 | 类型 | 必填 | 描述 | 
|---|---|---|---|
| enabled | boolean | 是 | 是否已开启。若开启,且控制台选择该语言,则展示该内容。(默认关闭)。 | 
| value | boolean | 是 | 多语言内容。 | 
¶ OrganizationDto
| 名称 | 类型 | 必填 | 描述 | 
|---|---|---|---|
| organizationCode | string | 是 | 组织 code。 示例值: steamory | 
| organizationName | string | 是 | 组织名称。 示例值: 蒸汽记忆 | 
| description | string | 否 | 组织描述信息。 示例值: 组织描述信息 | 
| departmentId | string | 是 | 根节点 ID。 示例值: 60b49eb83fd80adb96f26e68 | 
| openDepartmentId | string | 否 | 根节点自定义 ID。 示例值: 60b49eb83fd80adb96f26e68 | 
| hasChildren | boolean | 是 | 是否包含子节点。 示例值: true | 
| leaderUserIds | array | 否 | 部门负责人 ID。 示例值: ["60b49eb83fd80adb96f26e68"] | 
| membersCount | number | 是 | 部门人数。 示例值: 150 | 
| isVirtualNode | boolean | 是 | 是否是虚拟部门。 | 
| i18n | 否 | 多语言设置。嵌套类型:OrganizationNameI18nDto。 示例值: [object Object] | 
¶ OrganizationNameI18nDto
| 名称 | 类型 | 必填 | 描述 | 
|---|---|---|---|
| organizationName | 是 | 支持多语言的字段。嵌套类型:LangObject。 示例值: [object Object] | 
¶ LangObject
| 名称 | 类型 | 必填 | 描述 | 
|---|---|---|---|
| zh-CN | 是 | 多语言的中文内容。嵌套类型:LangUnit。 示例值: [object Object] | |
| en-US | 是 | 多语言的英文内容。嵌套类型:LangUnit。 示例值: [object Object] | 
¶ LangUnit
| 名称 | 类型 | 必填 | 描述 | 
|---|---|---|---|
| enabled | boolean | 是 | 是否已开启。若开启,且控制台选择该语言,则展示该内容。(默认关闭)。 | 
| value | boolean | 是 | 多语言内容。 |