azure.iot.deviceupdate.aio.operations package¶
-
class
azure.iot.deviceupdate.aio.operations.
UpdatesOperations
(client, config, serializer, deserializer)[source]¶ UpdatesOperations async operations.
You should not instantiate this class directly. Instead, you should create a Client instance that instantiates it for you and attaches it as an attribute.
- Variables
models – Alias to model classes used in this operation group.
- Parameters
client – Client for service requests.
config – Configuration of service client.
serializer – An object model serializer.
deserializer – An object model deserializer.
-
async
delete_update
(provider: str, name: str, version: str, **kwargs) → None[source]¶ Delete a specific update version.
- Parameters
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
None, or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
async
get_file
(provider: str, name: str, version: str, file_id: str, access_condition: Optional[_models.AccessCondition] = None, **kwargs) → Optional[azure.iot.deviceupdate.models._models_py3.File][source]¶ Get a specific update file from the version.
- Parameters
provider (str) – Update provider.
name (str) – Update name.
version (str) – Update version.
file_id (str) – File identifier.
access_condition (AccessCondition) – Parameter group.
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
File, or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
get_files
(provider: str, name: str, version: str, **kwargs) → AsyncIterable[azure.iot.deviceupdate.models._models_py3.PageableListOfStrings][source]¶ Get a list of all update file identifiers for the specified version.
- Parameters
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
An iterator like instance of either PageableListOfStrings or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
get_names
(provider: str, **kwargs) → AsyncIterable[azure.iot.deviceupdate.models._models_py3.PageableListOfStrings][source]¶ Get a list of all update names that match the specified provider.
- Parameters
provider (str) – Update provider.
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
An iterator like instance of either PageableListOfStrings or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
async
get_operation
(operation_id: str, access_condition: Optional[_models.AccessCondition] = None, **kwargs) → Optional[azure.iot.deviceupdate.models._models_py3.Operation][source]¶ Retrieve operation status.
- Parameters
operation_id (str) – Operation identifier.
access_condition (AccessCondition) – Parameter group.
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
Operation, or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
get_operations
(filter: Optional[str] = None, top: Optional[int] = None, **kwargs) → AsyncIterable[azure.iot.deviceupdate.models._models_py3.PageableListOfOperations][source]¶ Get a list of all import update operations. Completed operations are kept for 7 days before auto-deleted. Delete operations are not returned by this API version.
- Parameters
filter (str) – Restricts the set of operations returned. Only one specific filter is supported: “status eq ‘NotStarted’ or status eq ‘Running’”.
top (int) – 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.
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
An iterator like instance of either PageableListOfOperations or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
get_providers
(**kwargs) → AsyncIterable[azure.iot.deviceupdate.models._models_py3.PageableListOfStrings][source]¶ Get a list of all update providers that have been imported to Device Update for IoT Hub.
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
An iterator like instance of either PageableListOfStrings or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
async
get_update
(provider: str, name: str, version: str, access_condition: Optional[_models.AccessCondition] = None, **kwargs) → Optional[azure.iot.deviceupdate.models._models_py3.Update][source]¶ Get a specific update version.
- Parameters
provider (str) – Update provider.
name (str) – Update name.
version (str) – Update version.
access_condition (AccessCondition) – Parameter group.
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
Update, or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
get_versions
(provider: str, name: str, **kwargs) → AsyncIterable[azure.iot.deviceupdate.models._models_py3.PageableListOfStrings][source]¶ Get a list of all update versions that match the specified provider and name.
- Parameters
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
An iterator like instance of either PageableListOfStrings or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
async
import_update
(update_to_import: azure.iot.deviceupdate.models._models_py3.ImportUpdateInput, **kwargs) → None[source]¶ Import new update version.
- Parameters
update_to_import (ImportUpdateInput) – The update to be imported.
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
None, or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
models
= <module 'azure.iot.deviceupdate.models' from '/mnt/vss/_work/1/s/sdk/deviceupdate/azure-iot-deviceupdate/.tox/sphinx/lib/python3.6/site-packages/azure/iot/deviceupdate/models/__init__.py'>¶
-
class
azure.iot.deviceupdate.aio.operations.
DevicesOperations
(client, config, serializer, deserializer)[source]¶ DevicesOperations async operations.
You should not instantiate this class directly. Instead, you should create a Client instance that instantiates it for you and attaches it as an attribute.
- Variables
models – Alias to model classes used in this operation group.
- Parameters
client – Client for service requests.
config – Configuration of service client.
serializer – An object model serializer.
deserializer – An object model deserializer.
-
async
create_or_update_group
(group_id: str, group: azure.iot.deviceupdate.models._models_py3.Group, **kwargs) → azure.iot.deviceupdate.models._models_py3.Group[source]¶ Create or update a device group.
-
get_all_device_classes
(**kwargs) → AsyncIterable[azure.iot.deviceupdate.models._models_py3.PageableListOfDeviceClasses][source]¶ Gets a list of all device classes (unique combinations of device manufacturer and model) for all devices connected to Device Update for IoT Hub.
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
An iterator like instance of either PageableListOfDeviceClasses or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
Gets a list of available group device tags for all devices connected to Device Update for IoT Hub.
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
An iterator like instance of either PageableListOfDeviceTags or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
get_all_devices
(filter: Optional[str] = None, **kwargs) → AsyncIterable[azure.iot.deviceupdate.models._models_py3.PageableListOfDevices][source]¶ Gets a list of devices connected to Device Update for IoT Hub.
- Parameters
filter (str) – Restricts the set of devices returned. You can only filter on device GroupId.
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
An iterator like instance of either PageableListOfDevices or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
get_all_groups
(**kwargs) → AsyncIterable[azure.iot.deviceupdate.models._models_py3.PageableListOfGroups][source]¶ Gets a list of all device groups.
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
An iterator like instance of either PageableListOfGroups or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
async
get_device
(device_id: str, **kwargs) → azure.iot.deviceupdate.models._models_py3.Device[source]¶ Gets the device properties and latest deployment status for a device connected to Device Update for IoT Hub.
-
async
get_device_class
(device_class_id: str, **kwargs) → azure.iot.deviceupdate.models._models_py3.DeviceClass[source]¶ Gets the properties of a device class.
-
get_device_class_device_ids
(device_class_id: str, **kwargs) → AsyncIterable[azure.iot.deviceupdate.models._models_py3.PageableListOfStrings][source]¶ Gets a list of device identifiers in a device class.
- Parameters
device_class_id (str) – Device class identifier.
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
An iterator like instance of either PageableListOfStrings or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
get_device_class_installable_updates
(device_class_id: str, **kwargs) → AsyncIterable[azure.iot.deviceupdate.models._models_py3.PageableListOfUpdateIds][source]¶ Gets a list of installable updates for a device class.
- Parameters
device_class_id (str) – Device class identifier.
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
An iterator like instance of either PageableListOfUpdateIds or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
async
get_device_tag
(tag_name: str, **kwargs) → azure.iot.deviceupdate.models._models_py3.DeviceTag[source]¶ Gets a count of how many devices have a device tag.
-
async
get_group
(group_id: str, **kwargs) → azure.iot.deviceupdate.models._models_py3.Group[source]¶ Gets the properties of a group.
-
get_group_best_updates
(group_id: str, filter: Optional[str] = None, **kwargs) → AsyncIterable[azure.iot.deviceupdate.models._models_py3.PageableListOfUpdatableDevices][source]¶ Get the best available updates for a group and a count of how many devices need each update.
- Parameters
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
An iterator like instance of either PageableListOfUpdatableDevices or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
async
get_group_update_compliance
(group_id: str, **kwargs) → azure.iot.deviceupdate.models._models_py3.UpdateCompliance[source]¶ Get 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.
-
async
get_update_compliance
(**kwargs) → azure.iot.deviceupdate.models._models_py3.UpdateCompliance[source]¶ Gets the breakdown of how many devices are on their latest update, have new updates available, or are in progress receiving new updates.
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
UpdateCompliance, or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
models
= <module 'azure.iot.deviceupdate.models' from '/mnt/vss/_work/1/s/sdk/deviceupdate/azure-iot-deviceupdate/.tox/sphinx/lib/python3.6/site-packages/azure/iot/deviceupdate/models/__init__.py'>¶
-
class
azure.iot.deviceupdate.aio.operations.
DeploymentsOperations
(client, config, serializer, deserializer)[source]¶ DeploymentsOperations async operations.
You should not instantiate this class directly. Instead, you should create a Client instance that instantiates it for you and attaches it as an attribute.
- Variables
models – Alias to model classes used in this operation group.
- Parameters
client – Client for service requests.
config – Configuration of service client.
serializer – An object model serializer.
deserializer – An object model deserializer.
-
async
cancel_deployment
(deployment_id: str, **kwargs) → azure.iot.deviceupdate.models._models_py3.Deployment[source]¶ Cancels a deployment.
-
async
create_or_update_deployment
(deployment_id: str, deployment: azure.iot.deviceupdate.models._models_py3.Deployment, **kwargs) → azure.iot.deviceupdate.models._models_py3.Deployment[source]¶ Creates or updates a deployment.
- Parameters
deployment_id (str) – Deployment identifier.
deployment (Deployment) – The deployment properties.
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
Deployment, or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
get_all_deployments
(filter: Optional[str] = None, **kwargs) → AsyncIterable[azure.iot.deviceupdate.models._models_py3.PageableListOfDeployments][source]¶ Gets a list of deployments.
- Parameters
filter (str) – Restricts the set of deployments returned. You can filter on update Provider, Name and Version property.
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
An iterator like instance of either PageableListOfDeployments or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
async
get_deployment
(deployment_id: str, **kwargs) → azure.iot.deviceupdate.models._models_py3.Deployment[source]¶ Gets the properties of a deployment.
-
get_deployment_devices
(deployment_id: str, filter: Optional[str] = None, **kwargs) → AsyncIterable[azure.iot.deviceupdate.models._models_py3.PageableListOfDeploymentDeviceStates][source]¶ Gets a list of devices in a deployment along with their state. Useful for getting a list of failed devices.
- Parameters
- Keyword Arguments
cls (callable) – A custom type or function that will be passed the direct response
- Returns
An iterator like instance of either PageableListOfDeploymentDeviceStates or the result of cls(response)
- Return type
- Raises
~azure.core.exceptions.HttpResponseError
-
async
get_deployment_status
(deployment_id: str, **kwargs) → azure.iot.deviceupdate.models._models_py3.DeploymentStatus[source]¶ Gets the status of a deployment including a breakdown of how many devices in the deployment are in progress, completed, or failed.
-
async
retry_deployment
(deployment_id: str, **kwargs) → azure.iot.deviceupdate.models._models_py3.Deployment[source]¶ Retries a deployment with failed devices.
-
models
= <module 'azure.iot.deviceupdate.models' from '/mnt/vss/_work/1/s/sdk/deviceupdate/azure-iot-deviceupdate/.tox/sphinx/lib/python3.6/site-packages/azure/iot/deviceupdate/models/__init__.py'>¶