Sdílet prostřednictvím


Catalogs - List Devices

Zobrazí seznam zařízení pro katalog.

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}

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
catalogName
path True

string

Název katalogu

Vzor regulárního výrazu: ^[A-Za-z0-9_-]{1,50}$

resourceGroupName
path True

string

Název skupiny prostředků. V názvu se rozlišují malá a velká písmena.

subscriptionId
path True

string

ID cílového předplatného.

api-version
query True

string

Verze rozhraní API, která se má použít pro tuto operaci.

$filter
query

string

Filtrování seznamu výsledků pomocí daného výrazu

$maxpagesize
query

integer

int32

Maximální počet položek výsledků na stránku.

$skip
query

integer

int32

Počet položek výsledku, které se mají přeskočit.

$top
query

integer

int32

Počet položek výsledku, které se mají vrátit.

Odpovědi

Name Typ Description
200 OK

DeviceListResult

Operace Azure se úspěšně dokončila.

Other Status Codes

ErrorResponse

Neočekávaná chybová odpověď.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

Catalogs_ListDevices

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
createdByType

Typ identity, která prostředek vytvořila.

Device

Prostředek zařízení, který patří do prostředku skupiny zařízení.

DeviceListResult

Odpověď operace seznamu zařízení.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě

ErrorResponse

Chybová odpověď

ProvisioningState

Stav zřizování prostředku.

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

createdByType

Typ identity, která prostředek vytvořila.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

Device

Prostředek zařízení, který patří do prostředku skupiny zařízení.

Name Typ Description
id

string

Plně kvalifikované ID prostředku Příklad : /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{resourceProviderNamespace}/{typ_prostředku}/{název_prostředku}

name

string

Název prostředku

properties.chipSku

string

SKU čipu

properties.deviceId

string

ID zařízení

properties.lastAvailableOsVersion

string

Verze operačního systému dostupná k instalaci po vyžádání aktualizace

properties.lastInstalledOsVersion

string

Verze operačního systému spuštěná na zařízení při žádosti o aktualizaci

properties.lastOsUpdateUtc

string

Čas, kdy byla požadována aktualizace a je k dispozici nová verze operačního systému

properties.lastUpdateRequestUtc

string

Čas poslední žádosti o aktualizaci

properties.provisioningState

ProvisioningState

Stav poslední operace.

systemData

systemData

Metadata Azure Resource Manageru obsahující informace createdBy a modifiedBy.

type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

DeviceListResult

Odpověď operace seznamu zařízení.

Name Typ Description
nextLink

string

Odkaz na další stránku položek

value

Device[]

Položky zařízení na této stránce

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.

type

string

Typ další informace.

ErrorDetail

Podrobnosti o chybě

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby

details

ErrorDetail[]

Podrobnosti o chybě.

message

string

Chybová zpráva

target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

ProvisioningState

Stav zřizování prostředku.

Name Typ Description
Accepted

string

Žádost o vytvoření prostředku se přijala.

Canceled

string

Vytváření prostředků se zrušilo.

Deleting

string

Prostředek se odstraňuje.

Failed

string

Vytvoření prostředku se nezdařilo.

Provisioning

string

Probíhá zřizování prostředku.

Succeeded

string

Prostředek se vytvořil.

Updating

string

Prostředek se aktualizuje.

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Name Typ Description
createdAt

string

Časové razítko vytvoření prostředku (UTC)

createdBy

string

Identita, která vytvořila prostředek.

createdByType

createdByType

Typ identity, která prostředek vytvořila.

lastModifiedAt

string

Časové razítko poslední změny prostředku (UTC)

lastModifiedBy

string

Identita, která naposledy změnila prostředek.

lastModifiedByType

createdByType

Typ identity, která naposledy změnila prostředek.