Udostępnij za pośrednictwem

Enrollment Group - Query

  • Odwołanie
Usługa:
IoT Hub Device Provisioning Service
Wersja interfejsu API:
2021-10-01

Wykonaj zapytanie dotyczące grup rejestracji urządzeń.

POST https://your-dps.azure-devices-provisioning.net/enrollmentGroups/query?api-version=2021-10-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
api-version
 query True

string

Wersja interfejsu API do użycia dla żądania. Obsługiwane wersje to: 2021-10-01

Nagłówek żądania

Nazwa Wymagane Typ Opis
x-ms-max-item-count

integer (int32)

Rozmiar strony
x-ms-continuation

string

Token kontynuacji

Treść żądania

Nazwa Wymagane Typ Opis
query True

string

Odpowiedzi

Nazwa Typ Opis
200 OK

EnrollmentGroup[]

Powodzenie

Nagłówki

  • x-ms-continuation: string
  • x-ms-max-item-count: integer
  • x-ms-item-type: string
Other Status Codes

ProvisioningServiceErrorDetails

Odpowiedź na błąd

Nagłówki

x-ms-error-code: string

Definicje

Nazwa Opis
AttestationMechanism

Mechanizm zaświadczania dla poszczególnych Rejestracji, a także enrollmentGroup.
CustomAllocationDefinition

Informuje to usługę DPS, która element webhook ma być wywoływana podczas korzystania z alokacji niestandardowej.
DeviceCapabilities

Możliwości urządzenia.
EnrollmentGroup

Rekord grupy rejestracji.
InitialTwin

Początkowa reprezentacja urządzenia. Zawiera podzbiór właściwości bliźniaczej reprezentacji bliźniaczej.
InitialTwinProperties

Reprezentuje właściwości początkowe, które zostaną ustawione na bliźniaczej reprezentacji urządzenia.
Metadata

Metadane kolekcji TwinCollection
ProvisioningServiceErrorDetails

Zawiera właściwości błędu zwróconego przez usługę Azure IoT Hub Provisioning Service.
QuerySpecification
ReprovisionPolicy

Zachowanie usługi w przypadku ponownej aprowizacji urządzenia w centrum IoT Hub.
SymmetricKeyAttestation

Zaświadczenie za pomocą klucza SymmetricKey.
TpmAttestation

Zaświadczenie za pośrednictwem modułu TPM.
TwinCollection

Reprezentuje kolekcję właściwości w bliźniaczej reprezentacji
X509Attestation

Zaświadczenie za pośrednictwem X509.
X509CAReferences

Odwołania do podstawowego i pomocniczego urzędu certyfikacji.
X509CertificateInfo

Informacje o certyfikacie X509.
X509Certificates

Certyfikaty podstawowe i pomocnicze
X509CertificateWithInfo

Informacje o certyfikacie i certyfikacie

AttestationMechanism

Objekt

Mechanizm zaświadczania dla poszczególnych Rejestracji, a także enrollmentGroup.

Nazwa Typ Opis
symmetricKey

SymmetricKeyAttestation

Zaświadczenie za pomocą klucza SymmetricKey.
tpm

TpmAttestation

Zaświadczenie za pośrednictwem modułu TPM.
type enum:
  • none
  • symmetricKey
  • tpm
  • x509

Typ zaświadczania.
x509

X509Attestation

Zaświadczenie za pośrednictwem X509.

CustomAllocationDefinition

Objekt

Informuje to usługę DPS, która element webhook ma być wywoływana podczas korzystania z alokacji niestandardowej.

Nazwa Typ Opis
apiVersion

string

minLength: 1

Wersja interfejsu API typów usługi aprowizacji (takich jak IndividualEnrollment) wysłanych w niestandardowym żądaniu alokacji. Minimalna obsługiwana wersja: "2018-09-01-preview".
webhookUrl

string

minLength: 1

Adres URL elementu webhook używany do żądań alokacji.

DeviceCapabilities

Objekt

Możliwości urządzenia.

Nazwa Typ Domyślna wartość Opis
iotEdge

boolean

False

Jeśli jest ustawiona wartość true, to urządzenie jest urządzeniem IoTEdge.

EnrollmentGroup

Objekt

Rekord grupy rejestracji.

Nazwa Typ Domyślna wartość Opis
allocationPolicy enum:
  • custom
  • geoLatency
  • hashed
  • static

Zasady alokacji tego zasobu. Te zasady zastępują zasady alokacji na poziomie dzierżawy dla tej indywidualnej rejestracji lub grupy rejestracji. Możliwe wartości obejmują "skrót": połączone centra IoT mają równie duże prawdopodobieństwo aprowizacji urządzeń: geoLatency: urządzenia są aprowidowane w centrum IoT z najniższym opóźnieniem dla urządzenia. Jeśli wiele połączonych centrów IoT zapewni takie samo najmniejsze opóźnienie, urządzenia skrótów usługi aprowizacji w tych centrach, "statyczne" : specyfikacja żądanego centrum IoT na liście rejestracji ma priorytet nad zasadami alokacji na poziomie usługi, "niestandardowe": urządzenia są aprowizowane w centrum IoT na podstawie własnej logiki niestandardowej. Usługa aprowizacji przekazuje informacje o urządzeniu do logiki, a logika zwraca żądane centrum IoT, a także żądaną konfigurację początkową. Zalecamy hostowanie logiki przy użyciu usługi Azure Functions.
attestation

AttestationMechanism

Mechanizm zaświadczania dla poszczególnych Rejestracji, a także enrollmentGroup.
capabilities

DeviceCapabilities

Możliwości urządzenia.
createdDateTimeUtc

string (date-time)

Data/godzina utworzenia tego zasobu.
customAllocationDefinition

CustomAllocationDefinition

Informuje to usługę DPS, która element webhook ma być wywoływana podczas korzystania z alokacji niestandardowej.
enrollmentGroupId

string

minLength: 1

Identyfikator grupy rejestracji.
etag

string

Tag jednostki skojarzony z zasobem.
initialTwin

InitialTwin

Początkowa reprezentacja urządzenia. Zawiera podzbiór właściwości bliźniaczej reprezentacji bliźniaczej.
iotHubHostName

string

Nazwa hosta usługi Iot Hub.
iotHubs

string[]

Lista hostów usługi IoT Hub umożliwia przydzielenie urządzeń w tym zasobie. Musi być podzbiorem listy poziomów dzierżawy centrów IoT.
lastUpdatedDateTimeUtc

string (date-time)

Data/godzina ostatniej aktualizacji tego zasobu.
provisioningStatus enum:
  • disabled
  • enabled
enabled

Stan aprowizacji.
reprovisionPolicy

ReprovisionPolicy

Zachowanie usługi w przypadku ponownej aprowizacji urządzenia w centrum IoT Hub.

InitialTwin

Objekt

Początkowa reprezentacja urządzenia. Zawiera podzbiór właściwości bliźniaczej reprezentacji bliźniaczej.

Nazwa Typ Opis
properties

InitialTwinProperties

Reprezentuje właściwości początkowe, które zostaną ustawione na bliźniaczej reprezentacji urządzenia.
tags

TwinCollection

Reprezentuje kolekcję właściwości w bliźniaczej reprezentacji

InitialTwinProperties

Objekt

Reprezentuje właściwości początkowe, które zostaną ustawione na bliźniaczej reprezentacji urządzenia.

Nazwa Typ Opis
desired

TwinCollection

Reprezentuje kolekcję właściwości w bliźniaczej reprezentacji

Metadata

Objekt

Metadane kolekcji TwinCollection

Nazwa Typ Opis
lastUpdated

string (date-time)

Czas ostatniej aktualizacji elementu TwinCollection
lastUpdatedVersion

integer (int64)

Jest to wartość null dla zgłoszonych metadanych właściwości i nie ma wartości null dla żądanych metadanych właściwości.

ProvisioningServiceErrorDetails

Objekt

Zawiera właściwości błędu zwróconego przez usługę Azure IoT Hub Provisioning Service.

Nazwa Typ Opis
errorCode

integer (int32)

info

object

message

string

timestampUtc

string (date-time)

trackingId

string

QuerySpecification

Objekt
Nazwa Typ Opis
query

string

ReprovisionPolicy

Objekt

Zachowanie usługi w przypadku ponownej aprowizacji urządzenia w centrum IoT Hub.

Nazwa Typ Domyślna wartość Opis
migrateDeviceData

boolean

True

Po ustawieniu wartości true (wartość domyślna) usługa Device Provisioning przeprowadzi migrację danych urządzenia (bliźniaczej reprezentacji, możliwości urządzenia i identyfikatora urządzenia) z jednego centrum IoT do innego podczas aktualizacji przypisania centrum IoT. W przypadku ustawienia wartości false usługa Device Provisioning zresetuje dane urządzenia do początkowej żądanej konfiguracji przechowywanej na odpowiedniej liście rejestracji.
updateHubAssignment

boolean

True

Po ustawieniu wartości true (wartość domyślna) usługa Device Provisioning Service oceni przypisanie usługi IoT Hub urządzenia i zaktualizuje je, jeśli jest to konieczne, aby żądania aprowizacji wykraczały poza pierwsze z danego urządzenia. Jeśli zostanie ustawiona wartość false, urządzenie pozostanie przypisane do bieżącego centrum IoT.

SymmetricKeyAttestation

Objekt

Zaświadczenie za pomocą klucza SymmetricKey.

Nazwa Typ Opis
primaryKey

string

Podstawowy klucz symetryczny.
secondaryKey

string

Pomocniczy klucz symetryczny.

TpmAttestation

Objekt

Zaświadczenie za pośrednictwem modułu TPM.

Nazwa Typ Opis
endorsementKey

string

storageRootKey

string

TwinCollection

Objekt

Reprezentuje kolekcję właściwości w bliźniaczej reprezentacji

Nazwa Typ Opis
count

integer

Liczba właściwości w kolekcji TwinCollection
metadata

Metadata

Metadane kolekcji TwinCollection
version

integer (int64)

Wersja kolekcji TwinCollection

X509Attestation

Objekt

Zaświadczenie za pośrednictwem X509.

Nazwa Typ Opis
caReferences

X509CAReferences

Odwołania do podstawowego i pomocniczego urzędu certyfikacji.
clientCertificates

X509Certificates

Certyfikaty podstawowe i pomocnicze
signingCertificates

X509Certificates

Certyfikaty podstawowe i pomocnicze

X509CAReferences

Objekt

Odwołania do podstawowego i pomocniczego urzędu certyfikacji.

Nazwa Typ Opis
primary

string

secondary

string

X509CertificateInfo

Objekt

Informacje o certyfikacie X509.

Nazwa Typ Opis
issuerName

string

notAfterUtc

string (date-time)

notBeforeUtc

string (date-time)

serialNumber

string

sha1Thumbprint

string

sha256Thumbprint

string

subjectName

string

version

integer (int32)

X509Certificates

Objekt

Certyfikaty podstawowe i pomocnicze

Nazwa Typ Opis
primary

X509CertificateWithInfo

Informacje o certyfikacie i certyfikacie
secondary

X509CertificateWithInfo

Informacje o certyfikacie i certyfikacie

X509CertificateWithInfo

Objekt

Informacje o certyfikacie i certyfikacie

Nazwa Typ Opis
certificate

string

info

X509CertificateInfo

Informacje o certyfikacie X509.