Asset Endpoint Profiles - List By Resource Group

Szolgáltatás:: Device Registry

API verzió:: 2026-04-01

Az AssetEndpointProfile-erőforrások listázása erőforráscsoport szerint

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

URI paraméterek

Név	Ban	Szükséges	Típus	Leírás
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Válaszok

Név	Típus	Leírás
200 OK	AssetEndpointProfileListResult	Az Azure-művelet sikeresen befejeződött.
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

Típus: oauth2
Flow: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Név	Leírás
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

List_AssetEndpointProfiles_ByResourceGroup

Mintakérés

HTTP

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

Mintaválasz

Állapotkód:: 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"
      }
    }
  ]
}

Meghatározások

Név	Leírás
AssetEndpointProfile	Eszközvégpontprofil definíciója.
AssetEndpointProfileListResult	Egy AssetEndpointProfile listaművelet válasza.
AssetEndpointProfileStatus	Meghatározza az eszközvégpont-profil állapottulajdonságait.
AssetEndpointProfileStatusError	Meghatározza az eszközvégpont-profil állapotának hibatulajdonságait.
Authentication	A kiszolgáló ügyfél-hitelesítési mechanizmusának meghatározása.
AuthenticationMethod	Az ügyfél felhasználójának hitelesítése a kiszolgálón.
createdByType	Az erőforrást létrehozó identitás típusa.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
ExtendedLocation	A kiterjesztett hely.
ProvisioningState	Az erőforrás kiépítési állapota.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
UsernamePasswordCredentials	A UsernamePassword hitelesítési mód hitelesítő adatai.
X509Credentials	A hitelesítési módú tanúsítvány x509-tanúsítványa.

AssetEndpointProfile

Tárgy

Eszközvégpontprofil definíciója.

Név	Típus	Leírás
extendedLocation	ExtendedLocation	A kiterjesztett hely.
id	string (arm-id)	Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Az a földrajzi hely, ahol az erőforrás él
name	string	Az erőforrás neve
properties.additionalConfiguration	string	Sztringezett JSON, amely kapcsolattípus-specifikus további konfigurációt tartalmaz (pl. OPC UA, Modbus, ONVIF).
properties.authentication	Authentication	Meghatározza a kiszolgáló ügyfél-hitelesítési mechanizmusát.
properties.discoveredAssetEndpointProfileRef	string	Hivatkozás egy felderített objektumvégpont-profilra. Csak akkor van feltöltve, ha az eszközvégpont-profil a felderítési folyamatból lett létrehozva. Meg kell adni a felderített eszközvégpont-profil nevét.
properties.endpointProfileType	string	Meghatározza a végpontprofillal használt összekötőtípus konfigurációját.
properties.provisioningState	ProvisioningState	Az erőforrás kiépítési állapota.
properties.status	AssetEndpointProfileStatus	Csak olvasható objektum a peremhálózaton bekövetkezett változások tükrözéséhez. Hasonló az egyéni erőforrások Kubernetes-állapottulajdonságához.
properties.targetAddress	string (uri)	A helyi érvényes URI, amely megadja egy déli irányú eszköz hálózati címét/DNS-nevét. A targetAddress URI séma része határozza meg az eszköz típusát. A további Konfiguráció mező további összekötőtípus-specifikus konfigurációt tartalmaz.
properties.uuid	string	Globálisan egyedi, nem módosítható, nem újrafelhasználható azonosító.
systemData	systemData	A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.
tags	object	Erőforráscímkék.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

AssetEndpointProfileListResult

Tárgy

Egy AssetEndpointProfile listaművelet válasza.

Név	Típus	Leírás
nextLink	string (uri)	Az elemek következő oldalára mutató hivatkozás
value	AssetEndpointProfile[]	Az AssetEndpointProfile elemek ezen az oldalon

AssetEndpointProfileStatus

Tárgy

Meghatározza az eszközvégpont-profil állapottulajdonságait.

Név	Típus	Leírás
errors	AssetEndpointProfileStatusError[]	Tömbobjektum az Edge-ből származó hibák átviteléhez és megőrzéséhez.

AssetEndpointProfileStatusError

Tárgy

Meghatározza az eszközvégpont-profil állapotának hibatulajdonságait.

Név	Típus	Leírás
code	integer (int32)	A hibák osztályozásának hibakódja (pl. 400, 404, 500 stb.).
message	string	Ember által olvasható hasznos hibaüzenet a hiba további kontextusának biztosításához (pl. "targetAddress 'foo' nem érvényes URL").

Authentication

Tárgy

A kiszolgáló ügyfél-hitelesítési mechanizmusának meghatározása.

Név	Típus	Alapértelmezett érték	Leírás
method	AuthenticationMethod	Certificate	Meghatározza az ügyfél felhasználójának hitelesítésének módját a kiszolgálón.
usernamePasswordCredentials	UsernamePasswordCredentials		Meghatározza a felhasználónévre és a jelszóra mutató hivatkozásokat, ha a UsernamePassword felhasználói hitelesítési mód van kiválasztva.
x509Credentials	X509Credentials		A tanúsítványhivatkozást határozza meg a tanúsítványfelhasználói hitelesítési mód kiválasztásakor.

AuthenticationMethod

Felsorolás

Az ügyfél felhasználójának hitelesítése a kiszolgálón.

Érték	Leírás
Anonymous	A felhasználói hitelesítési módszer névtelen.
Certificate	A felhasználói hitelesítési módszer egy x509-tanúsítvány.
UsernamePassword	A felhasználói hitelesítési módszer egy felhasználónév és jelszó.

createdByType

Felsorolás

Az erőforrást létrehozó identitás típusa.

Érték	Leírás
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Név	Típus	Leírás
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Név	Típus	Leírás
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Tárgy

Hibaválasz

Név	Típus	Leírás
error	ErrorDetail	A hibaobjektum.

ExtendedLocation

Tárgy

A kiterjesztett hely.

Név	Típus	Leírás
name	string	A kiterjesztett hely neve.
type	string	A kiterjesztett hely típusa.

ProvisioningState

Felsorolás

Az erőforrás kiépítési állapota.

Érték	Leírás
Succeeded	Az erőforrás létrejött.
Failed	Az erőforrás létrehozása nem sikerült.
Canceled	Az erőforrás létrehozása megszakadt.
Accepted	Az erőforrást a kiszolgáló elfogadta.
Deleting	Az erőforrás törlődik.

systemData

Tárgy

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Név	Típus	Leírás
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

UsernamePasswordCredentials

Tárgy

A UsernamePassword hitelesítési mód hitelesítő adatai.

Név	Típus	Leírás
passwordSecretName	string	A jelszót tartalmazó titkos kód neve.
usernameSecretName	string	A felhasználónevet tartalmazó titkos kód neve.

X509Credentials

Tárgy

A hitelesítési módú tanúsítvány x509-tanúsítványa.

Név	Típus	Leírás
certificateSecretName	string	A tanúsítványt és a titkos kulcsot tartalmazó titkos kulcs neve (pl. .der/.pem vagy .der/.pfx).

Megosztás a következőn keresztül:

Asset Endpoint Profiles - List By Resource Group

URI paraméterek

Válaszok

Biztonság

azure_auth

Hatókörök

Példák

List_AssetEndpointProfiles_ByResourceGroup

Mintakérés

Mintaválasz

Meghatározások

AssetEndpointProfile

AssetEndpointProfileListResult

AssetEndpointProfileStatus

AssetEndpointProfileStatusError

Authentication

AuthenticationMethod

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ProvisioningState

systemData

UsernamePasswordCredentials

X509Credentials