Поделиться через

Individual Enrollment - Query

  • Ссылка
Служба:
IoT Hub Device Provisioning Service
Версия API:
2021-10-01

Запрос записей регистрации устройств.

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

Параметры URI

Имя В Обязательно Тип Описание
api-version
 query True

string

Версия API для использования в запросе. Поддерживаемые версии: 2021-10-01

Заголовок запроса

Имя Обязательно Тип Описание
x-ms-max-item-count

integer

int32

Размер страницы
x-ms-continuation

string

Метка продолжения

Текст запроса

Имя Обязательно Тип Описание
query True

string

Ответы

Имя Тип Описание
200 OK

IndividualEnrollment[]

Успешное завершение

Заголовки

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

ProvisioningServiceErrorDetails

Сообщение об ошибке

Заголовки

x-ms-error-code: string

Определения

Имя Описание
AttestationMechanism

Механизм аттестации для индивидуальной регистрации, а также enrollmentGroup.
CustomAllocationDefinition

Это сообщает DPS, какой веб-перехватчик следует вызывать при использовании пользовательского выделения.
DeviceCapabilities

Возможности устройства.
DeviceRegistrationState

Состояние регистрации устройства.
IndividualEnrollment

Запись регистрации устройства.
InitialTwin

Исходный двойник устройства. Содержит подмножество свойств двойника.
InitialTwinProperties

Представляет начальные свойства, которые будут заданы для двойника устройства.
Metadata

Метаданные для TwinCollection
ProvisioningServiceErrorDetails

Содержит свойства ошибки, возвращаемой службой подготовки Центр Интернета вещей Azure.
QuerySpecification
ReprovisionPolicy

Поведение службы при повторной подготовке устройства в Центре Интернета вещей.
SymmetricKeyAttestation

Аттестация с помощью SymmetricKey.
TpmAttestation

Аттестация с помощью доверенного платформенного модуля.
TwinCollection

Представляет коллекцию свойств в двойником
X509Attestation

Аттестация через X509.
X509CAReferences

Ссылки на первичный и вторичный ЦС.
X509CertificateInfo

Сведения о сертификате X509.
X509Certificates

Первичные и вторичные сертификаты
X509CertificateWithInfo

Сведения о сертификате и сертификате

AttestationMechanism

Механизм аттестации для индивидуальной регистрации, а также enrollmentGroup.

Имя Тип Описание
symmetricKey

SymmetricKeyAttestation

Аттестация с помощью SymmetricKey.
tpm

TpmAttestation

Аттестация с помощью доверенного платформенного модуля.
type enum:
  • none
  • symmetricKey
  • tpm
  • x509

Тип аттестации.
x509

X509Attestation

Аттестация через X509.

CustomAllocationDefinition

Это сообщает DPS, какой веб-перехватчик следует вызывать при использовании пользовательского выделения.

Имя Тип Описание
apiVersion

string

Версия API служб подготовки (например, IndividualEnrollment), отправленная в пользовательском запросе на выделение. Минимальная поддерживаемая версия: "2018-09-01-preview".
webhookUrl

string

URL-адрес веб-перехватчика, используемый для запросов на выделение.

DeviceCapabilities

Возможности устройства.

Имя Тип Default value Описание
iotEdge

boolean

False

Если задано значение true, это устройство является устройством IoTEdge.

DeviceRegistrationState

Состояние регистрации устройства.

Имя Тип Описание
assignedHub

string

Назначенные Центр Интернета вещей Azure.
createdDateTimeUtc

string

Дата создания регистрации (в формате UTC).
deviceId

string

Идентификатор устройства.
errorCode

integer

Код ошибки.
errorMessage

string

Сообщение об ошибке.
etag

string

Тег сущности, связанный с ресурсом.
lastUpdatedDateTimeUtc

string

Дата и время последнего обновления (в формате UTC).
payload

object

registrationId

string

Этот идентификатор используется для уникальной идентификации регистрации устройства. Строка без учета регистра (длиной до 128 символов) буквенно-цифровых символов плюс некоторые специальные символы: . _ -. Специальные символы не допускаются в начале или конце.
status enum:
  • assigned
  • assigning
  • disabled
  • failed
  • unassigned

Состояние регистрации.
substatus enum:
  • deviceDataMigrated
  • deviceDataReset
  • initialAssignment
  • reprovisionedToInitialAssignment

Подсостояние для назначенных устройств. Возможные значения: initialAssignment: устройство было назначено Центру Интернета вещей в первый раз, deviceDataMigrated: устройство было назначено другому центру Интернета вещей, и его данные устройства были перенесены из ранее назначенного Центра Интернета вещей. Данные устройства были удалены из ранее назначенного Центра Интернета вещей deviceDataReset. Устройство было назначено другому центру Интернета вещей, и его данные устройства были заполнены из исходного состояния, хранящегося в регистрации. Данные устройства были удалены из ранее назначенного Центра Интернета вещей reprovisionedToInitialAssignment: устройство было повторно подготовлено к ранее назначенному Центру Интернета вещей.

IndividualEnrollment

Запись регистрации устройства.

Имя Тип Default value Описание
allocationPolicy enum:
  • custom
  • geoLatency
  • hashed
  • static

Политика выделения этого ресурса. Эта политика переопределяет политику распределения на уровне клиента для этой отдельной регистрации или группы регистрации. Возможные значения: hashed. Связанные центры Интернета вещей, скорее всего, будут подготовлены устройства. GeoLatency: устройства подготавливаются в Центре Интернета вещей с наименьшей задержкой на устройстве. Если несколько связанных центров Интернета вещей обеспечивают одинаковую наименьшую задержку, служба подготовки хэширует устройства в этих центрах, "статический": спецификация нужного Центра Интернета вещей в списке регистрации имеет приоритет над политикой выделения на уровне служб. "Пользовательский" : устройства подготавливаются в Центре Интернета вещей на основе вашей собственной пользовательской логики. Служба подготовки передает сведения об устройстве в логику, а логика возвращает нужный Центр Интернета вещей, а также нужную начальную конфигурацию. Для размещения логики рекомендуется использовать Функции Azure.
attestation

AttestationMechanism

Механизм аттестации для индивидуальной регистрации, а также enrollmentGroup.
capabilities

DeviceCapabilities

Возможности устройства.
createdDateTimeUtc

string

Дата и время создания этого ресурса.
customAllocationDefinition

CustomAllocationDefinition

Это сообщает DPS, какой веб-перехватчик следует вызывать при использовании пользовательского выделения.
deviceId

string

Требуемый Центр Интернета вещей идентификатор устройства (необязательно).
etag

string

Тег сущности, связанный с ресурсом.
initialTwin

InitialTwin

Исходный двойник устройства. Содержит подмножество свойств двойника.
iotHubHostName

string

Имя узла Центра Интернета вещей.
iotHubs

string[]

Список Центр Интернета вещей имен узлов, для которых можно выделить устройства в этом ресурсе. Должен быть подмножеством списка центров Интернета вещей на уровне клиента.
lastUpdatedDateTimeUtc

string

Дата и время последнего обновления этого ресурса.
optionalDeviceInformation

TwinCollection

Представляет коллекцию свойств в двойником
provisioningStatus enum:
  • disabled
  • enabled
enabled

Состояние подготовки.
registrationId

string

Этот идентификатор используется для уникальной идентификации регистрации устройства. Строка без учета регистра (длиной до 128 символов) буквенно-цифровых символов плюс некоторые специальные символы: . _ -. Специальные символы не допускаются в начале или конце.
registrationState

DeviceRegistrationState

Состояние регистрации устройства.
reprovisionPolicy

ReprovisionPolicy

Поведение службы при повторной подготовке устройства в Центре Интернета вещей.

InitialTwin

Исходный двойник устройства. Содержит подмножество свойств двойника.

Имя Тип Описание
properties

InitialTwinProperties

Представляет начальные свойства, которые будут заданы для двойника устройства.
tags

TwinCollection

Представляет коллекцию свойств в двойником

InitialTwinProperties

Представляет начальные свойства, которые будут заданы для двойника устройства.

Имя Тип Описание
desired

TwinCollection

Представляет коллекцию свойств в двойником

Metadata

Метаданные для TwinCollection

Имя Тип Описание
lastUpdated

string

Время последнего обновления TwinCollection
lastUpdatedVersion

integer

Это значение равно NULL для метаданных сообщаемого свойства и не равно NULL для метаданных требуемых свойств.

ProvisioningServiceErrorDetails

Содержит свойства ошибки, возвращаемой службой подготовки Центр Интернета вещей Azure.

Имя Тип Описание
errorCode

integer

info

object

message

string

timestampUtc

string

trackingId

string

QuerySpecification

Имя Тип Описание
query

string

ReprovisionPolicy

Поведение службы при повторной подготовке устройства в Центре Интернета вещей.

Имя Тип Default value Описание
migrateDeviceData

boolean

True

Если задано значение true (по умолчанию), служба подготовки устройств будет переносить данные устройства (двойник, возможности устройства и идентификатор устройства) из одного Центра Интернета вещей в другой во время обновления назначения Центра Интернета вещей. Если задано значение false, служба подготовки устройств сбросит данные устройства до начальной требуемой конфигурации, хранящейся в соответствующем списке регистрации.
updateHubAssignment

boolean

True

Если задано значение true (по умолчанию), служба подготовки устройств оценит назначение Центр Интернета вещей устройства и при необходимости обновит его для любых запросов на подготовку, кроме первого с данного устройства. Если задано значение false, устройство останется назначенным текущему Центру Интернета вещей.

SymmetricKeyAttestation

Аттестация с помощью SymmetricKey.

Имя Тип Описание
primaryKey

string

Первичный симметричный ключ.
secondaryKey

string

Вторичный симметричный ключ.

TpmAttestation

Аттестация с помощью доверенного платформенного модуля.

Имя Тип Описание
endorsementKey

string

storageRootKey

string

TwinCollection

Представляет коллекцию свойств в двойником

Имя Тип Описание
count

integer

Число свойств в коллекции TwinCollection
metadata

Metadata

Метаданные для TwinCollection
version

integer

Версия TwinCollection

X509Attestation

Аттестация через X509.

Имя Тип Описание
caReferences

X509CAReferences

Ссылки на первичный и вторичный ЦС.
clientCertificates

X509Certificates

Первичные и вторичные сертификаты
signingCertificates

X509Certificates

Первичные и вторичные сертификаты

X509CAReferences

Ссылки на первичный и вторичный ЦС.

Имя Тип Описание
primary

string

secondary

string

X509CertificateInfo

Сведения о сертификате X509.

Имя Тип Описание
issuerName

string

notAfterUtc

string

notBeforeUtc

string

serialNumber

string

sha1Thumbprint

string

sha256Thumbprint

string

subjectName

string

version

integer

X509Certificates

Первичные и вторичные сертификаты

Имя Тип Описание
primary

X509CertificateWithInfo

Сведения о сертификате и сертификате
secondary

X509CertificateWithInfo

Сведения о сертификате и сертификате

X509CertificateWithInfo

Сведения о сертификате и сертификате

Имя Тип Описание
certificate

string

info

X509CertificateInfo

Сведения о сертификате X509.