获取ZIAM批量资源

对资源集合执行非原子批量创建、更新、删除或状态操作。

POST/api/v1/ziam/resources/{collection}/batch

操作 ID

ZiamBatchResources

起始版本

1.0.0

执行模式

同步

认证信息

需要认证

认证信息

调用该 API 时需要在请求头中携带以下认证信息。

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

application/json

请求体字段

operation
String必填
操作。
示例： disable
items
List必填
条目列表。
示例： (nested array)
- uuid
  String
  资源的UUID，唯一标识该资源。
  示例： 11111111111111111111111111111111
- data
  Object
  返回数据。详情参考 `data`。
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： 11111111111111111111111111111111
  name
  String
  资源名称。
  示例： alice
  userName
  String
  用户名称。
  示例： alice
  displayName
  String
  显示名称。用于界面展示。
  示例： Alice
  description
  String
  资源的详细描述。
  示例： A brief description
  password
  String
  密码。
  示例： password123
  confirmPassword
  String
  确认密码。
  示例： password123
  email
  String
  邮箱地址。
  示例： alice@example.com
  phone
  String
  联系电话。
  示例： +8613800138000
  phoneNumber
  String
  电话数量。
  示例： +8613800138000
  mobile
  String
  手机。
  示例： +8613800138000
  source
  String
  来源信息。
  示例： ZIAM
  status
  String
  状态信息。
  示例： Enabled
  credentialStatus
  Object
  资源。
  type
  String
  类型。
  示例： password
  algorithm
  String
  密码验证器算法已使用内部ZIAM。
  示例： argon2id
  version
  Long
  版本号。
  示例： 1
  status
  String
  状态信息。
  示例： Active
  mustChange
  Boolean
  变更。
  示例： false
  createdAt
  String
  创建时间。
  示例： 2026-06-17T01:00:00Z
  updatedAt
  String
  更新时间。
  示例： 2026-06-17T01:00:00Z
  createdAt
  String
  创建时间。
  示例： 2026-06-16T10:00:00Z
  updatedAt
  String
  更新时间。
  示例： 2026-06-16T10:30:00Z
  lastLoginTime
  String
  最后登录时间。
  示例： 2026-06-16T10:00:00Z
  lastLoginIp
  String
  最后登录IP。
  示例： 172.26.53.126
  groups
  List
  用户组列表。
  示例： (nested array)
  id
  String
  资源ID。
  示例： group-001
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： group-001
  source
  String
  来源信息。
  示例： ZIAM
  ziamGroupId
  String
  ZIAM组ID。
  示例： group-001
  name
  String必填
  资源名称。
  示例： Operators
  displayName
  String
  显示名称。用于界面展示。
  示例： Operators
  description
  String
  资源的详细描述。
  示例： A brief description
  projectId
  String
  可选项目ID拥有组。
  示例： project-001
  projectUuid
  String
  资源。
  示例： project-001
  enabled
  Boolean
  是否启用。
  示例： true
  active
  Boolean
  资源。
  示例： true
  members
  List
  成员列表。
  示例： (nested array)
  value
  String
  字段值。
  示例： 11111111111111111111111111111111
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： 11111111111111111111111111111111
  display
  String
  资源。
  示例： Alice
  joinedAt
  String
  加入时间。
  示例： 2026-06-16T10:00:00Z
  attributes
  Object
  资源。
  示例： (nested object)
  resourceVersion
  Long
  单调递增版本已使用下游同步。
  示例： 10
  status
  String
  状态信息。
  示例： Enabled
  createdAt
  String
  创建时间。
  示例： 2026-01-15T08:00:00Z
  updatedAt
  String
  更新时间。
  示例： 2026-01-15T08:00:00Z
  userCount
  Long
  用户数量。
  示例： 1
  directUserCount
  Long
  数量直接用户成员。
  示例： 1
  projects
  List
  相关组。
  示例： (nested array)
  id
  String
  资源ID。
  示例： project-001
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： project-001
  source
  String
  来源信息。
  示例： ZIAM
  ziamProjectId
  String
  ZIAM项目ID。
  示例： project-001
  name
  String必填
  资源名称。
  示例： Project A
  displayName
  String
  显示名称。用于界面展示。
  示例： Project A
  description
  String
  资源的详细描述。
  示例： A brief description
  organizationId
  String
  组织ID。
  示例： dept-001
  organizationUuid
  String
  资源。
  示例： dept-001
  tenantId
  String
  租户ID。
  示例： tenant-001
  tenantUuid
  String
  租户UUID。
  示例： tenant-001
  accountId
  String
  可选下游账户ID。
  示例： account-001
  accountUuid
  String
  资源。
  示例： account-001
  linkAccountUuid
  String
  可选云项目关联账户UUID。
  示例： account-001
  enabled
  Boolean
  是否启用。
  示例： true
  active
  Boolean
  资源。
  示例： true
  attributes
  Object
  资源。
  示例： (nested object)
  resourceVersion
  Long
  单调递增版本已使用下游同步。
  示例： 10
  status
  String
  状态信息。
  示例： Enabled
  createdAt
  String
  创建时间。
  示例： 2026-01-15T08:00:00Z
  updatedAt
  String
  更新时间。
  示例： 2026-01-15T08:00:00Z
  userCount
  Long
  用户数量。
  示例： 1
  directUserCount
  Long
  直接用户数量。
  示例： 1
  groupCount
  Long
  数量用户组项目。
  示例： 1
  userGroupCount
  Long
  数量用户组项目。
  示例： 1
  joinedAt
  String
  加入时间。
  示例： 2026-01-15T08:00:00Z
  projectNames
  List
  名称项目相关组。
  示例： item1,item2
  projectCount
  Long
  数量项目相关组。
  示例： 1
  joinedAt
  String
  加入时间。
  示例： 2026-01-15T08:00:00Z
  groupNames
  List
  组名称。
  示例： item1,item2
  groupCount
  Long
  组数量。
  示例： 1
  organizations
  List
  组织。
  示例： (nested array)
  id
  String
  资源ID。
  示例： dept-001
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： dept-001
  source
  String
  来源信息。
  示例： ZIAM
  ziamDepartmentId
  String
  ZIAM部门ID。
  示例： dept-001
  name
  String必填
  资源名称。
  示例： Engineering
  displayName
  String
  显示名称。用于界面展示。
  示例： Engineering
  description
  String
  资源的详细描述。
  示例： A brief description
  parentId
  String
  父项组织ID。
  示例： company-001
  parentUuid
  String
  父级资源UUID。
  示例： company-001
  rootId
  String
  可选根组织ID。
  示例： company-001
  rootUuid
  String
  根部门UUID。为空时返回全量树。
  示例： company-001
  type
  String
  类型。
  示例： Department
  enabled
  Boolean
  是否启用。
  示例： true
  active
  Boolean
  可选已启用标志已接受SCIM接收器。
  示例： true
  members
  List
  成员列表。
  示例： (nested array)
  value
  String
  字段值。
  示例： 11111111111111111111111111111111
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： 11111111111111111111111111111111
  display
  String
  资源。
  示例： Alice
  joinedAt
  String
  加入时间。
  示例： 2026-06-16T10:00:00Z
  attributes
  Object
  资源。
  示例： (nested object)
  resourceVersion
  Long
  单调递增版本已使用下游同步。
  示例： 10
  status
  String
  状态信息。
  示例： Enabled
  createdAt
  String
  创建时间。
  示例： 2026-01-15T08:00:00Z
  updatedAt
  String
  更新时间。
  示例： 2026-01-15T08:00:00Z
  ownerUuid
  String
  组织负责人用户UUID已配置。
  示例： 11111111111111111111111111111111
  ownerName
  String
  负责人名称。
  示例： Alice
  departmentPath
  String
  部门路径。
  示例： Company/Engineering
  departmentPathNames
  List
  组织树显示路径单独名称。
  示例： item1,item2
  directUserCount
  Long
  数量直接用户成员。
  示例： 1
  totalUserCount
  Long
  总用户数量。
  示例： 10
  joinedAt
  String
  加入时间。
  示例： 2026-01-15T08:00:00Z
  directOrganizations
  List
  用户列表显示聚合直接部门成员关系。
  示例： (nested array)
  id
  String
  资源ID。
  示例： dept-001
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： dept-001
  source
  String
  来源信息。
  示例： ZIAM
  ziamDepartmentId
  String
  ZIAM部门ID。
  示例： dept-001
  name
  String必填
  资源名称。
  示例： Engineering
  displayName
  String
  显示名称。用于界面展示。
  示例： Engineering
  description
  String
  资源的详细描述。
  示例： A brief description
  parentId
  String
  父项组织ID。
  示例： company-001
  parentUuid
  String
  父级资源UUID。
  示例： company-001
  rootId
  String
  可选根组织ID。
  示例： company-001
  rootUuid
  String
  根部门UUID。为空时返回全量树。
  示例： company-001
  type
  String
  类型。
  示例： Department
  enabled
  Boolean
  是否启用。
  示例： true
  active
  Boolean
  可选已启用标志已接受SCIM接收器。
  示例： true
  members
  List
  成员列表。
  示例： (nested array)
  value
  String
  字段值。
  示例： 11111111111111111111111111111111
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： 11111111111111111111111111111111
  display
  String
  资源。
  示例： Alice
  joinedAt
  String
  加入时间。
  示例： 2026-06-16T10:00:00Z
  attributes
  Object
  资源。
  示例： (nested object)
  resourceVersion
  Long
  单调递增版本已使用下游同步。
  示例： 10
  status
  String
  状态信息。
  示例： Enabled
  createdAt
  String
  创建时间。
  示例： 2026-01-15T08:00:00Z
  updatedAt
  String
  更新时间。
  示例： 2026-01-15T08:00:00Z
  ownerUuid
  String
  组织负责人用户UUID已配置。
  示例： 11111111111111111111111111111111
  ownerName
  String
  负责人名称。
  示例： Alice
  departmentPath
  String
  部门路径。
  示例： Company/Engineering
  departmentPathNames
  List
  组织树显示路径单独名称。
  示例： item1,item2
  directUserCount
  Long
  数量直接用户成员。
  示例： 1
  totalUserCount
  Long
  总用户数量。
  示例： 10
  joinedAt
  String
  加入时间。
  示例： 2026-01-15T08:00:00Z
  organizationNames
  List
  显示聚合相关组织名称。
  示例： item1,item2
  departmentNames
  List
  显示聚合相关部门名称。
  示例： item1,item2
  directOrganizationCount
  Long
  显示聚合数量直接部门。
  示例： 1
  projects
  List
  项目。
  示例： (nested array)
  id
  String
  资源ID。
  示例： project-001
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： project-001
  source
  String
  来源信息。
  示例： ZIAM
  ziamProjectId
  String
  ZIAM项目ID。
  示例： project-001
  name
  String必填
  资源名称。
  示例： Project A
  displayName
  String
  显示名称。用于界面展示。
  示例： Project A
  description
  String
  资源的详细描述。
  示例： A brief description
  organizationId
  String
  组织ID。
  示例： dept-001
  organizationUuid
  String
  资源。
  示例： dept-001
  tenantId
  String
  租户ID。
  示例： tenant-001
  tenantUuid
  String
  租户UUID。
  示例： tenant-001
  accountId
  String
  可选下游账户ID。
  示例： account-001
  accountUuid
  String
  资源。
  示例： account-001
  linkAccountUuid
  String
  可选云项目关联账户UUID。
  示例： account-001
  enabled
  Boolean
  是否启用。
  示例： true
  active
  Boolean
  资源。
  示例： true
  attributes
  Object
  资源。
  示例： (nested object)
  resourceVersion
  Long
  单调递增版本已使用下游同步。
  示例： 10
  status
  String
  状态信息。
  示例： Enabled
  createdAt
  String
  创建时间。
  示例： 2026-01-15T08:00:00Z
  updatedAt
  String
  更新时间。
  示例： 2026-01-15T08:00:00Z
  userCount
  Long
  用户数量。
  示例： 1
  directUserCount
  Long
  直接用户数量。
  示例： 1
  groupCount
  Long
  数量用户组项目。
  示例： 1
  userGroupCount
  Long
  数量用户组项目。
  示例： 1
  joinedAt
  String
  加入时间。
  示例： 2026-01-15T08:00:00Z
  projectNames
  List
  显示聚合相关项目名称。
  示例： item1,item2
  projectCount
  Long
  显示聚合数量相关项目。
  示例： 1
  userCount
  Long
  用户数量。
  示例： 1
  directUserCount
  Long
  显示聚合数量直接用户成员。
  示例： 1
  userGroupCount
  Long
  用户组数量。
  示例： 1
  ownerUuid
  String
  组织负责人用户UUID已配置。
  示例： 11111111111111111111111111111111
  ownerName
  String
  负责人名称。
  示例： Alice
  departmentPath
  String
  部门路径。
  示例： Company/Engineering
  departmentPathNames
  List
  组织树显示路径单独名称。
  示例： item1,item2
  totalUserCount
  Long
  总用户数量。
  示例： 10
  groupUuids
  List
  组UUID。
  示例： item1,item2
  projectUuids
  List
  项目UUID。
  示例： item1,item2
  organizationUuids
  List
  组织UUID。
  示例： item1,item2
  departmentUuids
  List
  部门UUID。
  示例： item1,item2
  joinedAt
  String
  加入时间。
  示例： 2026-01-15T08:00:00Z
  deletionTimestamp
  String
  软删除时间戳已删除用户。
  示例： 2026-01-15T08:00:00Z
  deletionPhase
  String
  软已删除用户。
  示例： SoftDeleted
  retentionUntil
  String
  保留截止。
  示例： 2026-01-15T08:00:00Z
  finalizers
  List
  删除终结器应用软已删除用户。
  示例： item1,item2
- lockedUntil
  String
  已锁定截止。
  示例： 2026-06-17T00:00:00Z

响应状态

200 OK

该 API 成功时返回以下响应结构。

status
String
状态信息。
示例： ok
data
Object
返回数据。
- operation
  String
  操作。
  示例： disable
- atomic
  Boolean
  原子。
  示例： false
- total
  Integer
  返回结果总数。
  示例： 2
- succeeded
  Integer
  是否成功。
  示例： 1
- failed
  Integer
  失败数量。
  示例： 1
- results
  List
  结果列表。
  示例： (nested array)
  index
  Integer
  条目索引请求。
  示例： 1
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： 11111111111111111111111111111111
  status
  String
  状态信息。
  示例： ok
  msg
  String
  错误消息状态错误。
  示例： uuid is required
  data
  Object
  返回数据。
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： 11111111111111111111111111111111
  name
  String
  资源名称。
  示例： alice
  userName
  String
  用户名称。
  示例： alice
  displayName
  String
  显示名称。用于界面展示。
  示例： Alice
  description
  String
  资源的详细描述。
  示例： A brief description
  password
  String
  密码。
  示例： password123
  confirmPassword
  String
  确认密码。
  示例： password123
  email
  String
  邮箱地址。
  示例： alice@example.com
  phone
  String
  联系电话。
  示例： +8613800138000
  phoneNumber
  String
  电话数量。
  示例： +8613800138000
  mobile
  String
  手机。
  示例： +8613800138000
  source
  String
  来源信息。
  示例： ZIAM
  status
  String
  状态信息。
  示例： Enabled
  credentialStatus
  Object
  资源。
  type
  String
  类型。
  示例： password
  algorithm
  String
  密码验证器算法已使用内部ZIAM。
  示例： argon2id
  version
  Long
  版本号。
  示例： 1
  status
  String
  状态信息。
  示例： Active
  mustChange
  Boolean
  变更。
  示例： false
  createdAt
  String
  创建时间。
  示例： 2026-06-17T01:00:00Z
  updatedAt
  String
  更新时间。
  示例： 2026-06-17T01:00:00Z
  createdAt
  String
  创建时间。
  示例： 2026-06-16T10:00:00Z
  updatedAt
  String
  更新时间。
  示例： 2026-06-16T10:30:00Z
  lastLoginTime
  String
  最近一次登录时间。
  示例： 2026-06-16T10:00:00Z
  lastLoginIp
  String
  最近一次登录IP。
  示例： 172.26.53.126
  groups
  List
  用户组列表。
  示例： (nested array)
  id
  String
  资源ID。
  示例： group-001
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： group-001
  source
  String
  来源信息。
  示例： ZIAM
  ziamGroupId
  String
  ZIAM组ID。
  示例： group-001
  name
  String必填
  资源名称。
  示例： Operators
  displayName
  String
  显示名称。用于界面展示。
  示例： Operators
  description
  String
  资源的详细描述。
  示例： A brief description
  projectId
  String
  可选项目ID拥有组。
  示例： project-001
  projectUuid
  String
  资源。
  示例： project-001
  enabled
  Boolean
  是否启用。
  示例： true
  active
  Boolean
  资源。
  示例： true
  members
  List
  成员列表。
  示例： (nested array)
  value
  String
  字段值。
  示例： 11111111111111111111111111111111
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： 11111111111111111111111111111111
  display
  String
  资源。
  示例： Alice
  joinedAt
  String
  加入时间。
  示例： 2026-06-16T10:00:00Z
  attributes
  Object
  资源。
  示例： (nested object)
  resourceVersion
  Long
  单调递增版本已使用下游同步。
  示例： 10
  status
  String
  状态信息。
  示例： Enabled
  createdAt
  String
  创建时间。
  示例： 2026-01-15T08:00:00Z
  updatedAt
  String
  更新时间。
  示例： 2026-01-15T08:00:00Z
  userCount
  Long
  用户数量。
  示例： 1
  directUserCount
  Long
  直接用户数量。
  示例： 1
  projects
  List
  相关组。
  示例： (nested array)
  id
  String
  资源ID。
  示例： project-001
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： project-001
  source
  String
  来源信息。
  示例： ZIAM
  ziamProjectId
  String
  ZIAM项目ID。
  示例： project-001
  name
  String必填
  资源名称。
  示例： Project A
  displayName
  String
  显示名称。用于界面展示。
  示例： Project A
  description
  String
  资源的详细描述。
  示例： A brief description
  organizationId
  String
  组织ID。
  示例： dept-001
  organizationUuid
  String
  资源。
  示例： dept-001
  tenantId
  String
  租户ID。
  示例： tenant-001
  tenantUuid
  String
  租户UUID。
  示例： tenant-001
  accountId
  String
  可选下游账户ID。
  示例： account-001
  accountUuid
  String
  资源。
  示例： account-001
  linkAccountUuid
  String
  可选云项目关联账户UUID。
  示例： account-001
  enabled
  Boolean
  是否启用。
  示例： true
  active
  Boolean
  资源。
  示例： true
  attributes
  Object
  资源。
  示例： (nested object)
  resourceVersion
  Long
  单调递增版本已使用下游同步。
  示例： 10
  status
  String
  状态信息。
  示例： Enabled
  createdAt
  String
  创建时间。
  示例： 2026-01-15T08:00:00Z
  updatedAt
  String
  更新时间。
  示例： 2026-01-15T08:00:00Z
  userCount
  Long
  用户数量。
  示例： 1
  directUserCount
  Long
  直接用户数量。
  示例： 1
  groupCount
  Long
  组数量。
  示例： 1
  userGroupCount
  Long
  用户组数量。
  示例： 1
  joinedAt
  String
  加入时间。
  示例： 2026-01-15T08:00:00Z
  projectNames
  List
  名称项目相关组。
  示例： item1,item2
  projectCount
  Long
  项目数量。
  示例： 1
  joinedAt
  String
  加入时间。
  示例： 2026-01-15T08:00:00Z
  groupNames
  List
  组名称。
  示例： item1,item2
  groupCount
  Long
  组数量。
  示例： 1
  organizations
  List
  组织。
  示例： (nested array)
  id
  String
  资源ID。
  示例： dept-001
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： dept-001
  source
  String
  来源信息。
  示例： ZIAM
  ziamDepartmentId
  String
  ZIAM部门ID。
  示例： dept-001
  name
  String必填
  资源名称。
  示例： Engineering
  displayName
  String
  显示名称。用于界面展示。
  示例： Engineering
  description
  String
  资源的详细描述。
  示例： A brief description
  parentId
  String
  父项组织ID。
  示例： company-001
  parentUuid
  String
  父级资源UUID。
  示例： company-001
  rootId
  String
  可选根组织ID。
  示例： company-001
  rootUuid
  String
  根部门UUID。为空时返回全量树。
  示例： company-001
  type
  String
  类型。
  示例： Department
  enabled
  Boolean
  是否启用。
  示例： true
  active
  Boolean
  可选已启用标志已接受SCIM接收器。
  示例： true
  members
  List
  成员列表。
  示例： (nested array)
  value
  String
  字段值。
  示例： 11111111111111111111111111111111
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： 11111111111111111111111111111111
  display
  String
  资源。
  示例： Alice
  joinedAt
  String
  加入时间。
  示例： 2026-06-16T10:00:00Z
  attributes
  Object
  资源。
  示例： (nested object)
  resourceVersion
  Long
  单调递增版本已使用下游同步。
  示例： 10
  status
  String
  状态信息。
  示例： Enabled
  createdAt
  String
  创建时间。
  示例： 2026-01-15T08:00:00Z
  updatedAt
  String
  更新时间。
  示例： 2026-01-15T08:00:00Z
  ownerUuid
  String
  组织负责人用户UUID已配置。
  示例： 11111111111111111111111111111111
  ownerName
  String
  负责人名称。
  示例： Alice
  departmentPath
  String
  部门路径。
  示例： Company/Engineering
  departmentPathNames
  List
  组织树显示路径单独名称。
  示例： item1,item2
  directUserCount
  Long
  直接用户数量。
  示例： 1
  totalUserCount
  Long
  总用户数量。
  示例： 10
  joinedAt
  String
  加入时间。
  示例： 2026-01-15T08:00:00Z
  directOrganizations
  List
  用户列表显示聚合直接部门成员关系。
  示例： (nested array)
  id
  String
  资源ID。
  示例： dept-001
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： dept-001
  source
  String
  来源信息。
  示例： ZIAM
  ziamDepartmentId
  String
  ZIAM部门ID。
  示例： dept-001
  name
  String必填
  资源名称。
  示例： Engineering
  displayName
  String
  显示名称。用于界面展示。
  示例： Engineering
  description
  String
  资源的详细描述。
  示例： A brief description
  parentId
  String
  父项组织ID。
  示例： company-001
  parentUuid
  String
  父级资源UUID。
  示例： company-001
  rootId
  String
  可选根组织ID。
  示例： company-001
  rootUuid
  String
  根部门UUID。为空时返回全量树。
  示例： company-001
  type
  String
  类型。
  示例： Department
  enabled
  Boolean
  是否启用。
  示例： true
  active
  Boolean
  可选已启用标志已接受SCIM接收器。
  示例： true
  members
  List
  成员列表。
  示例： (nested array)
  value
  String
  字段值。
  示例： 11111111111111111111111111111111
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： 11111111111111111111111111111111
  display
  String
  资源。
  示例： Alice
  joinedAt
  String
  加入时间。
  示例： 2026-06-16T10:00:00Z
  attributes
  Object
  资源。
  示例： (nested object)
  resourceVersion
  Long
  单调递增版本已使用下游同步。
  示例： 10
  status
  String
  状态信息。
  示例： Enabled
  createdAt
  String
  创建时间。
  示例： 2026-01-15T08:00:00Z
  updatedAt
  String
  更新时间。
  示例： 2026-01-15T08:00:00Z
  ownerUuid
  String
  组织负责人用户UUID已配置。
  示例： 11111111111111111111111111111111
  ownerName
  String
  负责人名称。
  示例： Alice
  departmentPath
  String
  部门路径。
  示例： Company/Engineering
  departmentPathNames
  List
  组织树显示路径单独名称。
  示例： item1,item2
  directUserCount
  Long
  直接用户数量。
  示例： 1
  totalUserCount
  Long
  总用户数量。
  示例： 10
  joinedAt
  String
  加入时间。
  示例： 2026-01-15T08:00:00Z
  organizationNames
  List
  显示聚合相关组织名称。
  示例： item1,item2
  departmentNames
  List
  显示聚合相关部门名称。
  示例： item1,item2
  directOrganizationCount
  Long
  直接组织数量。
  示例： 1
  projects
  List
  项目。
  示例： (nested array)
  id
  String
  资源ID。
  示例： project-001
  uuid
  String
  资源的UUID，唯一标识该资源。
  示例： project-001
  source
  String
  来源信息。
  示例： ZIAM
  ziamProjectId
  String
  ZIAM项目ID。
  示例： project-001
  name
  String必填
  资源名称。
  示例： Project A
  displayName
  String
  显示名称。用于界面展示。
  示例： Project A
  description
  String
  资源的详细描述。
  示例： A brief description
  organizationId
  String
  组织ID。
  示例： dept-001
  organizationUuid
  String
  资源。
  示例： dept-001
  tenantId
  String
  租户ID。
  示例： tenant-001
  tenantUuid
  String
  租户UUID。
  示例： tenant-001
  accountId
  String
  可选下游账户ID。
  示例： account-001
  accountUuid
  String
  资源。
  示例： account-001
  linkAccountUuid
  String
  可选云项目关联账户UUID。
  示例： account-001
  enabled
  Boolean
  是否启用。
  示例： true
  active
  Boolean
  资源。
  示例： true
  attributes
  Object
  资源。
  示例： (nested object)
  resourceVersion
  Long
  单调递增版本已使用下游同步。
  示例： 10
  status
  String
  状态信息。
  示例： Enabled
  createdAt
  String
  创建时间。
  示例： 2026-01-15T08:00:00Z
  updatedAt
  String
  更新时间。
  示例： 2026-01-15T08:00:00Z
  userCount
  Long
  用户数量。
  示例： 1
  directUserCount
  Long
  直接用户数量。
  示例： 1
  groupCount
  Long
  组数量。
  示例： 1
  userGroupCount
  Long
  用户组数量。
  示例： 1
  joinedAt
  String
  加入时间。
  示例： 2026-01-15T08:00:00Z
  projectNames
  List
  显示聚合相关项目名称。
  示例： item1,item2
  projectCount
  Long
  项目数量。
  示例： 1
  userCount
  Long
  用户数量。
  示例： 1
  directUserCount
  Long
  直接用户数量。
  示例： 1
  userGroupCount
  Long
  用户组数量。
  示例： 1
  ownerUuid
  String
  组织负责人用户UUID已配置。
  示例： 11111111111111111111111111111111
  ownerName
  String
  负责人名称。
  示例： Alice
  departmentPath
  String
  部门路径。
  示例： Company/Engineering
  departmentPathNames
  List
  组织树显示路径单独名称。
  示例： item1,item2
  totalUserCount
  Long
  总用户数量。
  示例： 10
  groupUuids
  List
  组UUID。
  示例： item1,item2
  projectUuids
  List
  项目UUID。
  示例： item1,item2
  organizationUuids
  List
  组织UUID。
  示例： item1,item2
  departmentUuids
  List
  部门UUID。
  示例： item1,item2
  joinedAt
  String
  加入时间。
  示例： 2026-01-15T08:00:00Z
  deletionTimestamp
  String
  软删除时间戳已删除用户。
  示例： 2026-01-15T08:00:00Z
  deletionPhase
  String
  软已删除用户。
  示例： SoftDeleted
  retentionUntil
  String
  保留截止。
  示例： 2026-01-15T08:00:00Z
  finalizers
  List
  删除终结器应用软已删除用户。
  示例： item1,item2

请求示例

curl -X POST '{host}/api/v1/ziam/resources/{collection}/batch' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  -d '{
  "operation": "disable",
  "items": [
    {
      "uuid": "11111111111111111111111111111111",
      "data": {
        "uuid": "11111111111111111111111111111111",
        "name": "alice",
        "userName": "alice",
        "displayName": "Alice",
        "description": "A brief description",
        "password": "password123",
        "confirmPassword": "password123",
        "email": "alice@example.com",
        "phone": "+8613800138000",
        "phoneNumber": "+8613800138000",
        "mobile": "+8613800138000",
        "source": "ZIAM",
        "status": "Enabled",
        "credentialStatus": {
          "type": "password",
          "algorithm": "argon2id",
          "version": "1",
          "status": "Active",
          "mustChange": "false",
          "createdAt": "2026-06-17T01:00:00Z",
          "updatedAt": "2026-06-17T01:00:00Z"
        },
        "createdAt": "2026-06-16T10:00:00Z",
        "updatedAt": "2026-06-16T10:30:00Z",
        "lastLoginTime": "2026-06-16T10:00:00Z",
        "lastLoginIp": "172.26.53.126",
        "groups": [
          {
            "id": "group-001",
            "uuid": "group-001",
            "source": "ZIAM",
            "ziamGroupId": "group-001",
            "name": "Operators",
            "displayName": "Operators",
            "description": "A brief description",
            "projectId": "project-001",
            "projectUuid": "project-001",
            "enabled": "true",
            "active": "true",
            "members": [
              {
                "value": "11111111111111111111111111111111",
                "uuid": "11111111111111111111111111111111",
                "display": "Alice",
                "joinedAt": "2026-06-16T10:00:00Z"
              }
            ],
            "attributes": {},
            "resourceVersion": "10",
            "status": "Enabled",
            "createdAt": "2026-01-15T08:00:00Z",
            "updatedAt": "2026-01-15T08:00:00Z",
            "userCount": "1",
            "directUserCount": "1",
            "projects": [
              {
                "id": "project-001",
                "uuid": "project-001",
                "source": "ZIAM",
                "ziamProjectId": "project-001",
                "name": "Project A",
                "displayName": "Project A",
                "description": "A brief description",
                "organizationId": "dept-001",
                "organizationUuid": "dept-001",
                "tenantId": "tenant-001",
                "tenantUuid": "tenant-001",
                "accountId": "account-001",
                "accountUuid": "account-001",
                "linkAccountUuid": "account-001",
                "enabled": "true",
                "active": "true",
                "attributes": {},
                "resourceVersion": "10",
                "status": "Enabled",
                "createdAt": "2026-01-15T08:00:00Z",
                "updatedAt": "2026-01-15T08:00:00Z",
                "userCount": "1",
                "directUserCount": "1",
                "groupCount": "1",
                "userGroupCount": "1",
                "joinedAt": "2026-01-15T08:00:00Z"
              }
            ],
            "projectNames": [
              "{projectNames}"
            ],
            "projectCount": "1",
            "joinedAt": "2026-01-15T08:00:00Z"
          }
        ],
        "groupNames": [
          "{groupNames}"
        ],
        "groupCount": "1",
        "organizations": [
          {
            "id": "dept-001",
            "uuid": "dept-001",
            "source": "ZIAM",
            "ziamDepartmentId": "dept-001",
            "name": "Engineering",
            "displayName": "Engineering",
            "description": "A brief description",
            "parentId": "company-001",
            "parentUuid": "company-001",
            "rootId": "company-001",
            "rootUuid": "company-001",
            "type": "Department",
            "enabled": "true",
            "active": "true",
            "members": [
              {
                "value": "11111111111111111111111111111111",
                "uuid": "11111111111111111111111111111111",
                "display": "Alice",
                "joinedAt": "2026-06-16T10:00:00Z"
              }
            ],
            "attributes": {},
            "resourceVersion": "10",
            "status": "Enabled",
            "createdAt": "2026-01-15T08:00:00Z",
            "updatedAt": "2026-01-15T08:00:00Z",
            "ownerUuid": "11111111111111111111111111111111",
            "ownerName": "Alice",
            "departmentPath": "Company/Engineering",
            "departmentPathNames": [
              "{departmentPathNames}"
            ],
            "directUserCount": "1",
            "totalUserCount": "10",
            "joinedAt": "2026-01-15T08:00:00Z"
          }
        ],
        "directOrganizations": [
          {
            "id": "dept-001",
            "uuid": "dept-001",
            "source": "ZIAM",
            "ziamDepartmentId": "dept-001",
            "name": "Engineering",
            "displayName": "Engineering",
            "description": "A brief description",
            "parentId": "company-001",
            "parentUuid": "company-001",
            "rootId": "company-001",
            "rootUuid": "company-001",
            "type": "Department",
            "enabled": "true",
            "active": "true",
            "members": [
              {
                "value": "11111111111111111111111111111111",
                "uuid": "11111111111111111111111111111111",
                "display": "Alice",
                "joinedAt": "2026-06-16T10:00:00Z"
              }
            ],
            "attributes": {},
            "resourceVersion": "10",
            "status": "Enabled",
            "createdAt": "2026-01-15T08:00:00Z",
            "updatedAt": "2026-01-15T08:00:00Z",
            "ownerUuid": "11111111111111111111111111111111",
            "ownerName": "Alice",
            "departmentPath": "Company/Engineering",
            "departmentPathNames": [
              "{departmentPathNames}"
            ],
            "directUserCount": "1",
            "totalUserCount": "10",
            "joinedAt": "2026-01-15T08:00:00Z"
          }
        ],
        "organizationNames": [
          "{organizationNames}"
        ],
        "departmentNames": [
          "{departmentNames}"
        ],
        "directOrganizationCount": "1",
        "projects": [
          {
            "id": "project-001",
            "uuid": "project-001",
            "source": "ZIAM",
            "ziamProjectId": "project-001",
            "name": "Project A",
            "displayName": "Project A",
            "description": "A brief description",
            "organizationId": "dept-001",
            "organizationUuid": "dept-001",
            "tenantId": "tenant-001",
            "tenantUuid": "tenant-001",
            "accountId": "account-001",
            "accountUuid": "account-001",
            "linkAccountUuid": "account-001",
            "enabled": "true",
            "active": "true",
            "attributes": {},
            "resourceVersion": "10",
            "status": "Enabled",
            "createdAt": "2026-01-15T08:00:00Z",
            "updatedAt": "2026-01-15T08:00:00Z",
            "userCount": "1",
            "directUserCount": "1",
            "groupCount": "1",
            "userGroupCount": "1",
            "joinedAt": "2026-01-15T08:00:00Z"
          }
        ],
        "projectNames": [
          "{projectNames}"
        ],
        "projectCount": "1",
        "userCount": "1",
        "directUserCount": "1",
        "userGroupCount": "1",
        "ownerUuid": "11111111111111111111111111111111",
        "ownerName": "Alice",
        "departmentPath": "Company/Engineering",
        "departmentPathNames": [
          "{departmentPathNames}"
        ],
        "totalUserCount": "10",
        "groupUuids": [
          "{groupUuids}"
        ],
        "projectUuids": [
          "{projectUuids}"
        ],
        "organizationUuids": [
          "{organizationUuids}"
        ],
        "departmentUuids": [
          "{departmentUuids}"
        ],
        "joinedAt": "2026-01-15T08:00:00Z",
        "deletionTimestamp": "2026-01-15T08:00:00Z",
        "deletionPhase": "SoftDeleted",
        "retentionUntil": "2026-01-15T08:00:00Z",
        "finalizers": [
          "{finalizers}"
        ]
      },
      "lockedUntil": "2026-06-17T00:00:00Z"
    }
  ]
}'

响应示例

{
  "status": "ok",
  "data": {
    "operation": "disable",
    "atomic": false,
    "total": 2,
    "succeeded": 1,
    "failed": 1,
    "results": [
      {
        "index": 1,
        "uuid": "11111111111111111111111111111111",
        "status": "ok",
        "msg": "uuid is required",
        "data": {
          "uuid": "11111111111111111111111111111111",
          "name": "alice",
          "userName": "alice",
          "displayName": "Alice",
          "description": "A brief description",
          "password": "password123",
          "confirmPassword": "password123",
          "email": "alice@example.com"
        }
      }
    ]
  }
}

Agent 插件

Agent 管理

资产

指标目录与保留策略

采集任务

基础设施综合

安装器

生命周期

OTA 升级计划

OTA 版本与策略

联邦与 SSO

变更管理

资源删除

生命周期升级

指标采集

监控缓存

监控查询与概览

自动修复

监控综合

Grafana 集成

Grafana 仪表盘

日志

性能剖析

Zaku

告警规则

告警模板

告警通道与集成

告警事件

告警路由与策略

值班

SLO

健康检查

凭证

ZIAM

安全

ZMetis 审计

平台管理

平台联邦

平台自监控

平台健康

平台综合

ZMetis 任务

认证信息

请求参数

请求体字段

响应状态