DevicesLongRunningOperationResponse
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
وضعیت یک عملیات طولانی‌مدت برای ادعا، لغو ادعا یا پیوست کردن ابرداده به دستگاه‌ها را ردیابی می‌کند. برای کسب اطلاعات بیشتر، عملیات دسته ای طولانی را بخوانید.
| نمایندگی JSON |
|---|
{
"successCount": integer,
"perDeviceStatus": [
{
object (OperationPerDevice)
}
]
} |
| فیلدها |
|---|
successCount | integer خلاصه ای از چند مورد در عملیات که سرور با موفقیت پردازش کرده است. با پیشرفت عملیات به روز شد. |
perDeviceStatus[] | object ( OperationPerDevice ) وضعیت پردازش برای هر دستگاه در عملیات. یک PerDeviceStatus در هر دستگاه. ترتیب فهرست با موارد موجود در درخواست اصلی مطابقت دارد. |
OperationPerDevice
یک وظیفه برای هر دستگاه در عملیات. مربوط به هر تغییر دستگاه در درخواست است.
| فیلدها |
|---|
result | object ( PerDeviceStatusInBatch ) نتیجه پردازش برای هر دستگاه |
request میدانی اتحادیه شامل درخواست دریافت شده توسط سرور. request فقط می تواند یکی از موارد زیر باشد: |
claim | object ( PartnerClaim ) یک کپی از درخواست ادعای اصلی دستگاه دریافت شده توسط سرور. |
unclaim | object ( PartnerUnclaim ) یک کپی از درخواست اصلی عدم ادعای دستگاه دریافت شده توسط سرور. |
updateMetadata | object ( UpdateMetadataArguments ) یک کپی از درخواست به‌روزرسانی ابرداده اصلی دریافت شده توسط سرور. |
PerDeviceStatusInBatch
وضعیت پردازش را برای هر دستگاه در عملیات ضبط می کند.
| نمایندگی JSON |
|---|
{
"status": enum (PerDeviceStatus),
"deviceId": string,
"errorMessage": string,
"errorIdentifier": string
} |
| فیلدها |
|---|
status | enum ( PerDeviceStatus ) وضعیت نتیجه دستگاه پس از پردازش. |
deviceId | string ( int64 format) اگر پردازش با موفقیت انجام شود، شناسه دستگاه دستگاه. |
errorMessage | string اگر پردازش ناموفق باشد، یک پیام توسعه‌دهنده نشان می‌دهد که چه مشکلی رخ داده است. |
errorIdentifier | string اگر پردازش ناموفق باشد، نوع خطا. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\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. |"]]
