Instance - List By Subscription

Service:: IoT Operations

API-versie:: 2026-03-01

Vermeld InstanceResource-resources op abonnements-id

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

URI-parameters

Name	In	Vereist	Type	Description
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	InstanceResourceListResult	Azure-bewerking is voltooid.
Other Status Codes	ErrorResponse	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Instance_ListBySubscription

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:: 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"
}

Definities

Name	Description
AzureDeviceRegistryNamespaceRef	Naslaginformatie over Azure Device Registry Namespace.
createdByType	Het type identiteit waarmee de resource is gemaakt.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
ExtendedLocation	Uitgebreide locatie is een uitbreiding van Azure-locaties. Ze bieden een manier om hun Azure ARC-enabled Kubernetes-clusters te gebruiken als doellocaties voor het implementeren van Azure-servicesexemplaren.
ExtendedLocationType	Het enum definiërende type ExtendedLocation geaccepteerd.
InstanceFeature	De functies van het AIO-exemplaar.
InstanceFeatureMode	De enum definiërende modus van een functie.
InstanceProperties	De eigenschappen van de instantieresource.
InstanceResource	Een exemplaarresource is een logische container voor een set onderliggende resources.
InstanceResourceListResult	Het antwoord van een bewerking in de InstanceResource-lijst.
ManagedServiceIdentity	Beheerde service-identiteit (door het systeem toegewezen en/of door de gebruiker toegewezen identiteiten)
ManagedServiceIdentityType	Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).
ProvisioningState	De enum die de status van de resource definieert.
ResourceHealthState	De gezondheidstoestand van de bron.
SchemaRegistryRef	De verwijzing naar het schemaregister voor dit AIO-exemplaar.
SecretProviderClassRef	De verwijzing naar de AIO Secret provider-klasse.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
UserAssignedIdentity	Door de gebruiker toegewezen identiteitseigenschappen

AzureDeviceRegistryNamespaceRef

Object

Naslaginformatie over Azure Device Registry Namespace.

Name	Type	Description
resourceId	string (arm-id)	De resource-id van de Azure Device Registry-naamruimte.

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

ExtendedLocation

Object

Uitgebreide locatie is een uitbreiding van Azure-locaties. Ze bieden een manier om hun Azure ARC-enabled Kubernetes-clusters te gebruiken als doellocaties voor het implementeren van Azure-servicesexemplaren.

Name	Type	Description
name	string	De naam van de uitgebreide locatie.
type	ExtendedLocationType	Type UitgebreideLocatie.

ExtendedLocationType

Opsomming

Het enum definiërende type ExtendedLocation geaccepteerd.

Waarde	Description
CustomLocation	CustomLocation-type

InstanceFeature

Object

De functies van het AIO-exemplaar.

Name	Type	Description
mode	InstanceFeatureMode	De status van de functie.
settings	object	De instellingen van de functie.

InstanceFeatureMode

Opsomming

De enum definiërende modus van een functie.

Waarde	Description
Stable	Meld u aan om een stabiele functie in te schakelen
Preview	Meld u aan om een voorbeeldfunctie in te schakelen
Disabled	Afmelden voor een functie

InstanceProperties

Object

De eigenschappen van de instantieresource.

Name	Type	Default value	Description
adrNamespaceRef	AzureDeviceRegistryNamespaceRef		De Azure Device Registry-naamruimte die wordt gebruikt door activa, gedetecteerde activa en apparaten
defaultSecretProviderClassRef	SecretProviderClassRef		De verwijzing naar de AIO Secret provider-klasse.
description	string		Gedetailleerde beschrijving van het exemplaar.
features	<string, InstanceFeature>		De functies van het AIO-exemplaar.
healthState	ResourceHealthState	Unknown	De gezondheidstoestand van de bron.
provisioningState	ProvisioningState		De status van de laatste bewerking.
schemaRegistryRef	SchemaRegistryRef		De verwijzing naar het schemaregister voor dit AIO-exemplaar.
version	string		De Azure IoT Operations-versie.

InstanceResource

Object

Een exemplaarresource is een logische container voor een set onderliggende resources.

Name	Type	Description
extendedLocation	ExtendedLocation	Edge-locatie van de resource.
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	De beheerde service-identiteiten die zijn toegewezen aan deze resource.
location	string	De geografische locatie waar de resource zich bevindt
name	string	De naam van de resource
properties	InstanceProperties	De resourcespecifieke eigenschappen voor deze resource.
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
tags	object	Resourcetags.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

InstanceResourceListResult

Object

Het antwoord van een bewerking in de InstanceResource-lijst.

Name	Type	Description
nextLink	string (uri)	De link naar de volgende pagina met items
value	InstanceResource[]	De InstanceResource-items op deze pagina

ManagedServiceIdentity

Object

Beheerde service-identiteit (door het systeem toegewezen en/of door de gebruiker toegewezen identiteiten)

Name	Type	Description
principalId	string (uuid)	De service-principal-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen verstrekt voor een door het systeem toegewezen identiteit.
tenantId	string (uuid)	De tenant-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen verstrekt voor een door het systeem toegewezen identiteit.
type	ManagedServiceIdentityType	Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned identiteiten De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen.

ManagedServiceIdentityType

Opsomming

Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).

Waarde	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

ProvisioningState

Opsomming

De enum die de status van de resource definieert.

Waarde	Description
Succeeded	Er is een bron gemaakt.
Failed	Het maken van bronnen is mislukt.
Canceled	Het maken van grondstoffen is geannuleerd.
Provisioning	Resource wordt ingericht.
Updating	Bron wordt bijgewerkt.
Deleting	Bron wordt verwijderd.
Accepted	Bron is geaccepteerd.

ResourceHealthState

Opsomming

De gezondheidstoestand van de bron.

Waarde	Description
Available	Resource is beschikbaar en functioneert zoals verwacht.
Degraded	De gezondheid van hulpbronnen wordt aangetast.
Unavailable	De resource werkt niet zoals verwacht.
Unknown	De status van de bron is onbekend.

SchemaRegistryRef

Object

De verwijzing naar het schemaregister voor dit AIO-exemplaar.

Name	Type	Description
resourceId	string (arm-id)	De resource-id van het schemaregister.

SecretProviderClassRef

Object

De verwijzing naar de AIO Secret provider-klasse.

Name	Type	Description
resourceId	string (arm-id)	De resource-ID van de AIO Secret-providerklasse.

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

UserAssignedIdentity

Object

Door de gebruiker toegewezen identiteitseigenschappen

Name	Type	Description
clientId	string (uuid)	De client-id van de toegewezen identiteit.
principalId	string (uuid)	De principal-id van de toegewezen identiteit.

Delen via

Instance - List By Subscription

URI-parameters

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

Instance_ListBySubscription

Voorbeeldaanvraag

Voorbeeldrespons

Definities

AzureDeviceRegistryNamespaceRef

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationType

InstanceFeature

InstanceFeatureMode

InstanceProperties

InstanceResource

InstanceResourceListResult

ManagedServiceIdentity

ManagedServiceIdentityType

ProvisioningState

ResourceHealthState

SchemaRegistryRef

SecretProviderClassRef

systemData

UserAssignedIdentity