Asset Endpoint Profiles - List By Resource Group

Tjänst:: Device Registry

API-versionen:: 2026-04-01

Lista AssetEndpointProfile-resurser efter resursgrupp

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

URI-parametrar

Namn	I	Krävs	Typ	Beskrivning
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Svaren

Namn	Typ	Beskrivning
200 OK	AssetEndpointProfileListResult	Azure-åtgärden har slutförts.
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Rinna: implicit
Auktorisations-URL: https://login.microsoftonline.com/common/oauth2/authorize

Scope

Namn	Beskrivning
user_impersonation	personifiera ditt användarkonto

Exempel

List_AssetEndpointProfiles_ByResourceGroup

Exempelförfrågan

HTTP

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

Exempelsvar

Statuskod:: 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"
      }
    }
  ]
}

Definitioner

Namn	Beskrivning
AssetEndpointProfile	Definition av tillgångsslutpunktsprofil.
AssetEndpointProfileListResult	Svaret från en AssetEndpointProfile-liståtgärd.
AssetEndpointProfileStatus	Definierar statusegenskaperna för tillgångsslutpunktsprofilen.
AssetEndpointProfileStatusError	Definierar statusfelegenskaperna för tillgångsslutpunktsprofilen.
Authentication	Definition av klientautentiseringsmekanismen för servern.
AuthenticationMethod	Metoden för att autentisera klientens användare på servern.
createdByType	Den typ av identitet som skapade resursen.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
ExtendedLocation	Den utökade platsen.
ProvisioningState	Resursens etableringsstatus.
systemData	Metadata som rör skapande och senaste ändring av resursen.
UsernamePasswordCredentials	Autentiseringsuppgifterna för autentiseringsläget UsernamePassword.
X509Credentials	X509-certifikatet för certifikat för autentiseringsläge.

AssetEndpointProfile

Objekt

Definition av tillgångsslutpunktsprofil.

Namn	Typ	Beskrivning
extendedLocation	ExtendedLocation	Den utökade platsen.
id	string (arm-id)	Fullständigt kvalificerat resurs-ID för resursen. T.ex. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Den geo-plats där resursen finns
name	string	Namnet på resursen
properties.additionalConfiguration	string	Strängifierad JSON som innehåller anslutningstyp specifik ytterligare konfiguration (t.ex. OPC UA, Modbus, ONVIF).
properties.authentication	Authentication	Definierar klientautentiseringsmekanismen för servern.
properties.discoveredAssetEndpointProfileRef	string	Referens till en identifierad tillgångsslutpunktsprofil. Fylls endast i om tillgångsslutpunktsprofilen har skapats från identifieringsflödet. Namn på identifierad tillgångsslutpunktsprofil måste anges.
properties.endpointProfileType	string	Definierar konfigurationen för anslutningstypen som används med slutpunktsprofilen.
properties.provisioningState	ProvisioningState	Etableringstillstånd för resursen.
properties.status	AssetEndpointProfileStatus	Skrivskyddat objekt för att återspegla ändringar som har inträffat på Edge. Liknar Kubernetes-statusegenskapen för anpassade resurser.
properties.targetAddress	string (uri)	Den lokala giltiga URI:n som anger nätverksadressen/DNS-namnet på en enhet i södergående riktning. Schemadelen av targetAddress-URI anger enhetens typ. Fältet additionalConfiguration innehåller ytterligare konfiguration av anslutningstyp.
properties.uuid	string	Globalt unikt, oföränderligt, icke-återanvändbart id.
systemData	systemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
tags	object	Resursetiketter.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

AssetEndpointProfileListResult

Objekt

Svaret från en AssetEndpointProfile-liståtgärd.

Namn	Typ	Beskrivning
nextLink	string (uri)	Länken till nästa sida med objekt
value	AssetEndpointProfile[]	Objekten AssetEndpointProfile på den här sidan

AssetEndpointProfileStatus

Objekt

Definierar statusegenskaperna för tillgångsslutpunktsprofilen.

Namn	Typ	Beskrivning
errors	AssetEndpointProfileStatusError[]	Array-objekt för att överföra och bevara fel som kommer från Edge.

AssetEndpointProfileStatusError

Objekt

Definierar statusfelegenskaperna för tillgångsslutpunktsprofilen.

Namn	Typ	Beskrivning
code	integer (int32)	Felkod för klassificering av fel (t.ex. 400, 404, 500 osv.).
message	string	Hjälpsamt felmeddelande som kan läsas av människor för att ge ytterligare kontext för fel (t.ex. "targetAddress 'foo' är inte en giltig url").

Authentication

Objekt

Definition av klientautentiseringsmekanismen för servern.

Namn	Typ	Standardvärde	Beskrivning
method	AuthenticationMethod	Certificate	Definierar metoden för att autentisera klientens användare på servern.
usernamePasswordCredentials	UsernamePasswordCredentials		Definierar referenserna för användarnamn och lösenord när användarautentiseringsläget UsernamePassword har valts.
x509Credentials	X509Credentials		Definierar certifikatreferensen när autentiseringsläge för certifikatanvändare har valts.

AuthenticationMethod

Uppräkning

Metoden för att autentisera klientens användare på servern.

Värde	Beskrivning
Anonymous	Användarautentiseringsmetoden är anonym.
Certificate	Användarautentiseringsmetoden är ett x509-certifikat.
UsernamePassword	Användarautentiseringsmetoden är ett användarnamn och lösenord.

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Beskrivning
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Namn	Typ	Beskrivning
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Namn	Typ	Beskrivning
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Namn	Typ	Beskrivning
error	ErrorDetail	Felobjektet.

ExtendedLocation

Objekt

Den utökade platsen.

Namn	Typ	Beskrivning
name	string	Namnet på den utökade platsen.
type	string	Den utökade platstypen.

ProvisioningState

Uppräkning

Resursens etableringsstatus.

Värde	Beskrivning
Succeeded	Resursen har skapats.
Failed	Det gick inte att skapa resurser.
Canceled	Resursskapandet avbröts.
Accepted	Resursen har godkänts av servern.
Deleting	Resursen tas bort.

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Namn	Typ	Beskrivning
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för senaste ändring av resurs (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

UsernamePasswordCredentials

Objekt

Autentiseringsuppgifterna för autentiseringsläget UsernamePassword.

Namn	Typ	Beskrivning
passwordSecretName	string	Namnet på hemligheten som innehåller lösenordet.
usernameSecretName	string	Namnet på hemligheten som innehåller användarnamnet.

X509Credentials

Objekt

X509-certifikatet för certifikat för autentiseringsläge.

Namn	Typ	Beskrivning
certificateSecretName	string	Namnet på hemligheten som innehåller certifikatet och den privata nyckeln (t.ex. lagras som .der/.pem eller .der/.pfx).

Dela via

Asset Endpoint Profiles - List By Resource Group

URI-parametrar

Svaren

Säkerhet

azure_auth

Scope

Exempel

List_AssetEndpointProfiles_ByResourceGroup

Exempelförfrågan

Exempelsvar

Definitioner

AssetEndpointProfile

AssetEndpointProfileListResult

AssetEndpointProfileStatus

AssetEndpointProfileStatusError

Authentication

AuthenticationMethod

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ProvisioningState

systemData

UsernamePasswordCredentials

X509Credentials