Instance - List By Subscription

Tjänst:: IoT Operations

API-versionen:: 2026-03-01

Visa en lista över InstanceResource-resurser efter prenumerations-ID

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

URI-parametrar

Namn	I	Krävs	Typ	Beskrivning
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Svaren

Namn	Typ	Beskrivning
200 OK	InstanceResourceListResult	Azure-åtgärden har slutförts.
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Rinna: implicit
Auktorisations-URL: https://login.microsoftonline.com/common/oauth2/authorize

Scope

Namn	Beskrivning
user_impersonation	personifiera ditt användarkonto

Exempel

Instance_ListBySubscription

Exempelförfrågan

HTTP

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

Exempelsvar

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

Definitioner

Namn	Beskrivning
AzureDeviceRegistryNamespaceRef	Namnområdesreferens för Azure Device Registry.
createdByType	Den typ av identitet som skapade resursen.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
ExtendedLocation	Utökad plats är en utökning av Azure-platser. De är ett sätt att använda sina Azure ARC-aktiverade Kubernetes-kluster som målplatser för att distribuera instanser av Azure-tjänster.
ExtendedLocationType	Uppräkningen som definierar typen av ExtendedLocation accepterad.
InstanceFeature	Funktionerna i AIO-instansen.
InstanceFeatureMode	Uppräkningsdefinierande läge för en funktion.
InstanceProperties	Egenskaperna för instansresursen.
InstanceResource	En instansresurs är en logisk container för en uppsättning underordnade resurser.
InstanceResourceListResult	Svaret från en InstanceResource liståtgärd.
ManagedServiceIdentity	Hanterad tjänstidentitet (systemtilldelade och/eller användartilldelade identiteter)
ManagedServiceIdentityType	Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts).
ProvisioningState	Uppräkningen som definierar status för resursen.
ResourceHealthState	Resursens hälsotillstånd.
SchemaRegistryRef	Referensen till schemaregistret för den här AIO-instansen.
SecretProviderClassRef	Referensen till providerklassen AIO Secret.
systemData	Metadata som rör skapande och senaste ändring av resursen.
UserAssignedIdentity	Användartilldelade identitetsegenskaper

AzureDeviceRegistryNamespaceRef

Objekt

Namnområdesreferens för Azure Device Registry.

Namn	Typ	Beskrivning
resourceId	string (arm-id)	Resurs-ID:t för namnområdet för Azure-enhetsregistret.

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Beskrivning
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Namn	Typ	Beskrivning
info	object	Den ytterligare informationen.
type	string	Typen av ytterligare information.

ErrorDetail

Objekt

Felinformationen.

Namn	Typ	Beskrivning
additionalInfo	ErrorAdditionalInfo[]	Felet ytterligare information.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felet riktas.

ErrorResponse

Objekt

Felsvar

Namn	Typ	Beskrivning
error	ErrorDetail	Felet objektet.

ExtendedLocation

Objekt

Utökad plats är en utökning av Azure-platser. De är ett sätt att använda sina Azure ARC-aktiverade Kubernetes-kluster som målplatser för att distribuera instanser av Azure-tjänster.

Namn	Typ	Beskrivning
name	string	Namnet på den utökade platsen.
type	ExtendedLocationType	Typ av ExtendedLocation.

ExtendedLocationType

Uppräkning

Uppräkningen som definierar typen av ExtendedLocation accepterad.

Värde	Beskrivning
CustomLocation	CustomLocation-typ

InstanceFeature

Objekt

Funktionerna i AIO-instansen.

Namn	Typ	Beskrivning
mode	InstanceFeatureMode	Funktionens tillstånd.
settings	object	Inställningarna för funktionen.

InstanceFeatureMode

Uppräkning

Uppräkningsdefinierande läge för en funktion.

Värde	Beskrivning
Stable	Välj att aktivera en stabil funktion
Preview	Anmäl dig för att aktivera en förhandsgranskningsfunktion
Disabled	Välja bort en funktion

InstanceProperties

Objekt

Egenskaperna för instansresursen.

Namn	Typ	Standardvärde	Beskrivning
adrNamespaceRef	AzureDeviceRegistryNamespaceRef		Namnområdet för Azure Device Registry som används av tillgångar, identifierade tillgångar och enheter
defaultSecretProviderClassRef	SecretProviderClassRef		Referensen till providerklassen AIO Secret.
description	string		Detaljerad beskrivning av instansen.
features	<string, InstanceFeature>		Funktionerna i AIO-instansen.
healthState	ResourceHealthState	Unknown	Resursens hälsotillstånd.
provisioningState	ProvisioningState		Status för den senaste åtgärden.
schemaRegistryRef	SchemaRegistryRef		Referensen till schemaregistret för den här AIO-instansen.
version	string		Versionen av Azure IoT Operations.

InstanceResource

Objekt

En instansresurs är en logisk container för en uppsättning underordnade resurser.

Namn	Typ	Beskrivning
extendedLocation	ExtendedLocation	Resursens gränsplats.
id	string (arm-id)	Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	De hanterade tjänstidentiteter som tilldelats den här resursen.
location	string	Den geografiska plats där resursen finns
name	string	Namnet på resursen
properties	InstanceProperties	Resursspecifika egenskaper för den här resursen.
systemData	systemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
tags	object	Resursetiketter.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

InstanceResourceListResult

Objekt

Svaret från en InstanceResource liståtgärd.

Namn	Typ	Beskrivning
nextLink	string (uri)	Länken till nästa sida med objekt
value	InstanceResource[]	InstanceResource-objekten på den här sidan

ManagedServiceIdentity

Objekt

Hanterad tjänstidentitet (systemtilldelade och/eller användartilldelade identiteter)

Namn	Typ	Beskrivning
principalId	string (uuid)	Tjänstens huvudnamns-ID för den systemtilldelade identiteten. Den här egenskapen tillhandahålls endast för en systemtilldelad identitet.
tenantId	string (uuid)	Klientorganisations-ID för den systemtilldelade identiteten. Den här egenskapen tillhandahålls endast för en systemtilldelad identitet.
type	ManagedServiceIdentityType	Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned identiteter Uppsättningen användartilldelade identiteter som är associerade med resursen. Ordlistenycklarna userAssignedIdentities är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Ordlistevärdena kan vara tomma objekt ({}) i begäranden.

ManagedServiceIdentityType

Uppräkning

Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts).

Värde	Beskrivning
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

ProvisioningState

Uppräkning

Uppräkningen som definierar status för resursen.

Värde	Beskrivning
Succeeded	Resursen har skapats.
Failed	Det gick inte att skapa resurser.
Canceled	Resursskapandet avbröts.
Provisioning	Resursen etableras.
Updating	Resursen uppdateras.
Deleting	Resursen tas bort.
Accepted	Resursen har godkänts.

ResourceHealthState

Uppräkning

Resursens hälsotillstånd.

Värde	Beskrivning
Available	Resursen är tillgänglig och fungerar som förväntat.
Degraded	Resurshälsan försämras.
Unavailable	Resursen fungerar inte som förväntat.
Unknown	Resurstillståndet är okänt.

SchemaRegistryRef

Objekt

Referensen till schemaregistret för den här AIO-instansen.

Namn	Typ	Beskrivning
resourceId	string (arm-id)	Resurs-ID för schemaregistret.

SecretProviderClassRef

Objekt

Referensen till providerklassen AIO Secret.

Namn	Typ	Beskrivning
resourceId	string (arm-id)	Resurs-ID:t för providerklassen för AIO-hemligheter.

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Namn	Typ	Beskrivning
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för senaste ändring av resurs (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

UserAssignedIdentity

Objekt

Användartilldelade identitetsegenskaper

Namn	Typ	Beskrivning
clientId	string (uuid)	Klient-ID för den tilldelade identiteten.
principalId	string (uuid)	Huvud-ID för den tilldelade identiteten.

Dela via

Instance - List By Subscription

URI-parametrar

Svaren

Säkerhet

azure_auth

Scope

Exempel

Instance_ListBySubscription

Exempelförfrågan

Exempelsvar

Definitioner

AzureDeviceRegistryNamespaceRef

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationType

InstanceFeature

InstanceFeatureMode

InstanceProperties

InstanceResource

InstanceResourceListResult

ManagedServiceIdentity

ManagedServiceIdentityType

ProvisioningState

ResourceHealthState

SchemaRegistryRef

SecretProviderClassRef

systemData

UserAssignedIdentity