Instance - List By Subscription

Hizmet:: IoT Operations

API Sürümü:: 2026-03-01

InstanceResource kaynaklarını abonelik kimliğine göre listeleme

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	InstanceResourceListResult	Azure işlemi başarıyla tamamlandı.
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Instance_ListBySubscription

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:: 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"
}

Tanımlar

Name	Description
AzureDeviceRegistryNamespaceRef	Azure Cihaz Kayıt Defteri Ad Alanı başvurusu.
createdByType	Kaynağı oluşturan kimliğin türü.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
ExtendedLocation	Genişletilmiş konum, Azure konumlarının bir uzantısıdır. Azure ARC özellikli Kubernetes kümelerini Azure hizmetleri örneklerini dağıtmak için hedef konumlar olarak kullanmanın bir yolunu sağlar.
ExtendedLocationType	ExtendedLocation sabit listesi tanımlayıcı türü kabul edildi.
InstanceFeature	AIO Örneğinin özellikleri.
InstanceFeatureMode	Bir özelliğin sabit listesi tanımlama modu.
InstanceProperties	Örnek kaynağının özellikleri.
InstanceResource	Örnek kaynağı, bir dizi alt kaynak için mantıksal bir kapsayıcıdır.
InstanceResourceListResult	InstanceResource liste işleminin yanıtı.
ManagedServiceIdentity	Yönetilen hizmet kimliği (sistem tarafından atanan ve/veya kullanıcı tarafından atanan kimlikler)
ManagedServiceIdentityType	Yönetilen hizmet kimliği türü (hem SystemAssigned hem de UserAssigned türlerine izin verilir).
ProvisioningState	Kaynağın durumunu tanımlayan numaralandırma.
ResourceHealthState	Kaynağın sistem durumu.
SchemaRegistryRef	Bu AIO Örneği için Şema Kayıt Defteri başvurusu.
SecretProviderClassRef	AIO Gizli Dizi sağlayıcı sınıfına başvuru.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
UserAssignedIdentity	Kullanıcı tarafından atanan kimlik özellikleri

AzureDeviceRegistryNamespaceRef

Nesne

Azure Cihaz Kayıt Defteri Ad Alanı başvurusu.

Name	Tür	Description
resourceId	string (arm-id)	Azure Cihaz Kayıt Defteri Ad Alanı'nın kaynak kimliği.

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Nesne

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

ExtendedLocation

Nesne

Genişletilmiş konum, Azure konumlarının bir uzantısıdır. Azure ARC özellikli Kubernetes kümelerini Azure hizmetleri örneklerini dağıtmak için hedef konumlar olarak kullanmanın bir yolunu sağlar.

Name	Tür	Description
name	string	Genişletilmiş konumun adı.
type	ExtendedLocationType	ExtendedLocation türü.

ExtendedLocationType

Numaralandırma

ExtendedLocation sabit listesi tanımlayıcı türü kabul edildi.

Değer	Description
CustomLocation	CustomLocation türü

InstanceFeature

Nesne

AIO Örneğinin özellikleri.

Name	Tür	Description
mode	InstanceFeatureMode	Özelliğin durumu.
settings	object	Özelliğin ayarları.

InstanceFeatureMode

Numaralandırma

Bir özelliğin sabit listesi tanımlama modu.

Değer	Description
Stable	Kararlı bir özelliği etkinleştirmek için kaydolun
Preview	Önizleme özelliğini etkinleştirmeyi etkinleştirme
Disabled	Bir özelliği devre dışı bırakma

InstanceProperties

Nesne

Örnek kaynağının özellikleri.

Name	Tür	Default value	Description
adrNamespaceRef	AzureDeviceRegistryNamespaceRef		Varlıklar, Bulunan Varlıklar ve cihazlar tarafından kullanılan Azure Cihaz Kayıt Defteri Ad Alanı
defaultSecretProviderClassRef	SecretProviderClassRef		AIO Gizli Dizi sağlayıcı sınıfına başvuru.
description	string		Örneğin ayrıntılı açıklaması.
features	<string, InstanceFeature>		AIO Örneğinin özellikleri.
healthState	ResourceHealthState	Unknown	Kaynağın sistem durumu.
provisioningState	ProvisioningState		Son işlemin durumu.
schemaRegistryRef	SchemaRegistryRef		Bu AIO Örneği için Şema Kayıt Defteri başvurusu.
version	string		Azure IoT İşlemleri sürümü.

InstanceResource

Nesne

Örnek kaynağı, bir dizi alt kaynak için mantıksal bir kapsayıcıdır.

Name	Tür	Description
extendedLocation	ExtendedLocation	Kaynağın kenar konumu.
id	string (arm-id)	Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Bu kaynağa atanan yönetilen hizmet kimlikleri.
location	string	Kaynağın bulunduğu coğrafi konum
name	string	Kaynağın adı
properties	InstanceProperties	Bu kaynağın kaynağa özgü özellikleri.
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
tags	object	Kaynak etiketleri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

InstanceResourceListResult

Nesne

InstanceResource liste işleminin yanıtı.

Name	Tür	Description
nextLink	string (uri)	Öğelerin bir sonraki sayfasına bağlantı
value	InstanceResource[]	Bu sayfadaki InstanceResource öğeleri

ManagedServiceIdentity

Nesne

Yönetilen hizmet kimliği (sistem tarafından atanan ve/veya kullanıcı tarafından atanan kimlikler)

Name	Tür	Description
principalId	string (uuid)	Sistem tarafından atanan kimliğin hizmet sorumlusu kimliği. Bu özellik yalnızca sistem tarafından atanan kimlik için sağlanacaktır.
tenantId	string (uuid)	Sistem tarafından atanan kimliğin kiracı kimliği. Bu özellik yalnızca sistem tarafından atanan kimlik için sağlanacaktır.
type	ManagedServiceIdentityType	Yönetilen hizmet kimliği türü (hem SystemAssigned hem de UserAssigned türlerine izin verilir).
userAssignedIdentities	<string, UserAssignedIdentity>	kimlikleri User-Assigned Kaynakla ilişkili kullanıcı tarafından atanan kimlik kümesi. userAssignedIdentities sözlük anahtarları şu formda ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Sözlük değerleri, isteklerdeki boş nesneler ({}) olabilir.

ManagedServiceIdentityType

Numaralandırma

Yönetilen hizmet kimliği türü (hem SystemAssigned hem de UserAssigned türlerine izin verilir).

Değer	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

ProvisioningState

Numaralandırma

Kaynağın durumunu tanımlayan numaralandırma.

Değer	Description
Succeeded	Kaynak oluşturuldu.
Failed	Kaynak oluşturulamadı.
Canceled	Kaynak oluşturma işlemi iptal edildi.
Provisioning	Kaynak sağlanıyor.
Updating	Kaynak Güncelleniyor.
Deleting	Kaynak Siliniyor.
Accepted	Kaynak Kabul Edildi.

ResourceHealthState

Numaralandırma

Kaynağın sistem durumu.

Değer	Description
Available	Kaynak Kullanılabilir ve beklendiği gibi çalışıyor.
Degraded	Kaynak sağlığı bozulur.
Unavailable	Kaynak beklendiği gibi çalışmıyor.
Unknown	Kaynak durumu bilinmiyor.

SchemaRegistryRef

Nesne

Bu AIO Örneği için Şema Kayıt Defteri başvurusu.

Name	Tür	Description
resourceId	string (arm-id)	Şema Kayıt Defteri'nin kaynak kimliği.

SecretProviderClassRef

Nesne

AIO Gizli Dizi sağlayıcı sınıfına başvuru.

Name	Tür	Description
resourceId	string (arm-id)	AIO Gizli Dizi sağlayıcı sınıfının kaynak kimliği.

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.

UserAssignedIdentity

Nesne

Kullanıcı tarafından atanan kimlik özellikleri

Name	Tür	Description
clientId	string (uuid)	Atanan kimliğin istemci kimliği.
principalId	string (uuid)	Atanan kimliğin asıl kimliği.

Aracılığıyla paylaş

Instance - List By Subscription

URI Parametreleri

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

Instance_ListBySubscription

Örnek isteği

Örnek yanıt

Tanımlar

AzureDeviceRegistryNamespaceRef

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationType

InstanceFeature

InstanceFeatureMode

InstanceProperties

InstanceResource

InstanceResourceListResult

ManagedServiceIdentity

ManagedServiceIdentityType

ProvisioningState

ResourceHealthState

SchemaRegistryRef

SecretProviderClassRef

systemData

UserAssignedIdentity