DevicesLongRunningOperationResponse
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Theo dõi trạng thái của một hoạt động diễn ra trong thời gian dài để xác nhận quyền sở hữu, huỷ xác nhận quyền sở hữu hoặc đính kèm siêu dữ liệu vào thiết bị. Để tìm hiểu thêm, hãy đọc bài viết Thao tác hàng loạt diễn ra trong thời gian dài.
Biểu diễn dưới dạng JSON |
{
"successCount": integer,
"perDeviceStatus": [
{
object (OperationPerDevice )
}
]
} |
Trường |
successCount |
integer
Một bản tóm tắt về số lượng mục trong thao tác mà máy chủ đã xử lý thành công. Cập nhật khi hoạt động diễn ra.
|
perDeviceStatus[] |
object (OperationPerDevice )
Trạng thái xử lý của từng thiết bị trong hoạt động. Một PerDeviceStatus cho mỗi thiết bị. Thứ tự trong danh sách khớp với các mặt hàng trong yêu cầu ban đầu.
|
OperationPerDevice
Một tác vụ cho mỗi thiết bị trong thao tác. Tương ứng với từng thay đổi về thiết bị trong yêu cầu.
Trường |
result |
object (PerDeviceStatusInBatch )
Kết quả xử lý cho từng thiết bị.
|
Trường kết hợp request . Chứa yêu cầu mà máy chủ nhận được. request chỉ có thể là một trong những trạng thái sau đây: |
claim |
object (PartnerClaim )
Bản sao yêu cầu xác nhận quyền sở hữu thiết bị gốc mà máy chủ nhận được.
|
unclaim |
object (PartnerUnclaim )
Bản sao yêu cầu huỷ xác nhận thiết bị gốc mà máy chủ đã nhận được.
|
updateMetadata |
object (UpdateMetadataArguments )
Bản sao của yêu cầu cập nhật siêu dữ liệu gốc mà máy chủ nhận được.
|
PerDeviceStatusInBatch
Ghi lại trạng thái xử lý của từng thiết bị trong hoạt động.
Biểu diễn dưới dạng JSON |
{
"status": enum (PerDeviceStatus ),
"deviceId": string,
"errorMessage": string,
"errorIdentifier": string
} |
Trường |
status |
enum (PerDeviceStatus )
Trạng thái kết quả của thiết bị sau khi xử lý xong.
|
deviceId |
string (int64 format)
Nếu quá trình xử lý thành công, mã thiết bị của thiết bị.
|
errorMessage |
string
Nếu quá trình xử lý không thành công, thông báo của nhà phát triển sẽ giải thích lỗi.
|
errorIdentifier |
string
Nếu quá trình xử lý không thành công, loại lỗi này sẽ được chọn.
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eThis document describes the structure for tracking the status of long-running operations related to claiming, unclaiming, or attaching metadata to devices.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003esuccessCount\u003c/code\u003e field provides a summary of the number of items successfully processed within the operation.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eperDeviceStatus\u003c/code\u003e field contains a list of \u003ccode\u003eOperationPerDevice\u003c/code\u003e objects, which detail the processing status for each individual device in the operation.\u003c/p\u003e\n"],["\u003cp\u003eEach \u003ccode\u003eOperationPerDevice\u003c/code\u003e includes a \u003ccode\u003eresult\u003c/code\u003e field that uses the \u003ccode\u003ePerDeviceStatusInBatch\u003c/code\u003e to define the outcome of each device's operation.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ePerDeviceStatusInBatch\u003c/code\u003e includes fields like \u003ccode\u003estatus\u003c/code\u003e, \u003ccode\u003edeviceId\u003c/code\u003e, \u003ccode\u003eerrorMessage\u003c/code\u003e, and \u003ccode\u003eerrorIdentifier\u003c/code\u003e that will detail if an operation was successful, and if not, to give a description of the failure.\u003c/p\u003e\n"]]],["The provided content outlines the structure for tracking device operations, such as claiming, unclaiming, or updating metadata. Key information includes `successCount`, which reflects the number of successfully processed items. `OperationPerDevice` details individual device tasks with their corresponding request types (`claim`, `unclaim`, or `updateMetadata`). `PerDeviceStatusInBatch` captures each device's processing status, including `status`, `deviceId` (if successful), and `errorMessage` and `errorIdentifier` (if failed).\n"],null,["# DevicesLongRunningOperationResponse\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [OperationPerDevice](#OperationPerDevice)\n - [JSON representation](#OperationPerDevice.SCHEMA_REPRESENTATION)\n- [PerDeviceStatusInBatch](#PerDeviceStatusInBatch)\n - [JSON representation](#PerDeviceStatusInBatch.SCHEMA_REPRESENTATION)\n\nTracks the status of a long-running operation to claim, unclaim, or attach metadata to devices. To learn more, read [Long‑running batch operations](/zero-touch/guides/how-it-works#operations).\n\n| JSON representation ||\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"successCount\": integer, \"perDeviceStatus\": [ { object (/zero-touch/reference/reseller/rest/v1/DevicesLongRunningOperationResponse#OperationPerDevice) } ] } ``` |\n\n| Fields ||\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `successCount` | `integer` A summary of how many items in the operation the server processed successfully. Updated as the operation progresses. |\n| `perDeviceStatus[]` | `object (`[OperationPerDevice](/zero-touch/reference/reseller/rest/v1/DevicesLongRunningOperationResponse#OperationPerDevice)`)` The processing status for each device in the operation. One `PerDeviceStatus` per device. The list order matches the items in the original request. |\n\nOperationPerDevice\n------------------\n\nA task for each device in the operation. Corresponds to each device change in the request.\n\n| JSON representation ||\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"result\": { object (/zero-touch/reference/reseller/rest/v1/DevicesLongRunningOperationResponse#PerDeviceStatusInBatch) }, // Union field `request` can be only one of the following: \"claim\": { object (/zero-touch/reference/reseller/rest/v1/partners.devices/claimAsync#PartnerClaim) }, \"unclaim\": { object (/zero-touch/reference/reseller/rest/v1/partners.devices/unclaimAsync#PartnerUnclaim) }, \"updateMetadata\": { object (/zero-touch/reference/reseller/rest/v1/partners.devices/updateMetadataAsync#UpdateMetadataArguments) } // End of list of possible types for union field `request`. } ``` |\n\n| Fields ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| `result` | `object (`[PerDeviceStatusInBatch](/zero-touch/reference/reseller/rest/v1/DevicesLongRunningOperationResponse#PerDeviceStatusInBatch)`)` The processing result for each device. |\n| Union field `request`. Containing the request received by the server. `request` can be only one of the following: |||\n| `claim` | `object (`[PartnerClaim](/zero-touch/reference/reseller/rest/v1/partners.devices/claimAsync#PartnerClaim)`)` A copy of the original device-claim request received by the server. |\n| `unclaim` | `object (`[PartnerUnclaim](/zero-touch/reference/reseller/rest/v1/partners.devices/unclaimAsync#PartnerUnclaim)`)` A copy of the original device-unclaim request received by the server. |\n| `updateMetadata` | `object (`[UpdateMetadataArguments](/zero-touch/reference/reseller/rest/v1/partners.devices/updateMetadataAsync#UpdateMetadataArguments)`)` A copy of the original metadata-update request received by the server. |\n\nPerDeviceStatusInBatch\n----------------------\n\nCaptures the processing status for each device in the operation.\n\n| JSON representation ||\n|------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"status\": enum (/zero-touch/reference/reseller/rest/v1/PerDeviceStatus), \"deviceId\": string, \"errorMessage\": string, \"errorIdentifier\": string } ``` |\n\n| Fields ||\n|-------------------|------------------------------------------------------------------------------------------------------------------------------------------|\n| `status` | `enum (`[PerDeviceStatus](/zero-touch/reference/reseller/rest/v1/PerDeviceStatus)`)` The result status of the device after processing. |\n| `deviceId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` If processing succeeds, the device ID of the device. |\n| `errorMessage` | `string` If processing fails, a developer message explaining what went wrong. |\n| `errorIdentifier` | `string` If processing fails, the error type. |"]]