Asset Endpoint Profiles - List By Resource Group

Serviço:: Device Registry

Versão API:: 2026-04-01

Listar recursos AssetEndpointProfile por grupo de recursos

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

Parâmetros URI

Nome	Em	Necessário	Tipo	Descrição
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser um UUID.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Respostas

Nome	Tipo	Descrição
200 OK	AssetEndpointProfileListResult	Operação do Azure concluída com êxito.
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

Tipo: oauth2
Flow: implicit
URL de autorização: https://login.microsoftonline.com/common/oauth2/authorize

Alcances

Nome	Descrição
user_impersonation	personificar a sua conta de utilizador

Exemplos

List_AssetEndpointProfiles_ByResourceGroup

Pedido de exemplo

HTTP

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

Resposta de exemplo

Código de estado:: 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"
      }
    }
  ]
}

Definições

Nome	Descrição
AssetEndpointProfile	Definição do Perfil do Ponto Final do Ativo.
AssetEndpointProfileListResult	A resposta de uma operação de lista AssetEndpointProfile.
AssetEndpointProfileStatus	Define as propriedades de status do perfil de ponto de extremidade do ativo.
AssetEndpointProfileStatusError	Define as propriedades de erro de status do perfil de ponto de extremidade do ativo.
Authentication	Definição do mecanismo de autenticação do cliente para o servidor.
AuthenticationMethod	O método para autenticar o usuário do cliente no servidor.
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ExtendedLocation	A localização estendida.
ProvisioningState	O status de provisionamento do recurso.
systemData	Metadados referentes à criação e última modificação do recurso.
UsernamePasswordCredentials	As credenciais para o modo de autenticação UsernamePassword.
X509Credentials	O certificado x509 para o certificado do modo de autenticação.

AssetEndpointProfile

Objetivo

Definição do Perfil do Ponto Final do Ativo.

Nome	Tipo	Descrição
extendedLocation	ExtendedLocation	A localização estendida.
id	string (arm-id)	ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	A geolocalização onde o recurso vive
name	string	O nome do recurso
properties.additionalConfiguration	string	JSON stringified que contém configuração adicional específica do tipo de conectividade (por exemplo, OPC UA, Modbus, ONVIF).
properties.authentication	Authentication	Define o mecanismo de autenticação do cliente para o servidor.
properties.discoveredAssetEndpointProfileRef	string	Referência a um perfil de ponto de extremidade de ativo descoberto. Preenchido somente se o perfil do ponto de extremidade do ativo tiver sido criado a partir do fluxo de descoberta. O nome do perfil do ponto de extremidade do ativo descoberto deve ser fornecido.
properties.endpointProfileType	string	Define a configuração para o tipo de conector que está sendo usado com o perfil do ponto de extremidade.
properties.provisioningState	ProvisioningState	Estado de provisionamento do recurso.
properties.status	AssetEndpointProfileStatus	Objeto somente leitura para refletir as alterações que ocorreram na borda. Semelhante à propriedade de status do Kubernetes para recursos personalizados.
properties.targetAddress	string (uri)	O URI válido local especificando o endereço de rede/nome DNS de um dispositivo para o sul. A parte do esquema do URI targetAddress especifica o tipo do dispositivo. O campo additionalConfiguration contém outras configurações específicas do tipo de conector.
properties.uuid	string	Id globalmente único, imutável e não reutilizável.
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

AssetEndpointProfileListResult

Objetivo

A resposta de uma operação de lista AssetEndpointProfile.

Nome	Tipo	Descrição
nextLink	string (uri)	O link para a próxima página de itens
value	AssetEndpointProfile[]	Os itens AssetEndpointProfile nesta página

AssetEndpointProfileStatus

Objetivo

Define as propriedades de status do perfil de ponto de extremidade do ativo.

Nome	Tipo	Descrição
errors	AssetEndpointProfileStatusError[]	Objeto de matriz para transferir e persistir erros que se originam da borda.

AssetEndpointProfileStatusError

Objetivo

Define as propriedades de erro de status do perfil de ponto de extremidade do ativo.

Nome	Tipo	Descrição
code	integer (int32)	Código de erro para classificação de erros (ex: 400, 404, 500, etc.).
message	string	Mensagem de erro útil legível por humanos para fornecer contexto adicional para o erro (por exemplo: "targetAddress 'foo' não é um url válido").

Authentication

Objetivo

Definição do mecanismo de autenticação do cliente para o servidor.

Nome	Tipo	Valor padrão	Descrição
method	AuthenticationMethod	Certificate	Define o método para autenticar o usuário do cliente no servidor.
usernamePasswordCredentials	UsernamePasswordCredentials		Define as referências de nome de usuário e senha quando o modo de autenticação de usuário UsernamePassword é selecionado.
x509Credentials	X509Credentials		Define a referência de certificado quando o modo de autenticação de usuário de certificado é selecionado.

AuthenticationMethod

Enumeração

O método para autenticar o usuário do cliente no servidor.

Valor	Descrição
Anonymous	O método de autenticação do usuário é anônimo.
Certificate	O método de autenticação do usuário é um certificado x509.
UsernamePassword	O método de autenticação do usuário é um nome de usuário e senha.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Descrição
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objetivo

O erro de gerenciamento de recursos informações adicionais.

Nome	Tipo	Descrição
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objetivo

O detalhe do erro.

Nome	Tipo	Descrição
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objetivo

Resposta de erro

Nome	Tipo	Descrição
error	ErrorDetail	O objeto de erro.

ExtendedLocation

Objetivo

A localização estendida.

Nome	Tipo	Descrição
name	string	O nome do local estendido.
type	string	O tipo de local estendido.

ProvisioningState

Enumeração

O status de provisionamento do recurso.

Valor	Descrição
Succeeded	O recurso foi criado.
Failed	Falha na criação de recursos.
Canceled	A criação de recursos foi cancelada.
Accepted	O recurso foi aceito pelo servidor.
Deleting	O recurso está sendo excluído.

systemData

Objetivo

Metadados referentes à criação e última modificação do recurso.

Nome	Tipo	Descrição
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

UsernamePasswordCredentials

Objetivo

As credenciais para o modo de autenticação UsernamePassword.

Nome	Tipo	Descrição
passwordSecretName	string	O nome do segredo que contém a senha.
usernameSecretName	string	O nome do segredo que contém o nome de usuário.

X509Credentials

Objetivo

O certificado x509 para o certificado do modo de autenticação.

Nome	Tipo	Descrição
certificateSecretName	string	O nome do segredo que contém o certificado e a chave privada (por exemplo, armazenado como .der/.pem ou .der/.pfx).

Partilhar via

Asset Endpoint Profiles - List By Resource Group

Parâmetros URI

Respostas

Segurança

azure_auth

Alcances

Exemplos

List_AssetEndpointProfiles_ByResourceGroup

Pedido de exemplo

Resposta de exemplo

Definições

AssetEndpointProfile

AssetEndpointProfileListResult

AssetEndpointProfileStatus

AssetEndpointProfileStatusError

Authentication

AuthenticationMethod

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ProvisioningState

systemData

UsernamePasswordCredentials

X509Credentials