Asset Endpoint Profiles - List By Resource Group

Service:: Device Registry

Version d'API:: 2026-04-01

Répertorier les ressources AssetEndpointProfile par groupe de ressources

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Réponses

Nom	Type	Description
200 OK	AssetEndpointProfileListResult	L’opération Azure s’est terminée avec succès.
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

List_AssetEndpointProfiles_ByResourceGroup

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:: 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"
      }
    }
  ]
}

Définitions

Nom	Description
AssetEndpointProfile	Définition du profil de point de terminaison de ressource.
AssetEndpointProfileListResult	Réponse d’une opération de liste AssetEndpointProfile.
AssetEndpointProfileStatus	Définit les propriétés d’état du profil de point de terminaison de ressource.
AssetEndpointProfileStatusError	Définit les propriétés d’erreur d’état du profil de point de terminaison de ressource.
Authentication	Définition du mécanisme d’authentification du client sur le serveur.
AuthenticationMethod	Méthode permettant d’authentifier l’utilisateur du client sur le serveur.
createdByType	Type d’identité qui a créé la ressource.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
ExtendedLocation	Emplacement étendu.
ProvisioningState	État d’approvisionnement de la ressource.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
UsernamePasswordCredentials	Informations d’identification pour le mode d’authentification UsernamePassword.
X509Credentials	Certificat x509 pour le certificat en mode d’authentification.

AssetEndpointProfile

Objet

Définition du profil de point de terminaison de ressource.

Nom	Type	Description
extendedLocation	ExtendedLocation	Emplacement étendu.
id	string (arm-id)	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
location	string	Emplacement géographique où réside la ressource
name	string	Nom de la ressource
properties.additionalConfiguration	string	JSON stringified qui contient une configuration supplémentaire spécifique au type de connectivité (par exemple OPC UA, Modbus, ONVIF).
properties.authentication	Authentication	Définit le mécanisme d’authentification du client sur le serveur.
properties.discoveredAssetEndpointProfileRef	string	Référence à un profil de point de terminaison de ressource découvert. Renseigné uniquement si le profil de point de terminaison de ressource a été créé à partir du flux de découverte. Le nom du profil de point de terminaison de ressource découvert doit être fourni.
properties.endpointProfileType	string	Définit la configuration du type de connecteur utilisé avec le profil de point de terminaison.
properties.provisioningState	ProvisioningState	État d’approvisionnement de la ressource.
properties.status	AssetEndpointProfileStatus	Objet en lecture seule pour refléter les modifications qui se sont produites sur le dispositif Edge. Similaire à la propriété d’état Kubernetes pour les ressources personnalisées.
properties.targetAddress	string (uri)	URI valide local spécifiant l’adresse réseau/le nom DNS d’un appareil entrant sud. La partie schéma de l’URI targetAddress spécifie le type de l’appareil. Le champ additionalConfiguration contient une configuration spécifique au type de connecteur supplémentaire.
properties.uuid	string	Identifiant unique au monde, immuable et non réutilisable.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags	object	Balises de ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

AssetEndpointProfileListResult

Objet

Réponse d’une opération de liste AssetEndpointProfile.

Nom	Type	Description
nextLink	string (uri)	Le lien vers la page suivante des éléments
value	AssetEndpointProfile[]	Les éléments AssetEndpointProfile de cette page

AssetEndpointProfileStatus

Objet

Définit les propriétés d’état du profil de point de terminaison de ressource.

Nom	Type	Description
errors	AssetEndpointProfileStatusError[]	Array pour transférer et conserver les erreurs provenant du dispositif Edge.

AssetEndpointProfileStatusError

Objet

Définit les propriétés d’erreur d’état du profil de point de terminaison de ressource.

Nom	Type	Description
code	integer (int32)	Code d’erreur pour la classification des erreurs (ex : 400, 404, 500, etc.).
message	string	Message d’erreur utile lisible par l’homme pour fournir un contexte supplémentaire en cas d’erreur (ex : « targetAddress 'foo' n’est pas une URL valide »).

Authentication

Objet

Définition du mécanisme d’authentification du client sur le serveur.

Nom	Type	Valeur par défaut	Description
method	AuthenticationMethod	Certificate	Définit la méthode pour authentifier l’utilisateur du client sur le serveur.
usernamePasswordCredentials	UsernamePasswordCredentials		Définit les références de nom d’utilisateur et de mot de passe lorsque le mode d’authentification utilisateur UsernamePassword est sélectionné.
x509Credentials	X509Credentials		Définit la référence de certificat lorsque le mode d’authentification utilisateur du certificat est sélectionné.

AuthenticationMethod

Énumération

Méthode permettant d’authentifier l’utilisateur du client sur le serveur.

Valeur	Description
Anonymous	La méthode d’authentification de l’utilisateur est anonyme.
Certificate	La méthode d’authentification de l’utilisateur est un certificat x509.
UsernamePassword	La méthode d’authentification de l’utilisateur est un nom d’utilisateur et un mot de passe.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Objet

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Objet

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

ExtendedLocation

Objet

Emplacement étendu.

Nom	Type	Description
name	string	Nom de l’emplacement étendu.
type	string	Type d’emplacement étendu.

ProvisioningState

Énumération

État d’approvisionnement de la ressource.

Valeur	Description
Succeeded	La ressource a été créée.
Failed	Échec de la création de ressources.
Canceled	La création de ressources a été annulée.
Accepted	La ressource a été acceptée par le serveur.
Deleting	La ressource est en cours de suppression.

systemData

Objet

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

UsernamePasswordCredentials

Objet

Informations d’identification pour le mode d’authentification UsernamePassword.

Nom	Type	Description
passwordSecretName	string	Nom du secret contenant le mot de passe.
usernameSecretName	string	Nom du secret contenant le nom d’utilisateur.

X509Credentials

Objet

Certificat x509 pour le certificat en mode d’authentification.

Nom	Type	Description
certificateSecretName	string	Nom du secret contenant le certificat et la clé privée (par exemple, stocké en tant que .der/.pem ou .der/.pfx).

Partager via

Asset Endpoint Profiles - List By Resource Group

Paramètres URI

Réponses

Sécurité

azure_auth

Étendues

Exemples

List_AssetEndpointProfiles_ByResourceGroup

Exemple de requête

Exemple de réponse

Définitions

AssetEndpointProfile

AssetEndpointProfileListResult

AssetEndpointProfileStatus

AssetEndpointProfileStatusError

Authentication

AuthenticationMethod

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ProvisioningState

systemData

UsernamePasswordCredentials

X509Credentials