Device Update - List Versions

Service:

Device Update

Version d'API:

2022-10-01

Obtenez la liste de toutes les versions de mise à jour qui correspondent au fournisseur et au nom spécifiés.

GET https://{endpoint}/deviceUpdate/{instanceId}/updates/providers/{provider}/names/{name}/versions?api-version=2022-10-01

Avec des paramètres facultatifs:

GET https://{endpoint}/deviceUpdate/{instanceId}/updates/providers/{provider}/names/{name}/versions?api-version=2022-10-01&filter={filter}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
endpoint	path	True	string (url)	Point de terminaison du compte Device Update pour IoT Hub (nom d’hôte uniquement, aucun protocole).
instanceId	path	True	string	Identificateur d’instance de compte IoT Hub device Update.
name	path	True	string	Nom de mise à jour.
provider	path	True	string	Mettre à jour le fournisseur.
api-version	query	True	string	Version de l’API à utiliser avec la demande cliente.
filter	query		string	Facultatif pour filtrer les mises à jour par propriété isDeployable.

Réponses

Nom	Type	Description
200 OK	StringsList	Toutes les versions de mise à jour qui correspondent au fournisseur et au nom spécifiés ou à la liste vide s’il n’y en a aucun.
Other Status Codes	ErrorResponse	Réponse par défaut.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
https://api.adu.microsoft.com/.default	Étendue d’autorisation par défaut.

Exemples

DeviceUpdate_ListVersions

Exemple de requête

HTTP

GET https://contoso.api.adu.microsoft.com/deviceUpdate/blue/updates/providers/microsoft/names/adu/versions?api-version=2022-10-01

Exemple de réponse

Code d’état:

200

{
  "value": [
    "1.0.0.0",
    "1.0.0.1"
  ]
}

Définitions

Nom	Description
Error	Détails de l’erreur.
ErrorResponse	Réponse d’erreur courante.
InnerError	Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.
StringsList	Liste des chaînes avec prise en charge de la pagination du serveur.

Error

Object

Détails de l’erreur.

Nom	Type	Description
code	string	Code d’erreur défini par le serveur.
details	Error[]	Tableau d’erreurs qui ont conduit à l’erreur signalée.
innererror	InnerError	Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.
message	string	Représentation lisible par l’homme de l’erreur.
occurredDateTime	string (date-time)	Date et heure UTC lorsque l’erreur s’est produite.
target	string	Cible de l’erreur.

ErrorResponse

Object

Réponse d’erreur courante.

Nom	Type	Description
error	Error	Détails de l’erreur.

InnerError

Object

Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.

Nom	Type	Description
code	string	Code d’erreur plus spécifique que ce qui a été fourni par l’erreur contenante.
errorDetail	string	Message d’erreur interne ou d’exception.
innerError	InnerError	Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.
message	string	Représentation lisible par l’homme de l’erreur.

StringsList

Object

Liste des chaînes avec prise en charge de la pagination du serveur.

Nom	Type	Description
nextLink	string	Lien vers la page suivante des éléments.
value	string[]	Collection d’éléments paginables.