Asset Endpoint Profiles - List By Resource Group

Usługa:: Device Registry

Wersja API:: 2026-04-01

Wyświetlanie listy zasobów AssetEndpointProfile według grupy zasobów

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

Parametry URI

Nazwa	W	Wymagane	Typ	Opis
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	AssetEndpointProfileListResult	Operacja platformy Azure została zakończona pomyślnie.
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresów

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

List_AssetEndpointProfiles_ByResourceGroup

Przykładowa prośba

HTTP

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

Przykładowa odpowiedź

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

Definicje

Nazwa	Opis
AssetEndpointProfile	Definicja profilu punktu końcowego zasobu.
AssetEndpointProfileListResult	Odpowiedź operacji listy AssetEndpointProfile.
AssetEndpointProfileStatus	Definiuje właściwości stanu profilu punktu końcowego zasobu.
AssetEndpointProfileStatusError	Definiuje właściwości błędu stanu profilu punktu końcowego zasobu.
Authentication	Definicja mechanizmu uwierzytelniania klienta na serwerze.
AuthenticationMethod	Metoda uwierzytelniania użytkownika klienta na serwerze.
createdByType	Typ tożsamości, która utworzyła zasób.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
ExtendedLocation	Lokalizacja rozszerzona.
ProvisioningState	Stan aprowizacji zasobu.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
UsernamePasswordCredentials	Poświadczenia trybu uwierzytelniania UsernamePassword.
X509Credentials	Certyfikat x509 dla trybu uwierzytelniania Certyfikat.

AssetEndpointProfile

Sprzeciwiać się

Definicja profilu punktu końcowego zasobu.

Nazwa	Typ	Opis
extendedLocation	ExtendedLocation	Lokalizacja rozszerzona.
id	string (arm-id)	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Lokalizacja geograficzna, w której znajduje się zasób
name	string	Nazwa zasobu
properties.additionalConfiguration	string	Ciągyfikowany kod JSON zawierający typ łączności specyficzny dla dalszej konfiguracji (np. OPC UA, Modbus, ONVIF).
properties.authentication	Authentication	Definiuje mechanizm uwierzytelniania klienta na serwerze.
properties.discoveredAssetEndpointProfileRef	string	Odwołanie do odnalezionego profilu punktu końcowego zasobu. Wypełnione tylko wtedy, gdy profil punktu końcowego zasobu został utworzony na podstawie przepływu odnajdywania. Należy podać nazwę odnalezionego profilu punktu końcowego zasobu.
properties.endpointProfileType	string	Definiuje konfigurację typu łącznika używanego z profilem punktu końcowego.
properties.provisioningState	ProvisioningState	Stan aprowizacji zasobu.
properties.status	AssetEndpointProfileStatus	Tylko do odczytu, aby odzwierciedlić zmiany, które zaszły w przeglądarce Edge. Podobnie jak właściwość stanu kubernetes dla zasobów niestandardowych.
properties.targetAddress	string (uri)	Lokalny prawidłowy identyfikator URI określający adres sieciowy/nazwę DNS urządzenia przychodzącego. Część schematu identyfikatora URI targetAddress określa typ urządzenia. Pole additionalConfiguration zawiera dalszą konfigurację określonego typu łącznika.
properties.uuid	string	Unikatowy na całym świecie, niezmienny, nienadający się do ponownego użycia identyfikator.
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
tags	object	Tagi zasobów.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

AssetEndpointProfileListResult

Sprzeciwiać się

Odpowiedź operacji listy AssetEndpointProfile.

Nazwa	Typ	Opis
nextLink	string (uri)	Link do następnej strony z elementami
value	AssetEndpointProfile[]	Elementy AssetEndpointProfile na tej stronie

AssetEndpointProfileStatus

Sprzeciwiać się

Definiuje właściwości stanu profilu punktu końcowego zasobu.

Nazwa	Typ	Opis
errors	AssetEndpointProfileStatusError[]	Array do przesyłania i utrwalania błędów, które pochodzą z przeglądarki Edge.

AssetEndpointProfileStatusError

Sprzeciwiać się

Definiuje właściwości błędu stanu profilu punktu końcowego zasobu.

Nazwa	Typ	Opis
code	integer (int32)	Kod błędu do klasyfikacji błędów (np. 400, 404, 500 itd.).
message	string	Czytelny dla człowieka pomocny komunikat o błędzie w celu zapewnienia dodatkowego kontekstu błędu (np. "targetAddress 'foo' nie jest prawidłowym adresem URL").

Authentication

Sprzeciwiać się

Definicja mechanizmu uwierzytelniania klienta na serwerze.

Nazwa	Typ	Wartość domyślna	Opis
method	AuthenticationMethod	Certificate	Definiuje metodę uwierzytelniania użytkownika klienta na serwerze.
usernamePasswordCredentials	UsernamePasswordCredentials		Definiuje odwołania do nazwy użytkownika i hasła po wybraniu trybu uwierzytelniania użytkownika UsernamePassword.
x509Credentials	X509Credentials		Definiuje odwołanie do certyfikatu po wybraniu trybu uwierzytelniania użytkownika certyfikatu.

AuthenticationMethod

Wyliczenie

Metoda uwierzytelniania użytkownika klienta na serwerze.

Wartość	Opis
Anonymous	Metoda uwierzytelniania użytkownika jest anonimowa.
Certificate	Metodą uwierzytelniania użytkownika jest certyfikat x509.
UsernamePassword	Metodą uwierzytelniania użytkownika jest nazwa użytkownika i hasło.

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Sprzeciwiać się

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Sprzeciwiać się

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Sprzeciwiać się

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

ExtendedLocation

Sprzeciwiać się

Lokalizacja rozszerzona.

Nazwa	Typ	Opis
name	string	Nazwa lokalizacji rozszerzonej.
type	string	Typ lokalizacji rozszerzonej.

ProvisioningState

Wyliczenie

Stan aprowizacji zasobu.

Wartość	Opis
Succeeded	Zasób został utworzony.
Failed	Tworzenie zasobu nie powiodło się.
Canceled	Tworzenie zasobu zostało anulowane.
Accepted	Zasób został zaakceptowany przez serwer.
Deleting	Zasób jest usuwany.

systemData

Sprzeciwiać się

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

UsernamePasswordCredentials

Sprzeciwiać się

Poświadczenia trybu uwierzytelniania UsernamePassword.

Nazwa	Typ	Opis
passwordSecretName	string	Nazwa wpisu tajnego zawierającego hasło.
usernameSecretName	string	Nazwa wpisu tajnego zawierającego nazwę użytkownika.

X509Credentials

Sprzeciwiać się

Certyfikat x509 dla trybu uwierzytelniania Certyfikat.

Nazwa	Typ	Opis
certificateSecretName	string	Nazwa wpisu tajnego zawierającego certyfikat i klucz prywatny (np. przechowywany jako .der/.pem lub .der/.pfx).

Udostępnij za pośrednictwem

Asset Endpoint Profiles - List By Resource Group

Parametry URI

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresów

Przykłady

List_AssetEndpointProfiles_ByResourceGroup

Przykładowa prośba

Przykładowa odpowiedź

Definicje

AssetEndpointProfile

AssetEndpointProfileListResult

AssetEndpointProfileStatus

AssetEndpointProfileStatusError

Authentication

AuthenticationMethod

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ProvisioningState

systemData

UsernamePasswordCredentials

X509Credentials