Instance - List By Subscription

Layanan:: IoT Operations

Versi API:: 2026-07-01

Mencantumkan sumber daya InstanceResource berdasarkan ID langganan

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang akan digunakan untuk operasi ini.

Respons

Nama	Jenis	Deskripsi
200 OK	InstanceResourceListResult	Operasi Azure berhasil diselesaikan.
Other Status Codes	ErrorResponse	Respons kesalahan yang tidak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

Instance_ListBySubscription

Permintaan sampel

HTTP

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

Respon sampel

Kode status:: 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"
}

Definisi

Nama	Deskripsi
AzureDeviceRegistryNamespaceRef	Referensi Namespace Registri Perangkat Azure.
createdByType	Jenis identitas yang membuat sumber daya tersebut.
ErrorAdditionalInfo	Informasi tambahan tentang kesalahan pengelolaan sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
ExtendedLocation	Lokasi yang diperluas adalah ekstensi lokasi Azure. Mereka menyediakan cara untuk menggunakan kluster Kubernetes dengan dukungan Azure ARC mereka sebagai lokasi target untuk menyebarkan instans layanan Azure.
ExtendedLocationType	Enum yang menentukan jenis ExtendedLocation diterima.
InstanceFeature	Fitur Instans AIO.
InstanceFeatureMode	Mode penentu enum fitur.
InstanceProperties	Properti sumber daya Instans.
InstanceResource	Sumber daya Instans adalah kontainer logis untuk sekumpulan sumber daya anak.
InstanceResourceListResult	Respons operasi daftar InstanceResource.
ManagedServiceIdentity	Identitas layanan terkelola (identitas yang ditetapkan sistem dan/atau pengguna)
ManagedServiceIdentityType	Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan).
ProvisioningState	Enum menentukan status sumber daya.
ResourceHealthState	Keadaan kesehatan sumber daya.
SchemaRegistryRef	Referensi ke Registri Skema untuk Instans AIO ini.
SecretProviderClassRef	Referensi ke kelas penyedia AIO Secret.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
UserAssignedIdentity	Properti identitas yang ditetapkan pengguna

AzureDeviceRegistryNamespaceRef

Objek

Referensi Namespace Registri Perangkat Azure.

Nama	Jenis	Deskripsi
resourceId	string (arm-id)	ID sumber daya Namespace Registri Perangkat Azure.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya tersebut.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objek

Informasi tambahan tentang kesalahan pengelolaan sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis informasi tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Informasi tambahan tentang kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Rincian kesalahan.
message	string	Pesan kesalahan.
target	string	Sasaran kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

ExtendedLocation

Objek

Lokasi yang diperluas adalah ekstensi lokasi Azure. Mereka menyediakan cara untuk menggunakan kluster Kubernetes dengan dukungan Azure ARC mereka sebagai lokasi target untuk menyebarkan instans layanan Azure.

Nama	Jenis	Deskripsi
name	string	Nama lokasi yang diperluas.
type	ExtendedLocationType	Jenis ExtendedLocation.

ExtendedLocationType

Enumerasi

Enum yang menentukan jenis ExtendedLocation diterima.

Nilai	Deskripsi
CustomLocation	Jenis CustomLocation

InstanceFeature

Objek

Fitur Instans AIO.

Nama	Jenis	Deskripsi
mode	InstanceFeatureMode	Status fitur.
settings	object	Pengaturan fitur.

InstanceFeatureMode

Enumerasi

Mode penentu enum fitur.

Nilai	Deskripsi
Stable	Ikut serta untuk mengaktifkan fitur stabil
Preview	Ikut serta untuk mengaktifkan fitur pratinjau
Disabled	Memilih keluar dari fitur

InstanceProperties

Objek

Properti sumber daya Instans.

Nama	Jenis	Nilai default	Deskripsi
adrNamespaceRef	AzureDeviceRegistryNamespaceRef		Namespace Registri Perangkat Azure yang digunakan oleh Aset, Aset yang Ditemukan, dan perangkat
defaultSecretProviderClassRef	SecretProviderClassRef		Referensi ke kelas penyedia AIO Secret.
description	string		Deskripsi terperinci tentang Instans.
features	<string, InstanceFeature>		Fitur Instans AIO.
healthState	ResourceHealthState	Unknown	Keadaan kesehatan sumber daya.
provisioningState	ProvisioningState		Status operasi terakhir.
schemaRegistryRef	SchemaRegistryRef		Referensi ke Registri Skema untuk Instans AIO ini.
version	string		Versi Operasi Azure IoT.

InstanceResource

Objek

Sumber daya Instans adalah kontainer logis untuk sekumpulan sumber daya anak.

Nama	Jenis	Deskripsi
extendedLocation	ExtendedLocation	Lokasi edge sumber daya.
id	string (arm-id)	ID sumber daya lengkap untuk sumber daya tersebut. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Identitas layanan terkelola yang ditetapkan ke sumber daya ini.
location	string	Lokasi geografis tempat sumber daya berada
name	string	Nama sumber daya.
properties	InstanceProperties	Properti khusus sumber daya untuk sumber daya ini.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
tags	object	Tag sumber daya.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

InstanceResourceListResult

Objek

Respons operasi daftar InstanceResource.

Nama	Jenis	Deskripsi
nextLink	string (uri)	Tautan ke halaman item berikutnya
value	InstanceResource[]	Item InstanceResource di halaman ini

ManagedServiceIdentity

Objek

Identitas layanan terkelola (identitas yang ditetapkan sistem dan/atau pengguna)

Nama	Jenis	Deskripsi
principalId	string (uuid)	ID perwakilan layanan dari identitas yang ditetapkan sistem. Properti ini hanya akan disediakan untuk identitas yang ditetapkan sistem.
tenantId	string (uuid)	ID penyewa dari identitas yang ditetapkan sistem. Properti ini hanya akan disediakan untuk identitas yang ditetapkan sistem.
type	ManagedServiceIdentityType	Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan).
userAssignedIdentities	<string, UserAssignedIdentity>	Identitas User-Assigned Kumpulan identitas yang ditetapkan pengguna yang terkait dengan sumber daya. Kunci kamus userAssignedIdentities akan menjadi id sumber daya ARM dalam bentuk: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. Nilai kamus dapat berupa objek kosong ({}) dalam permintaan.

ManagedServiceIdentityType

Enumerasi

Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan).

Nilai	Deskripsi
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

ProvisioningState

Enumerasi

Enum menentukan status sumber daya.

Nilai	Deskripsi
Succeeded	Sumber daya telah dibuat.
Failed	Pembuatan sumber daya gagal.
Canceled	Pembuatan sumber daya dibatalkan.
Provisioning	Sumber daya sedang disediakan.
Updating	Sumber daya sedang diperbarui.
Deleting	Sumber daya sedang dihapus.
Accepted	Sumber daya telah Diterima.

ResourceHealthState

Enumerasi

Keadaan kesehatan sumber daya.

Nilai	Deskripsi
Available	Sumber daya tersedia dan berfungsi seperti yang diharapkan.
Degraded	Kesehatan sumber daya menurun.
Unavailable	Sumber daya tidak berfungsi seperti yang diharapkan.
Unknown	Status sumber daya tidak diketahui.

SchemaRegistryRef

Objek

Referensi ke Registri Skema untuk Instans AIO ini.

Nama	Jenis	Deskripsi
resourceId	string (arm-id)	ID sumber daya Registri Skema.

SecretProviderClassRef

Objek

Referensi ke kelas penyedia AIO Secret.

Nama	Jenis	Deskripsi
resourceId	string (arm-id)	ID sumber daya kelas penyedia AIO Secret.

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya tersebut.
createdByType	createdByType	Jenis identitas yang membuat sumber daya tersebut.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir kali mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.

UserAssignedIdentity

Objek

Properti identitas yang ditetapkan pengguna

Nama	Jenis	Deskripsi
clientId	string (uuid)	ID klien dari identitas yang ditetapkan.
principalId	string (uuid)	ID utama identitas yang ditetapkan.