Asset Endpoint Profiles - List By Resource Group

Service:: Device Registry

API-versie:: 2026-04-01

AssetEndpointProfile-resources per resourcegroep weergeven

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	AssetEndpointProfileListResult	De Azure-bewerking is voltooid.
Other Status Codes	ErrorResponse	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

List_AssetEndpointProfiles_ByResourceGroup

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

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

Definities

Name	Description
AssetEndpointProfile	Definitie van asseteindpuntprofiel.
AssetEndpointProfileListResult	De reactie van een AssetEndpointProfile-lijstbewerking.
AssetEndpointProfileStatus	Hiermee definieert u de eigenschappen van de status van het asseteindpuntprofiel.
AssetEndpointProfileStatusError	Definieert de fouteigenschappen van het asseteindpuntprofiel.
Authentication	Definitie van het clientverificatiemechanisme voor de server.
AuthenticationMethod	De methode voor het verifiëren van de gebruiker van de client op de server.
createdByType	Het type identiteit waarmee de resource is gemaakt.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
ExtendedLocation	De uitgebreide locatie.
ProvisioningState	De inrichtingsstatus van de resource.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
UsernamePasswordCredentials	De referenties voor verificatiemodus UsernamePassword.
X509Credentials	Het x509-certificaat voor verificatiemoduscertificaat.

AssetEndpointProfile

Object

Definitie van asseteindpuntprofiel.

Name	Type	Description
extendedLocation	ExtendedLocation	De uitgebreide locatie.
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijv. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	De geografische locatie waar de resource zich bevindt
name	string	De naam van de resource
properties.additionalConfiguration	string	Tekenreeks-JSON met een verbindingstype dat specifieke verdere configuratie bevat (bijvoorbeeld OPC UA, Modbus, ONVIF).
properties.authentication	Authentication	Hiermee definieert u het mechanisme voor clientverificatie voor de server.
properties.discoveredAssetEndpointProfileRef	string	Verwijzing naar een gedetecteerd asseteindpuntprofiel. Alleen ingevuld als het asseteindpuntprofiel is gemaakt op basis van de detectiestroom. De naam van het gedetecteerde asseteindpuntprofiel moet worden opgegeven.
properties.endpointProfileType	string	Hiermee definieert u de configuratie voor het connectortype dat wordt gebruikt met het eindpuntprofiel.
properties.provisioningState	ProvisioningState	Inrichtingsstatus van de resource.
properties.status	AssetEndpointProfileStatus	Alleen-lezen object om wijzigingen weer te geven die zich hebben voorgedaan op de Edge. Vergelijkbaar met Kubernetes-statuseigenschap voor aangepaste resources.
properties.targetAddress	string (uri)	De lokale geldige URI waarmee het netwerkadres/de DNS-naam van een zuid-afhankelijk apparaat wordt opgegeven. Het schemagedeelte van de targetAddress-URI geeft het type van het apparaat aan. Het veld additionalConfiguration bevat verdere specifieke configuratie voor connectortypen.
properties.uuid	string	Wereldwijd unieke, onveranderlijke, niet-herbruikbare id.
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
tags	object	Resourcetags.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

AssetEndpointProfileListResult

Object

De reactie van een AssetEndpointProfile-lijstbewerking.

Name	Type	Description
nextLink	string (uri)	De koppeling naar de volgende pagina met items
value	AssetEndpointProfile[]	De AssetEndpointProfile-items op deze pagina

AssetEndpointProfileStatus

Object

Hiermee definieert u de eigenschappen van de status van het asseteindpuntprofiel.

Name	Type	Description
errors	AssetEndpointProfileStatusError[]	Array-object om fouten die afkomstig zijn van de rand over te dragen en te behouden.

AssetEndpointProfileStatusError

Object

Definieert de fouteigenschappen van het asseteindpuntprofiel.

Name	Type	Description
code	integer (int32)	Foutcode voor de classificatie van fouten (bijv. 400, 404, 500, enz.).
message	string	Door mensen leesbare nuttige foutmelding om extra context voor fouten te bieden (bijvoorbeeld: "targetAddress 'foo' is geen geldige url").

Authentication

Object

Definitie van het clientverificatiemechanisme voor de server.

Name	Type	Default value	Description
method	AuthenticationMethod	Certificate	Hiermee definieert u de methode voor het verifiëren van de gebruiker van de client op de server.
usernamePasswordCredentials	UsernamePasswordCredentials		Hiermee definieert u de gebruikersnaam en wachtwoordverwijzingen wanneer de gebruikersverificatiemodus UsernamePassword is geselecteerd.
x509Credentials	X509Credentials		Hiermee definieert u de certificaatreferentie wanneer de verificatiemodus voor certificaatgebruikers is geselecteerd.

AuthenticationMethod

Opsomming

De methode voor het verifiëren van de gebruiker van de client op de server.

Waarde	Description
Anonymous	De authenticatiemethode van de gebruiker is anoniem.
Certificate	De gebruikersverificatiemethode is een x509-certificaat.
UsernamePassword	De gebruikersverificatiemethode is een gebruikersnaam en wachtwoord.

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

ExtendedLocation

Object

De uitgebreide locatie.

Name	Type	Description
name	string	De naam van de uitgebreide locatie.
type	string	Het uitgebreide locatietype.

ProvisioningState

Opsomming

De inrichtingsstatus van de resource.

Waarde	Description
Succeeded	Er is een bron gemaakt.
Failed	Het maken van bronnen is mislukt.
Canceled	Het maken van grondstoffen is geannuleerd.
Accepted	De bron is geaccepteerd door de server.
Deleting	Resource is aan het verwijderen.

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

UsernamePasswordCredentials

Object

De referenties voor verificatiemodus UsernamePassword.

Name	Type	Description
passwordSecretName	string	De naam van het geheim met het wachtwoord.
usernameSecretName	string	De naam van het geheim met de gebruikersnaam.

X509Credentials

Object

Het x509-certificaat voor verificatiemoduscertificaat.

Name	Type	Description
certificateSecretName	string	De naam van het geheim met het certificaat en de persoonlijke sleutel (bijvoorbeeld opgeslagen als .der/.pem of .der/.pfx).

Delen via

Asset Endpoint Profiles - List By Resource Group

URI-parameters

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

List_AssetEndpointProfiles_ByResourceGroup

Voorbeeldaanvraag

Voorbeeldrespons

Definities

AssetEndpointProfile

AssetEndpointProfileListResult

AssetEndpointProfileStatus

AssetEndpointProfileStatusError

Authentication

AuthenticationMethod

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ProvisioningState

systemData

UsernamePasswordCredentials

X509Credentials