Updates - Get Operations

參考

服務:: Device Update

API 版本:: 2020-09-01

取得所有匯入更新作業的清單。自動刪除之前，已完成的作業會保留7天。此 API 版本不會傳回刪除作業。

GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates/operations

含選擇性參數:

GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates/operations?$filter={$filter}&$top={$top}

URI 參數

名稱	位於	必要	類型	Description
accountEndpoint	path	True	string	帳戶端點。
instanceId	path	True	string	帳戶實例標識碼。
$filter	query		string	限制傳回的作業集。僅支援一個特定篩選：“status eq 'NotStarted' 或 status eq 'Running'”
$top	query		integer int32	指定非負整數 n，以限制從集合傳回的項目數目。此服務會傳回可用項目數目，但不能大於指定的值 n。

回應

名稱	類型	Description
200 OK	PageableListOfOperations	作業詳細數據。
429 Too Many Requests		太多要求;在一段時間內可以執行多少作業有速率限制。

安全性

azure_auth_implicit

Azure Active Directory OAuth2 隱含流程

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

azure_auth_code

Azure Active Directory OAuth2 AccessCode Flow

類型: oauth2
Flow: accessCode
授權 URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
權杖 URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

azure_auth_application

Azure Active Directory OAuth2 應用程式流程

類型: oauth2
Flow: application
權杖 URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

範圍

名稱	Description
.default	用戶端認證範圍

azure_auth_password

Azure Active Directory OAuth2 密碼流程

類型: oauth2
Flow: password
權杖 URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

Updates_GetOperations

範例要求

HTTP

GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates/operations

範例回覆

狀態碼:: 200

{
  "value": [
    {
      "operationId": "e4491c54-916f-443d-9094-bcca546ace2f",
      "status": "Succeeded",
      "resourceLocation": "/v2/updates/providers/microsoft/names/adu/versions/1.0.0.0",
      "traceId": "2b881ef9deaf5d45b0a716ca5b4145ec",
      "createdDateTime": "2020-04-22T21:00:53.2548897+00:00",
      "lastActionDateTime": "2020-04-22T21:01:43.9401420+00:00",
      "etag": "\"a0f7b6f2-3f6c-4eb6-8a59-2f5411c23888\""
    }
  ]
}

狀態碼:: 429

定義

名稱	Description
Error	錯誤詳細數據。
InnerError	物件，包含比目前對象有關錯誤更具體的資訊。
Operation	作業元數據。
OperationStatus	作業狀態。
PageableListOfOperations	伺服器分頁支援的作業清單。
UpdateId	更新標識碼。

Error

錯誤詳細數據。

名稱	類型	Description
code	string	伺服器定義的錯誤碼。
details	Error[]	導致回報錯誤的錯誤陣列。
innererror	InnerError	物件，包含比目前對象有關錯誤更具體的資訊。
message	string	人類可讀取的錯誤表示法。
occurredDateTime	string	發生錯誤的 UTC 日期和時間。
target	string	錯誤的目標。

InnerError

物件，包含比目前對象有關錯誤更具體的資訊。

名稱	類型	Description
code	string	比包含錯誤所提供的錯誤碼更具體。
errorDetail	string	內部錯誤或例外狀況訊息。
innerError	InnerError	物件，包含比目前對象有關錯誤更具體的資訊。
message	string	人類可讀取的錯誤表示法。

Operation

作業元數據。

名稱	類型	Description
createdDateTime	string	建立作業時的 UTC 日期和時間。
error	Error	如果發生工作錯誤，則為。
etag	string	作業 ETag。
lastActionDateTime	string	上次更新作業狀態的 UTC 日期和時間。
operationId	string	作業識別碼。
resourceLocation	string	作業成功時匯入的更新位置。
status	OperationStatus	作業狀態。
traceId	string	Microsoft 支援服務可用來進行疑難解答的作業相互關聯識別。
updateId	UpdateId	要匯入或刪除之更新的身分識別。針對匯入，只有在匯入指令清單順利處理之後，才會填入此屬性。

OperationStatus

作業狀態。

名稱	類型	Description
Failed	string	背景作業已完成，失敗。
NotStarted	string	已建立但尚未啟動的背景作業。
Running	string	背景作業目前正在執行。
Succeeded	string	背景作業已順利完成。
Undefined	string	未定義的作業狀態。

PageableListOfOperations

伺服器分頁支援的作業清單。

名稱	類型	Description
nextLink	string	專案下一頁的連結。
value	Operation[]	可分頁專案的集合。

UpdateId

更新標識碼。

名稱	類型	Description
name	string	更新名稱。
provider	string	更新提供者。
version	string	更新版本。