Share via

Individual Enrollment - Get

  • Ссылка
Service:
IoT Hub Device Provisioning Service
API Version:
2021-10-01

Получение записи регистрации устройства.

GET https://your-dps.azure-devices-provisioning.net/enrollments/{id}?api-version=2021-10-01

Параметры URI

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

string

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

string

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

Ответы

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

IndividualEnrollment

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

ProvisioningServiceErrorDetails

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

Headers

x-ms-error-code: string

Определения

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

Механизм аттестации для individualEnrollment и enrollmentGroup.
CustomAllocationDefinition

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

AttestationMechanism

Механизм аттестации для individualEnrollment и enrollmentGroup.

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

SymmetricKeyAttestation

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

TpmAttestation

Аттестация через TPM.
type enum:
  • none
  • symmetricKey
  • tpm
  • x509

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

X509Attestation

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

CustomAllocationDefinition

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

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

string

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

string

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

DeviceCapabilities

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

Имя Тип Значение по умолчанию Описание
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

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

Имя Тип Значение по умолчанию Описание
allocationPolicy enum:
  • custom
  • geoLatency
  • hashed
  • static

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

AttestationMechanism

Механизм аттестации для individualEnrollment и 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

ReprovisionPolicy

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

Имя Тип Значение по умолчанию Описание
migrateDeviceData

boolean

True

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

boolean

True

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

SymmetricKeyAttestation

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

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

string

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

string

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

TpmAttestation

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

Имя Тип Описание
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.