プランに含まれる詳細を取得することで、管理対象ソフトウェアアップデートの展開をトラブルシューティングできます。プランとは、コンピュータまたはモバイルデバイスを特定のバージョンにアップデートするための単一のリクエストです。一度にコンピュータまたはモバイルデバイスでアクティブにできるプランは1つだけです。例えば、あるプランをコンピュータに展開した場合、最初のプランが完了するまで、同じコンピュータに別のプランを展開することはできません。プランの詳細を確認することで、コンピュータまたはモバイルデバイスに送信されたコマンドの内容が明確になり、トラブルシューティングに役立ちます。管理対象ソフトウェアアップデートプランの詳細は、コンピュータまたはモバイルデバイスのインベントリレコード内から、または /v1/managed-software-updates/plans API エンドポイントを使用して取得できます。API エンドポイントの詳細については、Jamf Pro API Overview (Jamf Pro API の概要) を参照してください。
例:
"planUuid": "6E47EF55-5318-494F-A09E-70F613E0AFD1",
"device": {
"deviceId": "1",
"objectType": "COMPUTER",
"href": "/v1/computers-inventory/1"
},
"updateAction": "DOWNLOAD_INSTALL",
"versionType": "SPECIFIC_VERSION",
"specificVersion": "12.6.1",
"maxDeferrals": 5,
"forceInstallLocalDateTime": "2023-12-25T21:09:31",
"recipeId": "1",
"status": {
"state": "SchedulingScanForOSUpdates",
"errorReasons": [
"NO_UPDATES_AVAILABLE",
"NOT_SUPERVISED"
]
}