DeviceManagementAsyncClient Class
- java.
lang. Object - com.
azure. iot. deviceupdate. DeviceManagementAsyncClient
- com.
public final class DeviceManagementAsyncClient
Initializes a new instance of the asynchronous DeviceUpdateClient type.
Method Summary
Methods inherited from java.lang.Object
Method Details
beginImportDevices
public PollerFlux
Import existing devices from IoT Hub. This is a long-running-operation; use Operation-Location response header value to check for operation status.
Request Body Schema
String(Devices/Modules/All)
Parameters:
Returns:
createOrUpdateDeploymentWithResponse
public Mono
Creates or updates a deployment.
Request Body Schema
{
deploymentId: String (Required)
startDateTime: OffsetDateTime (Required)
update (Required): {
updateId (Required): {
provider: String (Required)
name: String (Required)
version: String (Required)
}
description: String (Optional)
friendlyName: String (Optional)
}
groupId: String (Required)
deviceClassSubgroups (Optional): [
String (Optional)
]
isCanceled: Boolean (Optional)
isRetried: Boolean (Optional)
rollbackPolicy (Optional): {
update (Required): (recursive schema, see update above)
failure (Required): {
devicesFailedPercentage: int (Required)
devicesFailedCount: int (Required)
}
}
isCloudInitiatedRollback: Boolean (Optional)
}
Response Body Schema
{
deploymentId: String (Required)
startDateTime: OffsetDateTime (Required)
update (Required): {
updateId (Required): {
provider: String (Required)
name: String (Required)
version: String (Required)
}
description: String (Optional)
friendlyName: String (Optional)
}
groupId: String (Required)
deviceClassSubgroups (Optional): [
String (Optional)
]
isCanceled: Boolean (Optional)
isRetried: Boolean (Optional)
rollbackPolicy (Optional): {
update (Required): (recursive schema, see update above)
failure (Required): {
devicesFailedPercentage: int (Required)
devicesFailedCount: int (Required)
}
}
isCloudInitiatedRollback: Boolean (Optional)
}
Parameters:
Returns:
deleteDeploymentForDeviceClassSubgroupWithResponse
public Mono
Deletes a device class subgroup deployment.
Parameters:
Returns:
deleteDeploymentWithResponse
public Mono
Deletes a deployment.
Parameters:
Returns:
deleteDeviceClassSubgroupWithResponse
public Mono
Deletes a device class subgroup. This subgroup is automatically created when a Device Update-enabled device is connected to the hub and reports its properties. Groups, subgroups, and deployments are not automatically cleaned up but are retained for history purposes. Users can call this method to delete a subgroup if they do not need to retain any of the history of the subgroup and no longer need it. If a device is ever connected again for this subgroup after the subgroup was deleted it will be automatically re-created but there will be no history.
Parameters:
Returns:
deleteDeviceClassWithResponse
public Mono
Deletes a device class. Device classes are created automatically when Device Update-enabled devices are connected to the hub but are not automatically cleaned up since they are referenced by DeviceClassSubgroups. If the user has deleted all DeviceClassSubgroups for a device class they can also delete the device class to remove the records from the system and to stop checking the compatibility of this device class with new updates. If a device is ever reconnected for this device class it will be re-created.
Parameters:
Returns:
deleteGroupWithResponse
public Mono
Deletes a device group. This group is automatically created when a Device Update-enabled device is connected to the hub and reports its properties. Groups, subgroups, and deployments are not automatically cleaned up but are retained for history purposes. Users can call this method to delete a group if they do not need to retain any of the history of the group and no longer need it. If a device is ever connected again for this group after the group was deleted it will be automatically re-created but there will be no history.
Parameters:
Returns:
getBestUpdatesForDeviceClassSubgroupWithResponse
public Mono
Get the best available update for a device class subgroup and a count of how many devices need this update.
Response Body Schema
{
groupId: String (Required)
deviceClassId: String (Required)
update (Required): {
updateId (Required): {
provider: String (Required)
name: String (Required)
version: String (Required)
}
description: String (Optional)
friendlyName: String (Optional)
}
deviceCount: int (Required)
}
Parameters:
Returns:
getDeploymentForDeviceClassSubgroupWithResponse
public Mono
Gets the deployment properties.
Response Body Schema
{
deploymentId: String (Required)
startDateTime: OffsetDateTime (Required)
update (Required): {
updateId (Required): {
provider: String (Required)
name: String (Required)
version: String (Required)
}
description: String (Optional)
friendlyName: String (Optional)
}
groupId: String (Required)
deviceClassSubgroups (Optional): [
String (Optional)
]
isCanceled: Boolean (Optional)
isRetried: Boolean (Optional)
rollbackPolicy (Optional): {
update (Required): (recursive schema, see update above)
failure (Required): {
devicesFailedPercentage: int (Required)
devicesFailedCount: int (Required)
}
}
isCloudInitiatedRollback: Boolean (Optional)
}
Parameters:
Returns:
getDeploymentStatusWithResponse
public Mono
Gets the status of a deployment including a breakdown of how many devices in the deployment are in progress, completed, or failed.
Response Body Schema
{
groupId: String (Required)
deploymentState: String(Active/ActiveWithSubgroupFailures/Failed/Inactive/Canceled) (Required)
error (Optional): {
code: String (Required)
message: String (Required)
target: String (Optional)
details (Optional): [
(recursive schema, see above)
]
innererror (Optional): {
code: String (Required)
message: String (Optional)
errorDetail: String (Optional)
innerError (Optional): (recursive schema, see innerError above)
}
occurredDateTime: OffsetDateTime (Optional)
}
subgroupStatus (Required): [
(Required){
groupId: String (Required)
deviceClassId: String (Required)
deploymentState: String(Active/Failed/Inactive/Canceled) (Required)
error (Optional): (recursive schema, see error above)
totalDevices: Integer (Optional)
devicesInProgressCount: Integer (Optional)
devicesCompletedFailedCount: Integer (Optional)
devicesCompletedSucceededCount: Integer (Optional)
devicesCanceledCount: Integer (Optional)
}
]
}
Parameters:
Returns:
getDeploymentWithResponse
public Mono
Gets the deployment properties.
Response Body Schema
{
deploymentId: String (Required)
startDateTime: OffsetDateTime (Required)
update (Required): {
updateId (Required): {
provider: String (Required)
name: String (Required)
version: String (Required)
}
description: String (Optional)
friendlyName: String (Optional)
}
groupId: String (Required)
deviceClassSubgroups (Optional): [
String (Optional)
]
isCanceled: Boolean (Optional)
isRetried: Boolean (Optional)
rollbackPolicy (Optional): {
update (Required): (recursive schema, see update above)
failure (Required): {
devicesFailedPercentage: int (Required)
devicesFailedCount: int (Required)
}
}
isCloudInitiatedRollback: Boolean (Optional)
}
Parameters:
Returns:
getDeviceClassSubgroupDeploymentStatusWithResponse
public Mono
Gets the status of a deployment including a breakdown of how many devices in the deployment are in progress, completed, or failed.
Response Body Schema
{
groupId: String (Required)
deviceClassId: String (Required)
deploymentState: String(Active/Failed/Inactive/Canceled) (Required)
error (Optional): {
code: String (Required)
message: String (Required)
target: String (Optional)
details (Optional): [
(recursive schema, see above)
]
innererror (Optional): {
code: String (Required)
message: String (Optional)
errorDetail: String (Optional)
innerError (Optional): (recursive schema, see innerError above)
}
occurredDateTime: OffsetDateTime (Optional)
}
totalDevices: Integer (Optional)
devicesInProgressCount: Integer (Optional)
devicesCompletedFailedCount: Integer (Optional)
devicesCompletedSucceededCount: Integer (Optional)
devicesCanceledCount: Integer (Optional)
}
Parameters:
Returns:
getDeviceClassSubgroupUpdateComplianceWithResponse
public Mono
Get device class subgroup update compliance information such as how many devices are on their latest update, how many need new updates, and how many are in progress on receiving a new update.
Response Body Schema
{
totalDeviceCount: int (Required)
onLatestUpdateDeviceCount: int (Required)
newUpdatesAvailableDeviceCount: int (Required)
updatesInProgressDeviceCount: int (Required)
}
Parameters:
Returns:
getDeviceClassSubgroupWithResponse
public Mono
Gets device class subgroup details. A device class subgroup is the set of devices within the group that share the same device class. All devices within the same device class are compatible with the same updates.
Response Body Schema
{
deviceClassId: String (Required)
groupId: String (Required)
createdDateTime: String (Required)
deviceCount: Integer (Optional)
deploymentId: String (Optional)
}
Parameters:
Returns:
getDeviceClassWithResponse
public Mono
Gets the properties of a device class.
Response Body Schema
{
deviceClassId: String (Required)
friendlyName: String (Optional)
deviceClassProperties (Required): {
contractModel (Optional): {
id: String (Required)
name: String (Required)
}
compatProperties (Required): {
String: String (Required)
}
}
bestCompatibleUpdate (Optional): {
updateId (Required): {
provider: String (Required)
name: String (Required)
version: String (Required)
}
description: String (Optional)
friendlyName: String (Optional)
}
}
Parameters:
Returns:
getDeviceModuleWithResponse
public Mono
Gets the device module properties and latest deployment status for a device module connected to Device Update for IoT Hub.
Response Body Schema
{
deviceId: String (Required)
moduleId: String (Optional)
deviceClassId: String (Required)
groupId: String (Optional)
lastAttemptedUpdate (Optional): {
updateId (Required): {
provider: String (Required)
name: String (Required)
version: String (Required)
}
description: String (Optional)
friendlyName: String (Optional)
}
deploymentStatus: String(Succeeded/InProgress/Canceled/Failed) (Optional)
installedUpdate (Optional): (recursive schema, see installedUpdate above)
onLatestUpdate: boolean (Required)
lastDeploymentId: String (Optional)
lastInstallResult (Optional): {
resultCode: int (Required)
extendedResultCode: int (Required)
resultDetails: String (Optional)
stepResults (Optional): [
(Optional){
update (Optional): (recursive schema, see update above)
description: String (Optional)
resultCode: int (Required)
extendedResultCode: int (Required)
resultDetails: String (Optional)
}
]
}
}
Parameters:
Returns:
getDeviceWithResponse
public Mono
Gets the device properties and latest deployment status for a device connected to Device Update for IoT Hub.
Response Body Schema
{
deviceId: String (Required)
moduleId: String (Optional)
deviceClassId: String (Required)
groupId: String (Optional)
lastAttemptedUpdate (Optional): {
updateId (Required): {
provider: String (Required)
name: String (Required)
version: String (Required)
}
description: String (Optional)
friendlyName: String (Optional)
}
deploymentStatus: String(Succeeded/InProgress/Canceled/Failed) (Optional)
installedUpdate (Optional): (recursive schema, see installedUpdate above)
onLatestUpdate: boolean (Required)
lastDeploymentId: String (Optional)
lastInstallResult (Optional): {
resultCode: int (Required)
extendedResultCode: int (Required)
resultDetails: String (Optional)
stepResults (Optional): [
(Optional){
update (Optional): (recursive schema, see update above)
description: String (Optional)
resultCode: int (Required)
extendedResultCode: int (Required)
resultDetails: String (Optional)
}
]
}
}
Parameters:
Returns:
getGroupWithResponse
public Mono
Gets the device group properties.
Response Body Schema
{
groupId: String (Required)
groupType: String(IoTHubTag/DefaultNoTag) (Required)
createdDateTime: String (Required)
deviceCount: Integer (Optional)
subgroupsWithNewUpdatesAvailableCount: Integer (Optional)
subgroupsWithUpdatesInProgressCount: Integer (Optional)
subgroupsWithOnLatestUpdateCount: Integer (Optional)
deployments (Optional): [
String (Optional)
]
}
Parameters:
Returns:
getLogCollectionDetailedStatusWithResponse
public Mono
Get log collection with detailed status.
Response Body Schema
{
operationId: String (Optional)
createdDateTime: String (Optional)
lastActionDateTime: String (Optional)
status: String(NotStarted/Running/Succeeded/Failed) (Optional)
deviceStatus (Optional): [
(Optional){
deviceId: String (Required)
moduleId: String (Optional)
status: String(NotStarted/Running/Succeeded/Failed) (Required)
resultCode: String (Optional)
extendedResultCode: String (Optional)
logLocation: String (Optional)
}
]
description: String (Optional)
}
Parameters:
Returns:
getLogCollectionWithResponse
public Mono
Get the device diagnostics log collection.
Response Body Schema
{
operationId: String (Optional)
deviceList (Required): [
(Required){
deviceId: String (Required)
moduleId: String (Optional)
}
]
description: String (Optional)
createdDateTime: String (Optional)
lastActionDateTime: String (Optional)
status: String(NotStarted/Running/Succeeded/Failed) (Optional)
}
Parameters:
Returns:
getOperationStatusWithResponse
public Mono
Retrieve operation status.
Header Parameters
| ------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Name | Type | Required | Description |
| If-None-Match | String | No | Defines the If-None-Match condition. The operation will be performed only if the ETag on the server does not match this value. |
You can add these to a request with RequestOptions#addHeader
Response Body Schema
{
operationId: String (Required)
status: String(NotStarted/Running/Succeeded/Failed) (Required)
error (Optional): {
code: String (Required)
message: String (Required)
target: String (Optional)
details (Optional): [
(recursive schema, see above)
]
innererror (Optional): {
code: String (Required)
message: String (Optional)
errorDetail: String (Optional)
innerError (Optional): (recursive schema, see innerError above)
}
occurredDateTime: OffsetDateTime (Optional)
}
traceId: String (Optional)
lastActionDateTime: OffsetDateTime (Required)
createdDateTime: OffsetDateTime (Required)
etag: String (Optional)
}
Parameters:
Returns:
getUpdateComplianceForGroupWithResponse
public Mono
Get device group update compliance information such as how many devices are on their latest update, how many need new updates, and how many are in progress on receiving a new update.
Response Body Schema
{
totalDeviceCount: int (Required)
onLatestUpdateDeviceCount: int (Required)
newUpdatesAvailableDeviceCount: int (Required)
updatesInProgressDeviceCount: int (Required)
}
Parameters:
Returns:
getUpdateComplianceWithResponse
public Mono
Gets the breakdown of how many devices are on their latest update, have new updates available, or are in progress receiving new updates.
Response Body Schema
{
totalDeviceCount: int (Required)
onLatestUpdateDeviceCount: int (Required)
newUpdatesAvailableDeviceCount: int (Required)
updatesInProgressDeviceCount: int (Required)
}
Parameters:
Returns:
listBestUpdatesForGroup
public PagedFlux
Get the best available updates for a device group and a count of how many devices need each update.
Response Body Schema
{
value (Required): [
(Required){
groupId: String (Required)
deviceClassId: String (Required)
update (Required): {
updateId (Required): {
provider: String (Required)
name: String (Required)
version: String (Required)
}
description: String (Optional)
friendlyName: String (Optional)
}
deviceCount: int (Required)
}
]
nextLink: String (Optional)
}
Parameters:
Returns:
listDeploymentsForDeviceClassSubgroup
public PagedFlux
Gets a list of deployments for a device class subgroup.
Query Parameters
| ------- | ------ | -------- | -------------------------------------------------------------------- |
| Name | Type | Required | Description |
| orderby | String | No | Orders the set of deployments returned. You can order by start date. |
You can add these to a request with RequestOptions#addQueryParam
Response Body Schema
{
value (Required): [
(Required){
deploymentId: String (Required)
startDateTime: OffsetDateTime (Required)
update (Required): {
updateId (Required): {
provider: String (Required)
name: String (Required)
version: String (Required)
}
description: String (Optional)
friendlyName: String (Optional)
}
groupId: String (Required)
deviceClassSubgroups (Optional): [
String (Optional)
]
isCanceled: Boolean (Optional)
isRetried: Boolean (Optional)
rollbackPolicy (Optional): {
update (Required): (recursive schema, see update above)
failure (Required): {
devicesFailedPercentage: int (Required)
devicesFailedCount: int (Required)
}
}
isCloudInitiatedRollback: Boolean (Optional)
}
]
nextLink: String (Optional)
}
Parameters:
Returns:
listDeploymentsForGroup
public PagedFlux
Gets a list of deployments for a device group.
Query Parameters
| ------- | ------ | -------- | -------------------------------------------------------------------- |
| Name | Type | Required | Description |
| orderby | String | No | Orders the set of deployments returned. You can order by start date. |
You can add these to a request with RequestOptions#addQueryParam
Response Body Schema
{
value (Required): [
(Required){
deploymentId: String (Required)
startDateTime: OffsetDateTime (Required)
update (Required): {
updateId (Required): {
provider: String (Required)
name: String (Required)
version: String (Required)
}
description: String (Optional)
friendlyName: String (Optional)
}
groupId: String (Required)
deviceClassSubgroups (Optional): [
String (Optional)
]
isCanceled: Boolean (Optional)
isRetried: Boolean (Optional)
rollbackPolicy (Optional): {
update (Required): (recursive schema, see update above)
failure (Required): {
devicesFailedPercentage: int (Required)
devicesFailedCount: int (Required)
}
}
isCloudInitiatedRollback: Boolean (Optional)
}
]
nextLink: String (Optional)
}
Parameters:
Returns:
listDeviceClassSubgroupsForGroup
public PagedFlux
Get the device class subgroups for the group. A device class subgroup is the set of devices within the group that share the same device class. All devices within the same device class are compatible with the same updates.
Query Parameters
| ------ | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name | Type | Required | Description |
| filter | String | No | Restricts the set of device class subgroups returned. You can filter on compat properties by name and value. (i.e. filter=compatProperties/propertyName1 eq 'value1' and compatProperties/propertyName2 eq 'value2') |
You can add these to a request with RequestOptions#addQueryParam
Response Body Schema
{
value (Required): [
(Required){
deviceClassId: String (Required)
groupId: String (Required)
createdDateTime: String (Required)
deviceCount: Integer (Optional)
deploymentId: String (Optional)
}
]
nextLink: String (Optional)
}
Parameters:
Returns:
listDeviceClasses
public PagedFlux
Gets a list of all device classes (sets of devices compatible with the same updates based on the model Id and compat properties reported in the Device Update PnP interface in IoT Hub) for all devices connected to Device Update for IoT Hub.
Query Parameters
| ------ | ------ | -------- | ------------------------------------------------------------------------------ |
| Name | Type | Required | Description |
| filter | String | No | Restricts the set of device classes returned. You can filter on friendly name. |
You can add these to a request with RequestOptions#addQueryParam
Response Body Schema
{
value (Required): [
(Required){
deviceClassId: String (Required)
friendlyName: String (Optional)
deviceClassProperties (Required): {
contractModel (Optional): {
id: String (Required)
name: String (Required)
}
compatProperties (Required): {
String: String (Required)
}
}
bestCompatibleUpdate (Optional): {
updateId (Required): {
provider: String (Required)
name: String (Required)
version: String (Required)
}
description: String (Optional)
friendlyName: String (Optional)
}
}
]
nextLink: String (Optional)
}
Parameters:
Returns:
listDeviceStatesForDeviceClassSubgroupDeployment
public PagedFlux
Gets a list of devices in a deployment along with their state. Useful for getting a list of failed devices.
Query Parameters
| ------ | ------ | -------- | ------------------------------------------------------------------------------------------------------------------- |
| Name | Type | Required | Description |
| filter | String | No | Restricts the set of deployment device states returned. You can filter on deviceId and moduleId and/or deviceState. |
You can add these to a request with RequestOptions#addQueryParam
Response Body Schema
{
value (Required): [
(Required){
deviceId: String (Required)
moduleId: String (Optional)
retryCount: int (Required)
movedOnToNewDeployment: boolean (Required)
deviceState: String(Succeeded/InProgress/Canceled/Failed) (Required)
}
]
nextLink: String (Optional)
}
Parameters:
Returns:
listDevices
public PagedFlux
Gets a list of devices connected to Device Update for IoT Hub.
Query Parameters
| ------ | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name | Type | Required | Description |
| filter | String | No | Restricts the set of devices returned. You can filter on GroupId, DeviceClassId, or GroupId and DeploymentStatus. Use DeploymentStatus eq null to query for devices with no deployment status (that have never been deployed to). |
You can add these to a request with RequestOptions#addQueryParam
Response Body Schema
{
value (Required): [
(Required){
deviceId: String (Required)
moduleId: String (Optional)
deviceClassId: String (Required)
groupId: String (Optional)
lastAttemptedUpdate (Optional): {
updateId (Required): {
provider: String (Required)
name: String (Required)
version: String (Required)
}
description: String (Optional)
friendlyName: String (Optional)
}
deploymentStatus: String(Succeeded/InProgress/Canceled/Failed) (Optional)
installedUpdate (Optional): (recursive schema, see installedUpdate above)
onLatestUpdate: boolean (Required)
lastDeploymentId: String (Optional)
lastInstallResult (Optional): {
resultCode: int (Required)
extendedResultCode: int (Required)
resultDetails: String (Optional)
stepResults (Optional): [
(Optional){
update (Optional): (recursive schema, see update above)
description: String (Optional)
resultCode: int (Required)
extendedResultCode: int (Required)
resultDetails: String (Optional)
}
]
}
}
]
nextLink: String (Optional)
}
Parameters:
Returns:
listGroups
public PagedFlux
Gets a list of all device groups. The $default group will always be returned first.
Query Parameters
| ------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name | Type | Required | Description |
| orderby | String | No | Orders the set of groups returned. You can order by groupId, deviceCount, createdDate, subgroupsWithNewUpdatesAvailableCount, subgroupsWithUpdatesInProgressCount, or subgroupsOnLatestUpdateCount. |
You can add these to a request with RequestOptions#addQueryParam
Response Body Schema
{
value (Required): [
(Required){
groupId: String (Required)
groupType: String(IoTHubTag/DefaultNoTag) (Required)
createdDateTime: String (Required)
deviceCount: Integer (Optional)
subgroupsWithNewUpdatesAvailableCount: Integer (Optional)
subgroupsWithUpdatesInProgressCount: Integer (Optional)
subgroupsWithOnLatestUpdateCount: Integer (Optional)
deployments (Optional): [
String (Optional)
]
}
]
nextLink: String (Optional)
}
Parameters:
Returns:
listHealthOfDevices
public PagedFlux
Get list of device health.
Response Body Schema
{
value (Required): [
(Required){
deviceId: String (Required)
moduleId: String (Optional)
state: String(healthy/unhealthy) (Required)
digitalTwinModelId: String (Optional)
healthChecks (Required): [
(Required){
name: String (Optional)
result: String(success/userError) (Optional)
}
]
}
]
nextLink: String (Optional)
}
Parameters:
Returns:
listInstallableUpdatesForDeviceClass
public PagedFlux
Gets a list of installable updates for a device class.
Response Body Schema
{
value (Required): [
(Required){
updateId (Required): {
provider: String (Required)
name: String (Required)
version: String (Required)
}
description: String (Optional)
friendlyName: String (Optional)
}
]
nextLink: String (Optional)
}
Parameters:
Returns:
listLogCollections
public PagedFlux
Get all device diagnostics log collections.
Response Body Schema
{
value (Required): [
(Required){
operationId: String (Optional)
deviceList (Required): [
(Required){
deviceId: String (Required)
moduleId: String (Optional)
}
]
description: String (Optional)
createdDateTime: String (Optional)
lastActionDateTime: String (Optional)
status: String(NotStarted/Running/Succeeded/Failed) (Optional)
}
]
nextLink: String (Optional)
}
Parameters:
Returns:
listOperationStatuses
public PagedFlux
Get a list of all device import operations. Completed operations are kept for 7 days before auto-deleted.
Query Parameters
| ------ | ------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name | Type | Required | Description |
| filter | String | No | Restricts the set of operations returned. Only one specific filter is supported: "status eq 'NotStarted' or status eq 'Running'" |
| top | Integer | No | Specifies a non-negative integer n that limits the number of items returned from a collection. The service returns the number of available items up to but not greater than the specified value n. |
You can add these to a request with RequestOptions#addQueryParam
Response Body Schema
{
value (Required): [
(Required){
operationId: String (Required)
status: String(NotStarted/Running/Succeeded/Failed) (Required)
error (Optional): {
code: String (Required)
message: String (Required)
target: String (Optional)
details (Optional): [
(recursive schema, see above)
]
innererror (Optional): {
code: String (Required)
message: String (Optional)
errorDetail: String (Optional)
innerError (Optional): (recursive schema, see innerError above)
}
occurredDateTime: OffsetDateTime (Optional)
}
traceId: String (Optional)
lastActionDateTime: OffsetDateTime (Required)
createdDateTime: OffsetDateTime (Required)
etag: String (Optional)
}
]
nextLink: String (Optional)
}
Parameters:
Returns:
retryDeploymentWithResponse
public Mono
Retries a deployment with failed devices.
Response Body Schema
{
deploymentId: String (Required)
startDateTime: OffsetDateTime (Required)
update (Required): {
updateId (Required): {
provider: String (Required)
name: String (Required)
version: String (Required)
}
description: String (Optional)
friendlyName: String (Optional)
}
groupId: String (Required)
deviceClassSubgroups (Optional): [
String (Optional)
]
isCanceled: Boolean (Optional)
isRetried: Boolean (Optional)
rollbackPolicy (Optional): {
update (Required): (recursive schema, see update above)
failure (Required): {
devicesFailedPercentage: int (Required)
devicesFailedCount: int (Required)
}
}
isCloudInitiatedRollback: Boolean (Optional)
}
Parameters:
Returns:
startLogCollectionWithResponse
public Mono
Start the device diagnostics log collection on specified devices.
Request Body Schema
{
operationId: String (Optional)
deviceList (Required): [
(Required){
deviceId: String (Required)
moduleId: String (Optional)
}
]
description: String (Optional)
createdDateTime: String (Optional)
lastActionDateTime: String (Optional)
status: String(NotStarted/Running/Succeeded/Failed) (Optional)
}
Response Body Schema
{
operationId: String (Optional)
deviceList (Required): [
(Required){
deviceId: String (Required)
moduleId: String (Optional)
}
]
description: String (Optional)
createdDateTime: String (Optional)
lastActionDateTime: String (Optional)
status: String(NotStarted/Running/Succeeded/Failed) (Optional)
}
Parameters:
Returns:
stopDeploymentWithResponse
public Mono
Stops a deployment.
Response Body Schema
{
deploymentId: String (Required)
startDateTime: OffsetDateTime (Required)
update (Required): {
updateId (Required): {
provider: String (Required)
name: String (Required)
version: String (Required)
}
description: String (Optional)
friendlyName: String (Optional)
}
groupId: String (Required)
deviceClassSubgroups (Optional): [
String (Optional)
]
isCanceled: Boolean (Optional)
isRetried: Boolean (Optional)
rollbackPolicy (Optional): {
update (Required): (recursive schema, see update above)
failure (Required): {
devicesFailedPercentage: int (Required)
devicesFailedCount: int (Required)
}
}
isCloudInitiatedRollback: Boolean (Optional)
}
Parameters:
Returns:
updateDeviceClassWithResponse
public Mono
Update device class details.
Request Body Schema
{
friendlyName: String (Required)
}
Response Body Schema
{
deviceClassId: String (Required)
friendlyName: String (Optional)
deviceClassProperties (Required): {
contractModel (Optional): {
id: String (Required)
name: String (Required)
}
compatProperties (Required): {
String: String (Required)
}
}
bestCompatibleUpdate (Optional): {
updateId (Required): {
provider: String (Required)
name: String (Required)
version: String (Required)
}
description: String (Optional)
friendlyName: String (Optional)
}
}
Parameters:
Returns:
Applies to
Azure SDK for Java