Dispositivi - Elenco per gruppo di dispositivi

Riferimento

Servizio: anteprima della documentazione

Versione API: 2022-09-01-preview

Elencare le risorse dispositivo per DeviceGroup. '.default' e '.unassigned' sono valori definiti dal sistema e non possono essere utilizzati per il nome del prodotto o del gruppo di dispositivi.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/products/{productName}/deviceGroups/{deviceGroupName}/devices?api-version=2022-09-01-preview

Parametri URI

Nome	Pollici	Obbligatorio	Digitare	Descrizione
Subscriptionid	Percorso	Vero	Stringa	ID dell'abbonamento di destinazione.
resourceGroupName	Percorso	Vero	Stringa	Nome del gruppo di risorse. Il nome non ha distinzione tra maiuscole e minuscole.
catalogName	Percorso	Vero	Stringa	Nome del catalogo
Productname	Percorso	Vero	Stringa	Nome del prodotto.
deviceGroupName	Percorso	Vero	Stringa	Nome del gruppo di dispositivi.
api-version	Query	Vero	Stringa	Versione dell'API da usare per questa operazione.

Risposte

Nome	Digitare	Descrizione
200 OK	DeviceListResult	Operazione ARM completata.
Altri codici di stato	ErrorResponse	Una risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2

Flusso: implicito

URL di autorizzazione:https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome ambito	Descrizione dell'ambito
user_impersonation	rappresentare il tuo account utente

Esempi

Devices_ListByDeviceGroup

Richiesta di esempio

      GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup1/providers/Microsoft.AzureSphere/catalogs/MyCatalog1/products/MyProduct1/deviceGroups/myDeviceGroup1/devices?api-version=2022-09-01-preview

Risposta di esempio

200

      {
        "value": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup1/providers/Microsoft.AzureSphere/catalogs/MyCatalog1/products/myProduct1/deviceGroups/myDeviceGroup1/devices/00000000-0000-0000-0000-000000000001",
            "properties": {}
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup1/providers/Microsoft.AzureSphere/catalogs/MyCatalog1/products/myProduct1/deviceGroups/myDeviceGroup1/devices/00000000-0000-0000-0000-000000000002",
            "properties": {}
          }
        ]
      }

Definizioni

Nome	Descrizione
DeviceListResult	Risposta dell'operazione di un elenco di dispositivi.
ErrorResponse	Risposta a un errore
Dispositivo	Una risorsa dispositivo appartenente a una risorsa del gruppo di dispositivi.
Dettagli errore	Il dettaglio dell'errore.
ProvisioningState
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
createdByType	Tipo di identità che ha creato la risorsa.

DeviceListResult

Risposta dell'operazione di un elenco di dispositivi.

Nome	Digitare	Descrizione
Valore	Dispositivo[]	Elementi del dispositivo in questa pagina
nextLink	Stringa	Collegamento alla pagina successiva di elementi

ErrorResponse

Risposta a un errore

Nome	Digitare	Descrizione

Dispositivo

Una risorsa dispositivo appartenente a una risorsa del gruppo di dispositivi.

Nome	Digitare	Descrizione
properties.deviceId	Stringa	ID dispositivo
properties.chipSku	Stringa	SKU del chip
properties.lastAvailableOsVersion	Stringa	Versione del sistema operativo disponibile per l'installazione quando viene richiesto l'aggiornamento
properties.lastInstalledOsVersion	Stringa	Versione del sistema operativo in esecuzione nel dispositivo quando è richiesto l'aggiornamento
properties.lastOsUpdateUtc	Stringa	Ora in cui è richiesto l'aggiornamento e è disponibile una nuova versione del sistema operativo
properties.lastUpdateRequestUtc	Stringa	Ora dell'ultima richiesta di aggiornamento
Id	Stringa	ID risorsa completa per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
Nome	Stringa	Il nome della risorsa
digitare	Stringa	Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

Dettagli errore

Il dettaglio dell'errore.

Nome	Digitare	Descrizione
Codice	Stringa	Codice di errore.
Messaggio	Stringa	Messaggio di errore.
bersaglio	Stringa	Destinazione dell'errore.
Dettagli	ErrorDetail[]	Dettagli dell'errore.
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.

ProvisioningState

Nome	Digitare	Descrizione
Riuscito	Stringa
Fallito	Stringa
Annullato	Stringa
Provisioning	Stringa
Aggiornamento	Stringa
Eliminazione	Stringa
Accettato	Stringa

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Digitare	Descrizione
createdBy	Stringa	Identità che ha creato la risorsa.
createdAt	Stringa	Timestamp della creazione di risorse (UTC).
lastModifiedBy	Stringa	Identità che ha modificato per ultima la risorsa.
lastModifiedAt	Stringa	Timestamp dell'ultima modifica della risorsa (UTC)

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Digitare	Descrizione
digitare	Stringa	Tipo di informazioni aggiuntive.
Informazioni	Oggetto	Le informazioni aggiuntive.

createdByType

Tipo di identità che ha creato la risorsa.

Nome	Digitare	Descrizione
Utente	Stringa
Applicazione	Stringa
ManagedIdentity	Stringa
Chiave	Stringa