Udostępnij za pośrednictwem


Catalogs - List Devices

Wyświetla listę urządzeń do katalogu.

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 identyfikatora URI

Nazwa W Wymagane Typ Opis
catalogName
path True

string

Nazwa wykazu

Wzorzec wyrażenia regularnego: ^[A-Za-z0-9_-]{1,50}$

resourceGroupName
path True

string

Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.

subscriptionId
path True

string

Identyfikator subskrypcji docelowej.

api-version
query True

string

Wersja interfejsu API do użycia dla tej operacji.

$filter
query

string

Filtrowanie listy wyników przy użyciu podanego wyrażenia

$maxpagesize
query

integer

int32

Maksymalna liczba elementów wyników na stronę.

$skip
query

integer

int32

Liczba elementów wyników do pominięcia.

$top
query

integer

int32

Liczba elementów wyniku do zwrócenia.

Odpowiedzi

Nazwa Typ Opis
200 OK

DeviceListResult

Operacja platformy Azure została ukończona pomyślnie.

Other Status Codes

ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Catalogs_ListDevices

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
createdByType

Typ tożsamości, która utworzyła zasób.

Device

Zasób urządzenia należący do zasobu grupy urządzeń.

DeviceListResult

Odpowiedź operacji listy urządzeń.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

ProvisioningState

Stan aprowizacji zasobu.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa Typ Opis
Application

string

Key

string

ManagedIdentity

string

User

string

Device

Zasób urządzenia należący do zasobu grupy urządzeń.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Nazwa zasobu

properties.chipSku

string

Jednostka SKU mikroukładu

properties.deviceId

string

Identyfikator urządzenia

properties.lastAvailableOsVersion

string

Wersja systemu operacyjnego dostępna do instalacji po zażądaniu aktualizacji

properties.lastInstalledOsVersion

string

Wersja systemu operacyjnego uruchomiona na urządzeniu po zażądaniu aktualizacji

properties.lastOsUpdateUtc

string

Godzina dostępności żądanej aktualizacji i nowej wersji systemu operacyjnego

properties.lastUpdateRequestUtc

string

Godzina ostatniego żądania aktualizacji

properties.provisioningState

ProvisioningState

Stan ostatniej operacji.

systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

DeviceListResult

Odpowiedź operacji listy urządzeń.

Nazwa Typ Opis
nextLink

string

Link do następnej strony elementów

value

Device[]

Elementy urządzenia na tej stronie

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt error.

ProvisioningState

Stan aprowizacji zasobu.

Nazwa Typ Opis
Accepted

string

Żądanie utworzenia zasobu zostało zaakceptowane

Canceled

string

Tworzenie zasobów zostało anulowane.

Deleting

string

Zasób jest usuwany

Failed

string

Tworzenie zasobu nie powiodło się.

Provisioning

string

Zasób jest aprowizowany

Succeeded

string

Zasób został utworzony.

Updating

string

Zasób jest aktualizowany

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string

Sygnatura czasowa tworzenia zasobów (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string

Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.