Instance - List By Subscription

Servizio:: IoT Operations

Versione API:: 2026-03-01

Elencare le risorse InstanceResource in base all'ID sottoscrizione

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.IoTOperations/instances?api-version=2026-03-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	InstanceResourceListResult	L'operazione di Azure è stata completata correttamente.
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

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

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Instance_ListBySubscription

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/providers/Microsoft.IoTOperations/instances?api-version=2026-03-01

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "properties": {
        "provisioningState": "Succeeded",
        "version": "1.2.0",
        "schemaRegistryRef": {
          "resourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup123/providers/Microsoft.DeviceRegistry/schemaRegistries/resource-name123"
        },
        "description": "empgqmbhvklcqlyahmdsjemlep"
      },
      "extendedLocation": {
        "name": "/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/resourceGroups/rgiotoperations/providers/Microsoft.ExtendedLocation/customLocations/resource-123",
        "type": "CustomLocation"
      },
      "identity": {
        "principalId": "4a6e4195-75b8-4685-aa0c-0b5704779327",
        "tenantId": "ed060aa2-71ff-4d3f-99c4-a9138356fdec",
        "type": "None",
        "userAssignedIdentities": {}
      },
      "tags": {},
      "location": "eastus2",
      "id": "/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup123/providers/Microsoft.IoTOperations/instances/resource-name123",
      "name": "llptmlifnqqwairx",
      "type": "Microsoft.IoTOperations/instances",
      "systemData": {
        "createdBy": "contosouser",
        "createdByType": "User",
        "createdAt": "2024-08-09T18:13:29.389Z",
        "lastModifiedBy": "contosouser",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2024-08-09T18:13:29.389Z"
      }
    }
  ],
  "nextLink": "https://microsoft.com/a"
}

Definizioni

Nome	Descrizione
AzureDeviceRegistryNamespaceRef	Informazioni di riferimento sullo spazio dei nomi del Registro dispositivi di Azure.
createdByType	Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ExtendedLocation	La posizione estesa è un'estensione delle posizioni di Azure. Forniscono un modo per usare i cluster Kubernetes abilitati per Azure ARC come posizioni di destinazione per la distribuzione delle istanze dei servizi di Azure.
ExtendedLocationType	Tipo di enumerazione che definisce ExtendedLocation accettato.
InstanceFeature	Funzionalità dell'istanza di AIO.
InstanceFeatureMode	Modalità di definizione dell'enumerazione di una funzionalità.
InstanceProperties	Proprietà della risorsa Instance.
InstanceResource	Una risorsa Instance è un contenitore logico per un set di risorse figlio.
InstanceResourceListResult	Risposta di un'operazione di elenco InstanceResource.
ManagedServiceIdentity	Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)
ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
ProvisioningState	L'enumerazione che definisce lo stato della risorsa.
ResourceHealthState	Stato di integrità della risorsa.
SchemaRegistryRef	Riferimento al Registro schemi per questa istanza di AIO.
SecretProviderClassRef	Riferimento alla classe del provider di segreti AIO.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
UserAssignedIdentity	Proprietà di identità assegnate dall'utente

AzureDeviceRegistryNamespaceRef

Oggetto

Informazioni di riferimento sullo spazio dei nomi del Registro dispositivi di Azure.

Nome	Tipo	Descrizione
resourceId	string (arm-id)	ID risorsa dello spazio dei nomi del Registro dispositivi di Azure.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ExtendedLocation

Oggetto

La posizione estesa è un'estensione delle posizioni di Azure. Forniscono un modo per usare i cluster Kubernetes abilitati per Azure ARC come posizioni di destinazione per la distribuzione delle istanze dei servizi di Azure.

Nome	Tipo	Descrizione
name	string	Nome della posizione estesa.
type	ExtendedLocationType	Tipo di ExtendedLocation.

ExtendedLocationType

Enumerazione

Tipo di enumerazione che definisce ExtendedLocation accettato.

Valore	Descrizione
CustomLocation	Tipo di posizione personalizzata

InstanceFeature

Oggetto

Funzionalità dell'istanza di AIO.

Nome	Tipo	Descrizione
mode	InstanceFeatureMode	Stato della funzionalità.
settings	object	Impostazioni della funzionalità.

InstanceFeatureMode

Enumerazione

Modalità di definizione dell'enumerazione di una funzionalità.

Valore	Descrizione
Stable	Acconsentire esplicitamente all'attivazione di una funzione stabile
Preview	Acconsentire esplicitamente all'abilitazione di una funzione di anteprima
Disabled	Rifiutare esplicitamente una funzionalità

InstanceProperties

Oggetto

Proprietà della risorsa Instance.

Nome	Tipo	Valore predefinito	Descrizione
adrNamespaceRef	AzureDeviceRegistryNamespaceRef		Spazio dei nomi del Registro dispositivi di Azure usato da Asset, Asset individuati e dispositivi
defaultSecretProviderClassRef	SecretProviderClassRef		Riferimento alla classe del provider di segreti AIO.
description	string		Descrizione dettagliata dell'istanza.
features	<string, InstanceFeature>		Funzionalità dell'istanza di AIO.
healthState	ResourceHealthState	Unknown	Stato di integrità della risorsa.
provisioningState	ProvisioningState		Stato dell'ultima operazione.
schemaRegistryRef	SchemaRegistryRef		Riferimento al Registro schemi per questa istanza di AIO.
version	string		Versione di Azure IoT Operations.

InstanceResource

Oggetto

Una risorsa Instance è un contenitore logico per un set di risorse figlio.

Nome	Tipo	Descrizione
extendedLocation	ExtendedLocation	Posizione perimetrale della risorsa.
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Identità del servizio gestito assegnate a questa risorsa.
location	string	Posizione geografica in cui risiede la risorsa
name	string	Nome della risorsa
properties	InstanceProperties	Proprietà specifiche della risorsa.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object	Tag di risorsa.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

InstanceResourceListResult

Oggetto

Risposta di un'operazione di elenco InstanceResource.

Nome	Tipo	Descrizione
nextLink	string (uri)	Il link alla pagina successiva degli elementi
value	InstanceResource[]	Elementi InstanceResource in questa pagina

ManagedServiceIdentity

Oggetto

Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)

Nome	Tipo	Descrizione
principalId	string (uuid)	ID entità servizio dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
tenantId	string (uuid)	ID tenant dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
type	ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
userAssignedIdentities	<string, UserAssignedIdentity>	identità User-Assigned Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.

ManagedServiceIdentityType

Enumerazione

Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).

Valore	Descrizione
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

ProvisioningState

Enumerazione

L'enumerazione che definisce lo stato della risorsa.

Valore	Descrizione
Succeeded	La risorsa è stata creata.
Failed	Creazione della risorsa non riuscita.
Canceled	La creazione delle risorse è stata annullata.
Provisioning	È in corso il provisioning della risorsa.
Updating	La risorsa è in fase di aggiornamento.
Deleting	La risorsa è in fase di eliminazione.
Accepted	La risorsa è stata accettata.

ResourceHealthState

Enumerazione

Stato di integrità della risorsa.

Valore	Descrizione
Available	La risorsa è disponibile e funziona come previsto.
Degraded	L'integrità delle risorse è ridotta.
Unavailable	La risorsa non funziona come previsto.
Unknown	Lo stato della risorsa è sconosciuto.

SchemaRegistryRef

Oggetto

Riferimento al Registro schemi per questa istanza di AIO.

Nome	Tipo	Descrizione
resourceId	string (arm-id)	ID risorsa del Registro schemi.

SecretProviderClassRef

Oggetto

Riferimento alla classe del provider di segreti AIO.

Nome	Tipo	Descrizione
resourceId	string (arm-id)	L'ID risorsa della classe del provider AIO Secret.

systemData

Oggetto

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

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Il timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

UserAssignedIdentity

Oggetto

Proprietà di identità assegnate dall'utente

Nome	Tipo	Descrizione
clientId	string (uuid)	ID client dell'identità assegnata.
principalId	string (uuid)	ID entità dell'identità assegnata.

Condividi tramite

Instance - List By Subscription

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Instance_ListBySubscription

Esempio di richiesta

Risposta di esempio

Definizioni

AzureDeviceRegistryNamespaceRef

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationType

InstanceFeature

InstanceFeatureMode

InstanceProperties

InstanceResource

InstanceResourceListResult

ManagedServiceIdentity

ManagedServiceIdentityType

ProvisioningState

ResourceHealthState

SchemaRegistryRef

SecretProviderClassRef

systemData

UserAssignedIdentity