pyGoEdge-UserPanel/reference/goedge 文档/FormalClientSystemService.md

FormalClientSystemService

操作系统信息库服务

---

countFormalClientSystems

计算操作系统信息数量

• 角色：admin
• HTTP：POST https://backend.dooki.cloud/FormalClientSystemService/countFormalClientSystems
• RPC：rpc countFormalClientSystems(CountFormalClientSystemsRequest) returns (RPCCountResponse);

请求对象 (CountFormalClientSystemsRequest)

{
  "keyword": "string // 可选"
}

响应对象 (RPCCountResponse)

{
  "count": "int64 // 数量"
}

调用示例

curl -X POST "https://backend.dooki.cloud/FormalClientSystemService/countFormalClientSystems" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'

---

createFormalClientSystem

创建操作系统信息

• 角色：admin
• HTTP：POST https://backend.dooki.cloud/FormalClientSystemService/createFormalClientSystem
• RPC：rpc createFormalClientSystem(CreateFormalClientSystemRequest) returns (CreateFormalClientSystemResponse);

请求对象 (CreateFormalClientSystemRequest)

{
  "name": "string // 名称",
  "codes": "[]string",
  "dataId": "string"
}

响应对象 (CreateFormalClientSystemResponse)

{
  "formalClientSystemId": "int64"
}

调用示例

curl -X POST "https://backend.dooki.cloud/FormalClientSystemService/createFormalClientSystem" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'

---

findFormalClientSystemWithDataId

通过dataId查询操作系统信息

• 角色：admin
• HTTP：POST https://backend.dooki.cloud/FormalClientSystemService/findFormalClientSystemWithDataId
• RPC：rpc findFormalClientSystemWithDataId(FindFormalClientSystemWithDataIdRequest) returns (FindFormalClientSystemWithDataIdResponse);

请求对象 (FindFormalClientSystemWithDataIdRequest)

{
  "dataId": "string"
}

响应对象 (FindFormalClientSystemWithDataIdResponse)

{
  "formalClientSystem": "FormalClientSystem"
}

调用示例

curl -X POST "https://backend.dooki.cloud/FormalClientSystemService/findFormalClientSystemWithDataId" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'

---

listFormalClientSystems

列出单页操作系统信息

• 角色：admin
• HTTP：POST https://backend.dooki.cloud/FormalClientSystemService/listFormalClientSystems
• RPC：rpc listFormalClientSystems(ListFormalClientSystemsRequest) returns (ListFormalClientSystemsResponse);

请求对象 (ListFormalClientSystemsRequest)

{
  "keyword": "string // 可选",
  "offset": "int64 // 读取位置",
  "size": "int64 // 数量，通常不能小于0"
}

响应对象 (ListFormalClientSystemsResponse)

{
  "formalClientSystems": "[]FormalClientSystem"
}

调用示例

curl -X POST "https://backend.dooki.cloud/FormalClientSystemService/listFormalClientSystems" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'

---

updateFormalClientSystem

修改操作系统信息

• 角色：admin
• HTTP：POST https://backend.dooki.cloud/FormalClientSystemService/updateFormalClientSystem
• RPC：rpc updateFormalClientSystem(UpdateFormalClientSystemRequest) returns (RPCSuccess);

请求对象 (UpdateFormalClientSystemRequest)

{
  "formalClientSystemId": "int64",
  "name": "string // 名称",
  "codes": "[]string",
  "dataId": "string"
}

响应对象 (RPCSuccess)

{}

调用示例

curl -X POST "https://backend.dooki.cloud/FormalClientSystemService/updateFormalClientSystem" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'

---