Instance - List By Subscription

Serviço:: IoT Operations

Versão da API:: 2026-07-01

Listar recursos InstanceResource por ID de assinatura

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

Parâmetros do URI

Name	Em	Obrigatório	Tipo	Descrição
subscriptionId	path	True	string (uuid)	O ID da assinatura de destino. O valor deve ser um UUID.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Respostas

Name	Tipo	Descrição
200 OK	InstanceResourceListResult	Operação do Azure concluída com sucesso.
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Descrição
user_impersonation	assumir a identidade da sua conta de utilizador

Exemplos

Instance_ListBySubscription

Pedido de amostra

HTTP

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

Resposta da amostra

Código de estado:: 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"
}

Definições

Name	Descrição
AzureDeviceRegistryNamespaceRef	Referência do Namespace do Registro do Dispositivo do Azure.
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	Informações adicionais sobre o erro de gestão de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ExtendedLocation	O local estendido é uma extensão dos locais do Azure. Eles fornecem uma maneira de usar seus clusters Kubernetes habilitados para Azure ARC como locais de destino para implantar instâncias de serviços do Azure.
ExtendedLocationType	O enum que define o tipo de ExtendedLocation aceito.
InstanceFeature	Os recursos da instância AIO.
InstanceFeatureMode	O modo de definição enum de um recurso.
InstanceProperties	As propriedades do recurso Instance.
InstanceResource	Um recurso de instância é um contêiner lógico para um conjunto de recursos filho.
InstanceResourceListResult	A resposta de uma operação de lista InstanceResource.
ManagedServiceIdentity	Identidade do serviço gerenciado (identidades atribuídas pelo sistema e/ou pelo usuário)
ManagedServiceIdentityType	Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos).
ProvisioningState	O enum que define o status do recurso.
ResourceHealthState	O estado de saúde do recurso.
SchemaRegistryRef	A referência ao Registro de Esquema para esta Instância AIO.
SecretProviderClassRef	A referência à classe de provedor AIO Secret.
systemData	Metadados referentes à criação e última modificação do recurso.
UserAssignedIdentity	Propriedades de identidade atribuídas pelo usuário

AzureDeviceRegistryNamespaceRef

Object

Referência do Namespace do Registro do Dispositivo do Azure.

Name	Tipo	Descrição
resourceId	string (arm-id)	A ID do recurso do Namespace do Registro de Dispositivo do Azure.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Descrição
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

Informações adicionais sobre o erro de gestão de recursos.

Name	Tipo	Descrição
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Descrição
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O alvo do erro.

ErrorResponse

Object

Resposta de erro

Name	Tipo	Descrição
error	ErrorDetail	O objeto de erro.

ExtendedLocation

Object

O local estendido é uma extensão dos locais do Azure. Eles fornecem uma maneira de usar seus clusters Kubernetes habilitados para Azure ARC como locais de destino para implantar instâncias de serviços do Azure.

Name	Tipo	Descrição
name	string	O nome do local estendido.
type	ExtendedLocationType	Tipo de ExtendedLocation.

ExtendedLocationType

Enumeração

O enum que define o tipo de ExtendedLocation aceito.

Valor	Descrição
CustomLocation	Tipo CustomLocation

InstanceFeature

Object

Os recursos da instância AIO.

Name	Tipo	Descrição
mode	InstanceFeatureMode	O estado do recurso.
settings	object	As configurações do recurso.

InstanceFeatureMode

Enumeração

O modo de definição enum de um recurso.

Valor	Descrição
Stable	Opte por ativar um recurso estável
Preview	Optar por ativar uma funcionalidade de pré-visualização
Disabled	Desativar um recurso

InstanceProperties

Object

As propriedades do recurso Instance.

Name	Tipo	Valor predefinido	Descrição
adrNamespaceRef	AzureDeviceRegistryNamespaceRef		O Namespace do Registro de Dispositivo do Azure usado por Ativos, Ativos Descobertos e dispositivos
defaultSecretProviderClassRef	SecretProviderClassRef		A referência à classe de provedor AIO Secret.
description	string		Descrição detalhada da instância.
features	<string, InstanceFeature>		Os recursos da instância AIO.
healthState	ResourceHealthState	Unknown	O estado de saúde do recurso.
provisioningState	ProvisioningState		O status da última operação.
schemaRegistryRef	SchemaRegistryRef		A referência ao Registro de Esquema para esta Instância AIO.
version	string		A versão do Operações IoT do Azure.

InstanceResource

Object

Um recurso de instância é um contêiner lógico para um conjunto de recursos filho.

Name	Tipo	Descrição
extendedLocation	ExtendedLocation	Localização de borda do recurso.
id	string (arm-id)	ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	As identidades de serviço gerenciado atribuídas a este recurso.
location	string	A geolocalização onde o recurso vive
name	string	O nome do recurso
properties	InstanceProperties	As propriedades específicas do recurso para este recurso.
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

InstanceResourceListResult

Object

A resposta de uma operação de lista InstanceResource.

Name	Tipo	Descrição
nextLink	string (uri)	A ligação para a próxima página de itens
value	InstanceResource[]	Os itens InstanceResource nesta página

ManagedServiceIdentity

Object

Identidade do serviço gerenciado (identidades atribuídas pelo sistema e/ou pelo usuário)

Name	Tipo	Descrição
principalId	string (uuid)	O ID da entidade de serviço da identidade atribuída ao sistema. Esta propriedade só será fornecida para uma identidade atribuída ao sistema.
tenantId	string (uuid)	O ID do locatário da identidade atribuída ao sistema. Esta propriedade só será fornecida para uma identidade atribuída ao sistema.
type	ManagedServiceIdentityType	Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned Identidades O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recursos ARM na forma: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações.

ManagedServiceIdentityType

Enumeração

Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos).

Valor	Descrição
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

ProvisioningState

Enumeração

O enum que define o status do recurso.

Valor	Descrição
Succeeded	O recurso foi criado.
Failed	Falha na criação de recursos.
Canceled	A criação de recursos foi cancelada.
Provisioning	O recurso está sendo provisionado.
Updating	O recurso está se atualizando.
Deleting	O recurso está sendo excluído.
Accepted	O recurso foi aceito.

ResourceHealthState

Enumeração

O estado de saúde do recurso.

Valor	Descrição
Available	O recurso está disponível e funcionando conforme o esperado.
Degraded	A integridade dos recursos está degradada.
Unavailable	O recurso não está funcionando como esperado.
Unknown	O estado do recurso é desconhecido.

SchemaRegistryRef

Object

A referência ao Registro de Esquema para esta Instância AIO.

Name	Tipo	Descrição
resourceId	string (arm-id)	A ID do recurso do Registro de Esquema.

SecretProviderClassRef

Object

A referência à classe de provedor AIO Secret.

Name	Tipo	Descrição
resourceId	string (arm-id)	O ID do recurso da classe do provedor AIO Secret.

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name	Tipo	Descrição
createdAt	string (date-time)	A marca temporal da criação do recurso (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	A data e hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

UserAssignedIdentity

Object

Propriedades de identidade atribuídas pelo usuário

Name	Tipo	Descrição
clientId	string (uuid)	O ID do cliente da identidade atribuída.
principalId	string (uuid)	O ID principal da identidade atribuída.