Instance - List By Resource Group

Riferimento

Servizio:: IoT Operations

Versione API:: 2025-04-01

Elencare le risorse InstanceResource per gruppo di risorse

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperations/instances?api-version=2025-04-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
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	Operazione di Azure 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_ListByResourceGroup

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "properties": {
        "provisioningState": "Succeeded",
        "version": "vjjbmunthiphfmekvxgxcxkzdwjti",
        "schemaRegistryRef": {
          "resourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup123/providers/Microsoft.DeviceRegistry/schemaRegistries/resource-name123"
        },
        "description": "vmujggxdvxk"
      },
      "extendedLocation": {
        "name": "qmbrfwcpwwhggszhrdjv",
        "type": "CustomLocation"
      },
      "identity": {
        "principalId": "4a6e4195-75b8-4685-aa0c-0b5704779327",
        "tenantId": "ed060aa2-71ff-4d3f-99c4-a9138356fdec",
        "type": "None",
        "userAssignedIdentities": {}
      },
      "tags": {},
      "location": "xvewadyhycrjpu",
      "id": "/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup123/providers/Microsoft.IoTOperations/instances/resource-name123",
      "name": "llptmlifnqqwairx",
      "type": "qwrfzxjfxvismlqvigot",
      "systemData": {
        "createdBy": "ssvaslsmudloholronopqyxjcu",
        "createdByType": "User",
        "createdAt": "2024-08-09T18:13:29.389Z",
        "lastModifiedBy": "gnicpuszwd",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2024-08-09T18:13:29.389Z"
      }
    }
  ],
  "nextLink": "https://microsoft.com/a"
}

Definizioni

Nome	Descrizione
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 località di Azure. Offrono un modo per usare i cluster Kubernetes con abilitazione di Azure ARC come percorsi di destinazione per la distribuzione delle istanze dei servizi di Azure.
ExtendedLocationType	Enumerazione che definisce il tipo di ExtendedLocation accettato.
InstanceFeature	Funzionalità dell'istanza di AIO.
InstanceFeatureMode	Modalità di definizione dell'enumerazione di una funzionalità.
InstanceProperties	Proprietà della risorsa Istanza.
InstanceResource	Una risorsa istanza è 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	Enumerazione che definisce lo stato della risorsa.
SchemaRegistryRef	Riferimento al Registro schemi per questa istanza di AIO.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
UserAssignedIdentity	Proprietà di identità assegnate dall'utente

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

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

ErrorDetail

Object

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

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ExtendedLocation

Object

La posizione estesa è un'estensione delle località di Azure. Offrono un modo per usare i cluster Kubernetes con abilitazione di Azure ARC come percorsi 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

Enumerazione che definisce il tipo di ExtendedLocation accettato.

Valore	Descrizione
CustomLocation	Tipo CustomLocation

InstanceFeature

Object

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
Disabled	Rifiutare esplicitamente una funzionalità
Preview	Acconsentire esplicitamente all'abilitazione di una funzionalità di anteprima
Stable	Acconsentire esplicitamente all'abilitazione di una funzionalità stabile

InstanceProperties

Object

Proprietà della risorsa Istanza.

Nome	Tipo	Descrizione
description	string	Descrizione dettagliata dell'istanza.
features	<string, InstanceFeature>	Funzionalità dell'istanza di AIO.
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

Object

Una risorsa istanza è 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 della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

InstanceResourceListResult

Object

Risposta di un'operazione di elenco InstanceResource.

Nome	Tipo	Descrizione
nextLink	string (uri)	Collegamento alla pagina successiva di elementi
value	InstanceResource[]	Elementi InstanceResource in questa pagina

ManagedServiceIdentity

Object

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
SystemAssigned,UserAssigned
UserAssigned

ProvisioningState

Enumerazione

Enumerazione che definisce lo stato della risorsa.

Valore	Descrizione
Accepted	La risorsa è stata accettata.
Canceled	La creazione della risorsa è stata annullata.
Deleting	La risorsa è l'eliminazione.
Failed	Creazione della risorsa non riuscita.
Provisioning	Viene effettuato il provisioning della risorsa.
Succeeded	La risorsa è stata creata.
Updating	La risorsa è l'aggiornamento.

SchemaRegistryRef

Object

Riferimento al Registro schemi per questa istanza di AIO.

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

systemData

Object

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)	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

Object

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 Resource Group

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Instance_ListByResourceGroup

Esempio di richiesta

Risposta di esempio

Definizioni

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationType

InstanceFeature

InstanceFeatureMode

InstanceProperties

InstanceResource

InstanceResourceListResult

ManagedServiceIdentity

ManagedServiceIdentityType

ProvisioningState

SchemaRegistryRef

systemData

UserAssignedIdentity