Compartir a través de


Catalogs - List Devices

Enumera los dispositivos para el catálogo.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/listDevices?api-version=2024-04-01
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/listDevices?api-version=2024-04-01&$filter={$filter}&$top={$top}&$skip={$skip}&$maxpagesize={$maxpagesize}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
catalogName
path True

string

Nombre del catálogo

Patrón de Regex: ^[A-Za-z0-9_-]{1,50}$

resourceGroupName
path True

string

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

subscriptionId
path True

string

Identificador de la suscripción de destino.

api-version
query True

string

Versión de API que se usará para la operación.

$filter
query

string

Filtrar la lista de resultados mediante la expresión especificada

$maxpagesize
query

integer

int32

Número máximo de elementos de resultado por página.

$skip
query

integer

int32

Número de elementos de resultado que se van a omitir.

$top
query

integer

int32

Número de elementos de resultado que se van a devolver.

Respuestas

Nombre Tipo Description
200 OK

DeviceListResult

La operación de Azure se completó correctamente.

Other Status Codes

ErrorResponse

Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

Catalogs_ListDevices

Solicitud de ejemplo

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup1/providers/Microsoft.AzureSphere/catalogs/MyCatalog1/listDevices?api-version=2024-04-01

Respuesta de muestra

{
  "value": [
    {
      "name": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "properties": {}
    },
    {
      "name": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "properties": {}
    }
  ]
}

Definiciones

Nombre Description
createdByType

Tipo de identidad que creó el recurso.

Device

Un recurso de dispositivo que pertenece a un recurso de grupo de dispositivos.

DeviceListResult

Respuesta de una operación de lista de dispositivos.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

ProvisioningState

Estado de aprovisionamiento del recurso.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

createdByType

Tipo de identidad que creó el recurso.

Nombre Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

Device

Un recurso de dispositivo que pertenece a un recurso de grupo de dispositivos.

Nombre Tipo Description
id

string

Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Nombre del recurso.

properties.chipSku

string

SKU del chip

properties.deviceId

string

Id. de dispositivo

properties.lastAvailableOsVersion

string

Versión del sistema operativo disponible para la instalación cuando se solicita la actualización

properties.lastInstalledOsVersion

string

Versión del sistema operativo que se ejecuta en el dispositivo cuando se solicita la actualización

properties.lastOsUpdateUtc

string

Hora en la que se solicita la actualización y la nueva versión del sistema operativo disponible

properties.lastUpdateRequestUtc

string

Hora en la que se solicitó por última vez la actualización

properties.provisioningState

ProvisioningState

Estado de la última operación.

systemData

systemData

Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.

type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

DeviceListResult

Respuesta de una operación de lista de dispositivos.

Nombre Tipo Description
nextLink

string

Vínculo a la página siguiente de elementos

value

Device[]

Los elementos de dispositivo de esta página

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Los detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

ProvisioningState

Estado de aprovisionamiento del recurso.

Nombre Tipo Description
Accepted

string

Se ha aceptado la solicitud de creación de recursos.

Canceled

string

Se canceló la creación de recursos.

Deleting

string

El recurso se está eliminando.

Failed

string

Error en la creación de recursos.

Provisioning

string

El recurso se está aprovisionando.

Succeeded

string

Se ha creado el recurso.

Updating

string

El recurso se está actualizando.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Nombre Tipo Description
createdAt

string

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.