Delen via


Catalogs - List Devices

Een lijst met apparaten voor de catalogus.

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}

URI-parameters

Name In Vereist Type Description
catalogName
path True

string

Naam van catalogus

Regex-patroon: ^[A-Za-z0-9_-]{1,50}$

resourceGroupName
path True

string

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

subscriptionId
path True

string

De id van het doelabonnement.

api-version
query True

string

De API-versie die voor deze bewerking moet worden gebruikt.

$filter
query

string

De resultatenlijst filteren met behulp van de opgegeven expressie

$maxpagesize
query

integer

int32

Het maximum aantal resultaatitems per pagina.

$skip
query

integer

int32

Het aantal resultaatitems dat moet worden overgeslagen.

$top
query

integer

int32

Het aantal resultaatitems dat moet worden geretourneerd.

Antwoorden

Name Type Description
200 OK

DeviceListResult

De Azure-bewerking is voltooid.

Other Status Codes

ErrorResponse

Een onverwacht foutbericht.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom.

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

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Catalogs_ListDevices

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
createdByType

Het type identiteit waarmee de resource is gemaakt.

Device

Een apparaatresource die deel uitmaakt van een resource van een apparaatgroep.

DeviceListResult

Het antwoord van een apparaatlijstbewerking.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

ProvisioningState

Inrichtingsstatus van resource.

systemData

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

createdByType

Het type identiteit waarmee de resource is gemaakt.

Name Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

Device

Een apparaatresource die deel uitmaakt van een resource van een apparaatgroep.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

De naam van de resource

properties.chipSku

string

SKU van de chip

properties.deviceId

string

Apparaat-ID

properties.lastAvailableOsVersion

string

Versie van het besturingssysteem die beschikbaar is voor installatie wanneer een update wordt aangevraagd

properties.lastInstalledOsVersion

string

Versie van het besturingssysteem die wordt uitgevoerd op het apparaat wanneer een update wordt aangevraagd

properties.lastOsUpdateUtc

string

Tijdstip waarop de update is aangevraagd en de nieuwe versie van het besturingssysteem beschikbaar is

properties.lastUpdateRequestUtc

string

Tijdstip waarop de update voor het laatst is aangevraagd

properties.provisioningState

ProvisioningState

De status van de laatste bewerking.

systemData

systemData

Azure Resource Manager-metagegevens met informatie over createdBy en modifiedBy.

type

string

Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

DeviceListResult

Het antwoord van een apparaatlijstbewerking.

Name Type Description
nextLink

string

De koppeling naar de volgende pagina met items

value

Device[]

De apparaatitems op deze pagina

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

ProvisioningState

Inrichtingsstatus van resource.

Name Type Description
Accepted

string

De aanvraag voor het maken van resources is geaccepteerd

Canceled

string

Het maken van resources is geannuleerd.

Deleting

string

De resource wordt verwijderd

Failed

string

Het maken van resources is mislukt.

Provisioning

string

De resource wordt ingericht

Succeeded

string

De resource is gemaakt.

Updating

string

De resource wordt bijgewerkt

systemData

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

Name Type Description
createdAt

string

De tijdstempel van het maken van resources (UTC).

createdBy

string

De identiteit die de resource heeft gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.

lastModifiedAt

string

Het tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

De identiteit die de resource het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource het laatst heeft gewijzigd.