Chaitin Tech software/uninstall/instance/{instance_id}/device/list API

软件分发与卸载/uninstall 接口/实例/instance_id 参数/设备管理/列表

OpenAPI Specification

chaitin-software-uninstall-instance-instance-id-device-list-api-openapi.yml Raw ↑
openapi: 3.0.3
info:
  title: APISec Management account software/uninstall/instance/{instance_id}/device/list API
  version: '26.05'
  description: Generated from APISec skyview APIView classes.
tags:
- name: software/uninstall/instance/{instance_id}/device/list
  description: 软件分发与卸载/uninstall 接口/实例/instance_id 参数/设备管理/列表
paths:
  /software/uninstall/instance/{instance_id}/device/list:
    post:
      summary: 实例终端列表
      deprecated: false
      description: ''
      tags:
      - software/uninstall/instance/{instance_id}/device/list
      parameters:
      - name: instance_id
        in: path
        description: ''
        required: true
        example: 2514df20-e119-4ca7-abb5-6693f2b98360
        schema:
          type: string
      - name: page
        in: query
        description: ''
        required: true
        example: '1'
        schema:
          type: string
      - name: limit
        in: query
        description: ''
        required: true
        example: '10'
        schema:
          type: string
      - name: search
        in: query
        description: ''
        required: true
        example: ''
        schema:
          type: string
      - name: X-CS-Header-App
        in: header
        description: 应用id
        required: true
        example: '{{app}}'
        schema:
          type: string
      - name: X-CS-Header-Company
        in: header
        description: 公司id
        required: true
        example: '{{company_id}}'
        schema:
          type: string
      - name: X-CS-Header-Crypt
        in: header
        description: 加密算法,请参考:https://servaltech.feishu.cn/docs/doccnQCZ2cw32uazgNSO0DFwceb
        required: true
        example: ''
        schema:
          type: string
      - name: If-None-Match
        in: header
        description: 对于支持「ETAG」的接口,将上一次请求的响应header的Etag,填入到下一次请求。若匹配,则返回304(无变更),否则会返回新版本的数据 + 新Etag
        required: true
        example: string
        schema:
          type: string
      - name: X-CS-Header-Debug
        in: header
        description: ''
        required: true
        example: '{{debug}}'
        schema:
          type: string
      - name: Accept-Language
        in: header
        description: ''
        required: true
        example: zh
        schema:
          type: string
      - name: X-Cs-Header-Timezone
        in: header
        description: ''
        required: true
        example: Asia/Shanghai
        schema:
          type: string
      - name: Content-Type
        in: header
        description: ''
        required: true
        example: application/json
        schema:
          type: string
      - name: Accept
        in: header
        description: ''
        required: true
        example: application/json
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                queries:
                  type: array
                  items:
                    type: object
                    properties:
                      field:
                        type: string
                      operator:
                        type: string
                      value:
                        type: string
                      is_order_used:
                        type: boolean
                      field_type:
                        type: string
                      is_filter_used:
                        type: boolean
              required:
              - queries
            example:
              queries:
              - field: device__staff__staff__name
                operator: is
                value: 陈磊
                is_order_used: false
                field_type: 文本
                is_filter_used: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  msg:
                    type: string
                  data:
                    type: object
                    properties:
                      total:
                        type: integer
                      results:
                        type: array
                        items:
                          type: object
                          properties:
                            device:
                              type: object
                              properties:
                                uid:
                                  type: string
                                code:
                                  type: string
                                family:
                                  type: string
                                conn_status:
                                  type: string
                                staff_info:
                                  type: object
                                  properties:
                                    code:
                                      type: string
                                    name:
                                      type: string
                                    number:
                                      type: string
                                    email:
                                      type: string
                                    uid:
                                      type: string
                                    dept_paths:
                                      type: string
                                    depts:
                                      type: array
                                      items:
                                        type: object
                                        properties:
                                          uid:
                                            type: string
                                          name:
                                            type: string
                                          leaders:
                                            type: array
                                            items: {}
                                          path:
                                            type: string
                                          paths:
                                            type: array
                                            items:
                                              type: string
                                          ancestor_ids:
                                            type: array
                                            items:
                                              type: string
                                  required:
                                  - code
                                  - name
                                  - number
                                  - email
                                  - uid
                                  - dept_paths
                                  - depts
                                ip:
                                  type: string
                                mac:
                                  type: string
                                agent_version:
                                  type: string
                                username:
                                  type: string
                                console_user:
                                  type: string
                              required:
                              - uid
                              - code
                              - family
                              - conn_status
                              - staff_info
                              - ip
                              - mac
                              - agent_version
                              - username
                              - console_user
                            process_progress:
                              type: array
                              items:
                                type: integer
                            update_time:
                              type: string
                          required:
                          - device
                          - process_progress
                          - update_time
                      page:
                        type: integer
                    required:
                    - total
                    - results
                    - page
                required:
                - code
                - msg
                - data
              example:
                code: 0
                msg: Normal
                data:
                  total: 2
                  results:
                  - device:
                      uid: 6453b864-02b3-4e9b-96bf-2814cd912481
                      code: PC-000237
                      family: Windows
                      conn_status: offline
                      staff_info: {}
                      ip: 192.168.142.129
                      mac: 00:0C:29:60:D5:2F
                      agent_version: 3.4.99
                      username: serval-backend@DESKTOP-HOQQ6PF
                      console_user: serval-backend@DESKTOP-HOQQ6PF
                    process_progress:
                    - 2
                    - 0
                    - 2
                    update_time: '2024-10-15T10:00:41.909728Z'
                  - device:
                      uid: 57880400-cf1f-4926-9d4f-01bb15592060
                      code: PC-000061
                      family: Windows
                      conn_status: online
                      staff_info:
                        code: fa3de8be5bd8743f
                        name: 不嘻嘻
                        number: dsfdsv1312vsvczWQECSCCAFVFS123132132132132134dsvsfvdvdsfwfnj
                        email: beining.wu@cyberserval.cn
                        uid: 46a7f951-5666-47b1-9b74-a2b4cd6aac81
                        dept_paths: 薮猫大公司/导入一级部门测试1
                        depts:
                        - uid: e9344a53-b5d0-457a-bd2f-f30f37239ca0
                          name: 导入一级部门测试1
                          leaders: []
                          path: 薮猫大公司/导入一级部门测试1
                          paths:
                          - 薮猫大公司
                          - 导入一级部门测试1
                          ancestor_ids:
                          - 282cfac5-94a1-4d2c-ade8-f8b0538bde11
                          - e9344a53-b5d0-457a-bd2f-f30f37239ca0
                      ip: 192.168.96.200
                      mac: 8C:F8:C5:FB:C1:65
                      agent_version: 3.4.3
                      username: soumao@cyberserval.cn@LAPTOP-4N230TBL
                      console_user: soumao@cyberserval.cn@LAPTOP-4N230TBL
                    process_progress:
                    - 2
                    - 0
                    - 2
                    update_time: '2024-10-15T10:00:41.601116Z'
                  page: 1
      security: []