Dispositivi - Ottieni

  • Articolo

Riferimento

Servizio: anteprima della documentazione

Versione API: 2022-09-01-preview

Scarica un dispositivo. Usare '.nonssigned' o '.default' per il gruppo di dispositivi e i nomi dei prodotti quando un dispositivo non appartiene a un gruppo di dispositivi e a un prodotto.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/products/{productName}/deviceGroups/{deviceGroupName}/devices/{deviceName}?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.
deviceName Percorso Vero Stringa Nome dispositivo
api-version Query Vero Stringa Versione dell'API da usare per questa operazione.

Risposte

Nome Digitare Descrizione
200 OK Dispositivo 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_Get

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/00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000?api-version=2022-09-01-preview

Risposta di esempio

200

      {
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup1/providers/Microsoft.AzureSphere/catalogs/MyCatalog1/products/myProduct1/deviceGroups/myDeviceGroup1/devices/00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
        "name": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
        "properties": {
          "chipSku": "MyChipSku1",
          "lastAvailableOsVersion": "AvailableOsVersion1",
          "lastInstalledOsVersion": "InstalledOsVersion1",
          "lastOsUpdateUtc": "2022-09-30T23:54:21.96Z",
          "lastUpdateRequestUtc": "2022-10-01T23:54:21.96Z"
        }
      }

Definizioni

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

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"

ErrorResponse

Risposta a un errore

Nome Digitare Descrizione

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)

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.

createdByType

Tipo di identità che ha creato la risorsa.

Nome Digitare Descrizione
Utente Stringa
Applicazione Stringa
ManagedIdentity Stringa
Chiave Stringa

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

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