相关参考Reference

    单元管理接口

    列举企业组织根单元

    接口描述

    查看指定的企业组织的根单元信息。当前每个企业组织仅包含一个根单元。

    请求结构

    GET /v1/organization/{organizationId}/root HTTP/1.1
    Host: organization.bj.baidubce.com
    Authorization: authorization string

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    名称 类型 位置 描述 是否必须
    organizationId String URL参数 企业组织ID

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    名称 类型 描述
    units List<OrganizationUnit> 单元的的列表

    请求示例

    GET /v1/organization/{organizationId}/root HTTP/1.1
    Host: organization.bj.baidubce.com
    Authorization: authorization string

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    X-Bce-Request-Id: fc96771d-f2a3-4b1a-8ed2-ea7665461baf
    Server: BWS
    
    {
        "description": "root unit",
        "id": "25fc10b3bc61437aa72b35f76515b375",
        "createTime": "2018-08-29T12:02:23Z",
        "name": "root"
    }

    创建企业组织单元

    接口描述

    创建企业组织单元。

    请求结构

    POST /v1/organization/{organizationId}/unit HTTP/1.1
    Host: organization.bj.baidubce.com
    Authorization: authorization string
    
    {
        "name": "name",
        "description": "description"
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    名称 类型 位置 描述 是否必须
    organizationId String URL参数 企业组织ID
    name String RequestBody参数 企业组织名称
    parentId String RequestBody参数 上级单元的ID,未指定时默认为根单元
    description String RequestBody参数 企业组织描述

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    OrganizationUnit对象

    请求示例

    POST /v1/organization/25fc10b3bc61437aa72b35f76515b375/unit
    host: organization.bj.baidubce.com
    Authorization: AuthorizationString
    
    {"name":"testUnit", "description":"test"}

    响应示例

    HTTP/1.1 201 Created
    Content-Type: application/json;charset=UTF-8
    X-Bce-Request-Id: fc96771d-f2a3-4b1a-8ed2-ea7665461baf
    Server: BWS
    
    {
        "description": "test",
        "id": "a6ed8b858a094187b3e3cb95da73b415",
        "createTime": "2019-09-23T11:55:44Z",
        "name": "testUnit"
    }

    删除企业组织单元

    接口描述

    删除企业组织单元。

    说明:删除单元前需要将全部成员从单元内移除,并解除所有权限策略的关联。

    请求结构

    DELETE /v1/organization/{organizationId}/unit/{unitId} HTTP/1.1
    Host: organization.bj.baidubce.com
    Authorization: authorization string

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    名称 类型 位置 描述 是否必须
    organizationId String URL参数 企业组织ID
    unitId String URL参数 单元ID

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    无。

    请求示例

    DELETE /v1/organization/25fc10b3bc61437aa72b35f76515b375/unit/56071515f49a49a0aea628e80ebebfde
    host: organization.bj.baidubce.com
    Authorization: AuthorizationString

    响应示例

    HTTP/1.1 204 No Content
    Content-Type: application/json;charset=UTF-8
    X-Bce-Request-Id: fc96771d-f2a3-4b1a-8ed2-ea7665461baf
    Server: BWS

    查看企业组织单元

    接口描述

    查看指定的企业组织单元。

    请求结构

    GET /v1/organization/{organizationId}/unit/{unitId} HTTP/1.1
    Host: organization.bj.baidubce.com
    Authorization: authorization string

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    名称 类型 位置 描述 是否必须
    organizationId String URL参数 企业组织ID
    unitId String URL参数 单元ID

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    OrganizationUnit对象

    请求示例

    GET /v1/organization/25fc10b3bc61437aa72b35f76515b375/unit/a6ed8b858a094187b3e3cb95da73b415
    host: organization.bj.baidubce.com
    Authorization: AuthorizationString

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    X-Bce-Request-Id: fc96771d-f2a3-4b1a-8ed2-ea7665461baf
    Server: BWS
    
    {
        "description": "test",
        "id": "a6ed8b858a094187b3e3cb95da73b415",
        "createTime": "2019-09-23T11:55:44Z",
        "name": "testUnit"
    }

    更新企业组织单元

    接口描述

    更新指定的企业组织单元。

    请求结构

    PUT /v1/organization/{organizationId}/unit/{unitId} HTTP/1.1
    Host: organization.bj.baidubce.com
    Authorization: authorization string
    
    {"name":"name", "description":"description"}

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    名称 类型 位置 描述 是否必须
    organizationId String URL参数 企业组织ID
    unitId String URL参数 单元ID
    name String RequestBody参数 企业组织名称
    description String RequestBody参数 企业组织描述

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    OrganizationUnit对象

    请求示例

    PUT /v1/organization/25fc10b3bc61437aa72b35f76515b375/unit/a6ed8b858a094187b3e3cb95da73b415
    host: organization.bj.baidubce.com
    Authorization: AuthorizationString
    
    {"name":"testunit", "description":"test description"}

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    X-Bce-Request-Id: fc96771d-f2a3-4b1a-8ed2-ea7665461baf
    Server: BWS
    
    {
        "description": "test description",
        "id": "a6ed8b858a094187b3e3cb95da73b415",
        "createTime": "2019-09-23T11:55:44Z",
        "name": "testunit"
    }

    列举单元账户

    接口描述

    列举指定企业组织单元中的成员账户,不包括子单元的成员。

    请求结构

    GET /v1/organization/{organizationId}/unit/{unitId}/account HTTP/1.1
    Host: organization.bj.baidubce.com
    Authorization: authorization string

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    名称 类型 位置 描述 是否必须
    organizationId String URL参数 企业组织ID
    unitId String URL参数 单元ID

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    名称 类型 描述
    accounts List<Account> 账户的的列表

    请求示例

    GET /v1/organization/25fc10b3bc61437aa72b35f76515b375/unit/25fc10b3bc61437aa72b35f76515b375/account
    host: organization.bj.baidubce.com
    Authorization: AuthorizationString

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    X-Bce-Request-Id: fc96771d-f2a3-4b1a-8ed2-ea7665461baf
    Server: BWS
    
    [
        {
            "mobile": "+86********243", 
            "status": "ACTIVE", 
            "description": "", 
            "id": "a7409103bba94b0c8edf446a22c72bf7", 
            "name": "bceaccount123"
        }, 
        {
            "mobile": "+86********243", 
            "status": "ACTIVE", 
            "description": "test organization account", 
            "id": "bfdbd1e6316b4729ab49f2cb25710068", 
            "name": "accountasdx"
        }
    ]

    列举单元子单元

    接口描述

    列举指定企业组织单元中的成员子单元,不包括子单元的成员。

    请求结构

    GET /v1/organization/{organizationId}/unit/{unitId}/unit HTTP/1.1
    Host: organization.bj.baidubce.com
    Authorization: authorization string

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    名称 类型 位置 描述 是否必须
    organizationId String URL参数 企业组织ID
    unitId String URL参数 单元ID

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    名称 类型 描述
    units List<OrganizationUnit> 单元的的列表

    请求示例

    GET /v1/organization/25fc10b3bc61437aa72b35f76515b375/unit/25fc10b3bc61437aa72b35f76515b375/unit
    host: organization.bj.baidubce.com
    Authorization: AuthorizationString

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    X-Bce-Request-Id: fc96771d-f2a3-4b1a-8ed2-ea7665461baf
    Server: BWS
    
    [
        {
            "description": "test description", 
            "id": "a6ed8b858a094187b3e3cb95da73b415", 
            "createTime": "2019-09-23T11:55:44Z", 
            "name": "testunit"
        }
    ]

    列举单元上级

    接口描述

    列举指定企业组织单元的直接上级。

    请求结构

    GET /v1/organization/{organizationId}/unit/{unitId}/parent HTTP/1.1
    Host: organization.bj.baidubce.com
    Authorization: authorization string

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    名称 类型 位置 描述 是否必须
    organizationId String URL参数 企业组织ID
    unitId String URL参数 单元ID

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    OrganizationUnit对象

    请求示例

    GET /v1/organization/25fc10b3bc61437aa72b35f76515b375/unit/a6ed8b858a094187b3e3cb95da73b415/parent
    host: organization.bj.baidubce.com
    Authorization: AuthorizationString

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    X-Bce-Request-Id: fc96771d-f2a3-4b1a-8ed2-ea7665461baf
    Server: BWS
    
    {
        "description": "root unit", 
        "id": "25fc10b3bc61437aa72b35f76515b375", 
        "createTime": "2018-08-29T12:02:23Z", 
        "name": "root"
    }

    列举账户上级

    接口描述

    列举指定账户的直接上级。

    请求结构

    GET /v1/organization/{organizationId}/account/{accountId}/parent HTTP/1.1
    Host: organization.bj.baidubce.com
    Authorization: authorization string

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    名称 类型 位置 描述 是否必须
    organizationId String URL参数 企业组织ID
    accountId String URL参数 账户ID

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    OrganizationUnit对象

    请求示例

    GET /v1/organization/25fc10b3bc61437aa72b35f76515b375/account/bfdbd1e6316b4729ab49f2cb25710068/parent
    host: organization.bj.baidubce.com
    Authorization: AuthorizationString

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    X-Bce-Request-Id: fc96771d-f2a3-4b1a-8ed2-ea7665461baf
    Server: BWS
    
    {
        "description": "root unit", 
        "id": "25fc10b3bc61437aa72b35f76515b375", 
        "createTime": "2018-08-29T12:02:23Z", 
        "name": "root"
    }

    移动账户

    接口描述

    将指定的账户,从原有单元移动到新的单元(或根单元)。

    请求结构

    PUT /v1/organization/{organizationId}/account/{accountId}?parent HTTP/1.1
    Host: organization.bj.baidubce.com
    Authorization: authorization string
    
    {
        "sourceUnitId": "source unit id", 
        "destinationUnitId": "destination unit id"
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    名称 类型 位置 描述 是否必须
    organizationId String URL参数 企业组织ID
    accountId String URL参数 账户ID
    sourceUnitId String RequestBody参数 原有父单元ID
    destinationUnitId String RequestBody参数 新的父单元ID

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    OrganizationUnit对象,新的父单元信息。

    请求示例

    PUT /v1/organization/25fc10b3bc61437aa72b35f76515b375/account/bfdbd1e6316b4729ab49f2cb25710068?parent
    host: organization.bj.baidubce.com
    Authorization: AuthorizationString

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    X-Bce-Request-Id: fc96771d-f2a3-4b1a-8ed2-ea7665461baf
    Server: BWS
    
    {
        "description": "test description", 
        "id": "a6ed8b858a094187b3e3cb95da73b415", 
        "createTime": "2019-09-23T11:55:44Z", 
        "name": "testunit"
    }
    上一篇
    邀请管理接口
    下一篇
    策略管理接口