Asset Endpoint Profiles - List By Resource Group

Hizmet:: Device Registry

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

AssetEndpointProfile kaynaklarını kaynak grubuna göre listeleme

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceRegistry/assetEndpointProfiles?api-version=2026-04-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. Ad büyük/küçük harfe duyarsız.
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	AssetEndpointProfileListResult	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

List_AssetEndpointProfiles_ByResourceGroup

Örnek isteği

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.DeviceRegistry/assetEndpointProfiles?api-version=2026-04-01

Örnek yanıt

Durum kodu:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.DeviceRegistry/assetEndpointProfiles/my-assetendpointprofile",
      "name": "my-assetendpointprofile",
      "type": "Microsoft.DeviceRegistry/assetEndpointProfiles",
      "location": "West Europe",
      "extendedLocation": {
        "type": "CustomLocation",
        "name": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.extendedlocation/customlocations/location1"
      },
      "tags": {
        "site": "building-1"
      },
      "systemData": {
        "createdBy": "2ta23112-4596-44ff-b773-19405922bfc1",
        "createdByType": "Application",
        "createdAt": "2022-11-16T00:36:43.2516899Z",
        "lastModifiedBy": "2ta23112-4596-44ff-b773-19405922bfc1",
        "lastModifiedByType": "Application",
        "lastModifiedAt": "2022-11-16T01:37:16.0922793Z"
      },
      "properties": {
        "uuid": "0796f7c1-f2c8-44d7-9f5b-9a6f9522a85d",
        "targetAddress": "https://www.example.com/myTargetAddress",
        "endpointProfileType": "myEndpointProfileType",
        "authentication": {
          "method": "Anonymous"
        },
        "provisioningState": "Succeeded"
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.DeviceRegistry/assetEndpointProfiles/my-assetendpointprofile1",
      "name": "my-assetendpointprofile1",
      "type": "Microsoft.DeviceRegistry/assetEndpointProfiles",
      "location": "West Europe",
      "extendedLocation": {
        "type": "CustomLocation",
        "name": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.extendedlocation/customlocations/location1"
      },
      "tags": {
        "site": "building-2"
      },
      "systemData": {
        "createdBy": "2ta23112-4596-44ff-b773-19405922bfc1",
        "createdByType": "Application",
        "createdAt": "2022-11-16T00:36:43.2516899Z",
        "lastModifiedBy": "2ta23112-4596-44ff-b773-19405922bfc1",
        "lastModifiedByType": "Application",
        "lastModifiedAt": "2022-11-16T01:37:16.0922793Z"
      },
      "properties": {
        "uuid": "7824a74f-21e1-4458-ae06-604d3a241d2c",
        "targetAddress": "https://www.example.com/myTargetAddress1",
        "endpointProfileType": "myEndpointProfileType",
        "authentication": {
          "method": "Certificate",
          "x509Credentials": {
            "certificateSecretName": "certificatRef"
          }
        },
        "provisioningState": "Succeeded"
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.DeviceRegistry/assetEndpointProfiles/my-assetendpointprofile2",
      "name": "my-assetendpointprofile2",
      "type": "Microsoft.DeviceRegistry/assetEndpointProfiles",
      "location": "West Europe",
      "extendedLocation": {
        "type": "CustomLocation",
        "name": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.extendedlocation/customlocations/location1"
      },
      "tags": {
        "site": "building-2"
      },
      "systemData": {
        "createdBy": "2ta23112-4596-44ff-b773-19405922bfc1",
        "createdByType": "Application",
        "createdAt": "2022-11-16T00:36:43.2516899Z",
        "lastModifiedBy": "2ta23112-4596-44ff-b773-19405922bfc1",
        "lastModifiedByType": "Application",
        "lastModifiedAt": "2022-11-16T01:37:16.0922793Z"
      },
      "properties": {
        "uuid": "1824a74f-21e1-4458-ae07-604d3a241d2e",
        "targetAddress": "https://www.example.com/myTargetAddress2",
        "endpointProfileType": "myEndpointProfileType",
        "authentication": {
          "method": "UsernamePassword",
          "usernamePasswordCredentials": {
            "usernameSecretName": "usernameRef",
            "passwordSecretName": "passwordRef"
          }
        },
        "provisioningState": "Succeeded"
      }
    }
  ]
}

Tanımlar

Name	Description
AssetEndpointProfile	Varlık Uç Noktası Profili tanımı.
AssetEndpointProfileListResult	AssetEndpointProfile liste işleminin yanıtı.
AssetEndpointProfileStatus	Varlık uç noktası profili durum özelliklerini tanımlar.
AssetEndpointProfileStatusError	Varlık uç noktası profili durum hata özelliklerini tanımlar.
Authentication	Sunucuya istemci kimlik doğrulama mekanizmasının tanımı.
AuthenticationMethod	Sunucudaki istemcinin kullanıcısının kimliğini doğrulama yöntemi.
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.
ProvisioningState	Kaynağın sağlama durumu.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
UsernamePasswordCredentials	Kimlik doğrulama modu UsernamePassword için kimlik bilgileri.
X509Credentials	Kimlik doğrulama modu Sertifikası için x509 sertifikası.

AssetEndpointProfile

Nesne

Varlık Uç Noktası Profili tanımı.

Name	Tür	Description
extendedLocation	ExtendedLocation	Genişletilmiş konum.
id	string (arm-id)	Kaynağın tam kaynak kimliği. Örneğin "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Kaynağın bulunduğu coğrafi konum
name	string	Kaynağın adı
properties.additionalConfiguration	string	Bağlantı türüne özgü ek yapılandırma (örneğin OPC UA, Modbus, ONVIF) içeren dizeli JSON.
properties.authentication	Authentication	Sunucuya istemci kimlik doğrulama mekanizmasını tanımlar.
properties.discoveredAssetEndpointProfileRef	string	Bulunan varlık uç noktası profiline başvuru. Yalnızca varlık uç noktası profili bulma akışından oluşturulduysa doldurulur. Bulunan varlık uç noktası profil adı sağlanmalıdır.
properties.endpointProfileType	string	Uç nokta profiliyle kullanılan bağlayıcı türünün yapılandırmasını tanımlar.
properties.provisioningState	ProvisioningState	Kaynağın sağlama durumu.
properties.status	AssetEndpointProfileStatus	Edge'de meydana gelen değişiklikleri yansıtmak için salt okunur nesne. Özel kaynaklar için Kubernetes status özelliğine benzer.
properties.targetAddress	string (uri)	Güneye giden bir cihazın ağ adresini/DNS adını belirten yerel geçerli URI. targetAddress URI'sinin şema bölümü, cihazın türünü belirtir. additionalConfiguration alanı daha fazla bağlayıcı türüne özgü yapılandırmayı barındırıyor.
properties.uuid	string	Küresel olarak benzersiz, değişmez, yeniden kullanılamaz kimlik.
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"

AssetEndpointProfileListResult

Nesne

AssetEndpointProfile liste işleminin yanıtı.

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

AssetEndpointProfileStatus

Nesne

Varlık uç noktası profili durum özelliklerini tanımlar.

Name	Tür	Description
errors	AssetEndpointProfileStatusError[]	Array nesnesi, Edge'den kaynaklanan hataları aktarmak ve kalıcı hale getirmek için.

AssetEndpointProfileStatusError

Nesne

Varlık uç noktası profili durum hata özelliklerini tanımlar.

Name	Tür	Description
code	integer (int32)	Hataların sınıflandırılması için hata kodu (örn: 400, 404, 500, vb.).
message	string	Hata için ek bağlam sağlamak üzere insan tarafından okunabilir yararlı hata mesajı (ör. "targetAddress 'foo' geçerli bir url değil").

Authentication

Nesne

Sunucuya istemci kimlik doğrulama mekanizmasının tanımı.

Name	Tür	Default value	Description
method	AuthenticationMethod	Certificate	Sunucuda istemcinin kullanıcısının kimliğini doğrulamak için yöntemini tanımlar.
usernamePasswordCredentials	UsernamePasswordCredentials		UsernamePassword kullanıcı kimlik doğrulama modu seçildiğinde kullanıcı adı ve parola başvurularını tanımlar.
x509Credentials	X509Credentials		Sertifika kullanıcısı kimlik doğrulama modu seçildiğinde sertifika başvuruyu tanımlar.

AuthenticationMethod

Numaralandırma

Sunucudaki istemcinin kullanıcısının kimliğini doğrulama yöntemi.

Değer	Description
Anonymous	Kullanıcı kimlik doğrulama yöntemi anonimdir.
Certificate	Kullanıcı kimlik doğrulama yöntemi bir x509 sertifikasıdır.
UsernamePassword	Kullanıcı kimlik doğrulama yöntemi bir kullanıcı adı ve paroladır.

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.

Name	Tür	Description
name	string	Genişletilmiş konum adı.
type	string	Genişletilmiş konum türü.

ProvisioningState

Numaralandırma

Kaynağın sağlama durumu.

Değer	Description
Succeeded	Kaynak oluşturuldu.
Failed	Kaynak oluşturulamadı.
Canceled	Kaynak oluşturma işlemi iptal edildi.
Accepted	Kaynak sunucu tarafından kabul edildi.
Deleting	Kaynak siliniyor.

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ü.

UsernamePasswordCredentials

Nesne

Kimlik doğrulama modu UsernamePassword için kimlik bilgileri.

Name	Tür	Description
passwordSecretName	string	Parolayı içeren gizli dizinin adı.
usernameSecretName	string	Kullanıcı adını içeren gizli dizinin adı.

X509Credentials

Nesne

Kimlik doğrulama modu Sertifikası için x509 sertifikası.

Name	Tür	Description
certificateSecretName	string	Sertifikayı ve özel anahtarı içeren gizli anahtarın adı (örn. .der/.pem veya .der/.pfx olarak depolanır).

Aracılığıyla paylaş

Asset Endpoint Profiles - List By Resource Group

URI Parametreleri

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

List_AssetEndpointProfiles_ByResourceGroup

Örnek isteği

Örnek yanıt

Tanımlar

AssetEndpointProfile

AssetEndpointProfileListResult

AssetEndpointProfileStatus

AssetEndpointProfileStatusError

Authentication

AuthenticationMethod

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ProvisioningState

systemData

UsernamePasswordCredentials

X509Credentials