Asset Endpoint Profiles - List By Resource Group

Služba:: Device Registry

Verze rozhraní API:: 2026-04-01

Výpis prostředků AssetEndpointProfile podle skupiny prostředků

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name	Typ	Description
200 OK	AssetEndpointProfileListResult	Operace Azure byla úspěšně dokončena.
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

List_AssetEndpointProfiles_ByResourceGroup

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kó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"
      }
    }
  ]
}

Definice

Name	Description
AssetEndpointProfile	Definice profilu koncového bodu assetu
AssetEndpointProfileListResult	Odpověď operace seznamu AssetEndpointProfile.
AssetEndpointProfileStatus	Definuje vlastnosti stavu profilu koncového bodu prostředku.
AssetEndpointProfileStatusError	Definuje vlastnosti chyby profilu koncového bodu prostředku.
Authentication	Definice mechanismu ověřování klienta na server.
AuthenticationMethod	Metoda ověření uživatele klienta na serveru.
createdByType	Typ identity, která prostředek vytvořila.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
ExtendedLocation	Rozšířené umístění.
ProvisioningState	Stav zřizování prostředku.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
UsernamePasswordCredentials	Přihlašovací údaje pro režim ověřování UsernamePassword.
X509Credentials	Certifikát x509 pro certifikát v režimu ověřování.

AssetEndpointProfile

Objekt

Definice profilu koncového bodu assetu

Name	Typ	Description
extendedLocation	ExtendedLocation	Rozšířené umístění.
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Geografické umístění, ve kterém se nachází zdroj
name	string	Název prostředku
properties.additionalConfiguration	string	Stringifikovaný JSON, který obsahuje konkrétní konkrétní typ připojení (např. OPC UA, Modbus, ONVIF).
properties.authentication	Authentication	Definuje mechanismus ověřování klienta na server.
properties.discoveredAssetEndpointProfileRef	string	Odkaz na profil zjištěného koncového bodu prostředku Naplněno pouze v případě, že byl profil koncového bodu prostředku vytvořen z toku zjišťování. Je nutné zadat název profilu zjištěného koncového bodu prostředku.
properties.endpointProfileType	string	Definuje konfiguraci pro typ konektoru, který se používá s profilem koncového bodu.
properties.provisioningState	ProvisioningState	Stav zřizování prostředku
properties.status	AssetEndpointProfileStatus	Objekt pouze ke čtení odráží změny, ke kterým došlo na zařízení Edge. Podobně jako vlastnost stavu Kubernetes pro vlastní prostředky.
properties.targetAddress	string (uri)	Místní platný identifikátor URI, který určuje název síťové adresy nebo DNS pro zařízení na jih. Část schématu identifikátoru URI targetAddress určuje typ zařízení. Pole AdditionalConfiguration obsahuje další konfiguraci konkrétního typu konektoru.
properties.uuid	string	Globálně jedinečné, neměnné, opakovaně použitelné ID.
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
tags	object	Značky prostředků
type	string	Typ prostředku. Např. "Microsoft.Compute/virtualMachines" nebo "Microsoft.Storage/storageAccounts"

AssetEndpointProfileListResult

Objekt

Odpověď operace seznamu AssetEndpointProfile.

Name	Typ	Description
nextLink	string (uri)	Odkaz na další stránku položek
value	AssetEndpointProfile[]	Položky AssetEndpointProfile na této stránce

AssetEndpointProfileStatus

Objekt

Definuje vlastnosti stavu profilu koncového bodu prostředku.

Name	Typ	Description
errors	AssetEndpointProfileStatusError[]	Array pro přenos a zachování chyb, které pocházejí ze zařízení Edge.

AssetEndpointProfileStatusError

Objekt

Definuje vlastnosti chyby profilu koncového bodu prostředku.

Name	Typ	Description
code	integer (int32)	Kód chyby pro klasifikaci chyb (např. 400, 404, 500 atd.).
message	string	Uživatelsky čitelná užitečná chybová zpráva, která poskytuje další kontext pro chybu (např. "targetAddress 'foo' není platná adresa URL").

Authentication

Objekt

Definice mechanismu ověřování klienta na server.

Name	Typ	Default value	Description
method	AuthenticationMethod	Certificate	Definuje metodu pro ověření uživatele klienta na serveru.
usernamePasswordCredentials	UsernamePasswordCredentials		Definuje odkazy na uživatelské jméno a heslo při výběru režimu ověřování uživatele UsernamePassword.
x509Credentials	X509Credentials		Definuje odkaz na certifikát při výběru režimu ověřování uživatele certifikátu.

AuthenticationMethod

Výčet

Metoda ověření uživatele klienta na serveru.

Hodnota	Description
Anonymous	Metoda ověření uživatele je anonymní.
Certificate	Metodou ověření uživatele je certifikát x509.
UsernamePassword	Metodou ověření uživatele je uživatelské jméno a heslo.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

ExtendedLocation

Objekt

Rozšířené umístění.

Name	Typ	Description
name	string	Název rozšířeného umístění.
type	string	Typ rozšířeného umístění.

ProvisioningState

Výčet

Stav zřizování prostředku.

Hodnota	Description
Succeeded	Zdroj byl vytvořen.
Failed	Vytvoření zdroje se nezdařilo.
Canceled	Vytváření zdrojů bylo zrušeno.
Accepted	Zdroj byl serverem přijat.
Deleting	Prostředek se odstraňuje.

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

UsernamePasswordCredentials

Objekt

Přihlašovací údaje pro režim ověřování UsernamePassword.

Name	Typ	Description
passwordSecretName	string	Název tajného kódu obsahujícího heslo.
usernameSecretName	string	Název tajného kódu obsahujícího uživatelské jméno.

X509Credentials

Objekt

Certifikát x509 pro certifikát v režimu ověřování.

Name	Typ	Description
certificateSecretName	string	Název tajného kódu obsahujícího certifikát a privátní klíč (např. uložený jako .der/.pem nebo .der/.pfx).

Sdílet prostřednictvím

Asset Endpoint Profiles - List By Resource Group

Parametry identifikátoru URI

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

List_AssetEndpointProfiles_ByResourceGroup

Ukázkový požadavek

Ukázková odpověď

Definice

AssetEndpointProfile

AssetEndpointProfileListResult

AssetEndpointProfileStatus

AssetEndpointProfileStatusError

Authentication

AuthenticationMethod

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ProvisioningState

systemData

UsernamePasswordCredentials

X509Credentials