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


Registry class

Класс Registry предоставляет доступ к службе удостоверений устройств Центра Интернета вещей. Пользователи пакета SDK должны создать экземпляр этого класса одним из методов фабрики: fromConnectionString или fromSharedAccessSignature.

Протокол, используемый для операций реестра удостоверений устройств, — HTTPS.

Методы

addConfiguration(Configuration)
addConfiguration(Configuration, HttpResponseCallback<any>)

Добавьте конфигурацию в центр Интернета вещей.

addDevices(DeviceDescription[])
addDevices(DeviceDescription[], HttpResponseCallback<BulkRegistryOperationResult>)

Добавляет массив устройств.

addModule(Module)
addModule(Module, HttpResponseCallback<any>)

Добавьте заданный модуль в реестр.

applyConfigurationContentOnDevice(string, ConfigurationContent)
applyConfigurationContentOnDevice(string, ConfigurationContent, HttpResponseCallback<any>)

Применение заданной конфигурации к устройству в Центре Интернета вещей

cancelJob(string)
cancelJob(string, Callback<JobStatus>)

Отмена задания массового импорта и экспорта.

create(DeviceDescription)
create(DeviceDescription, HttpResponseCallback<Device>)

Создает новое удостоверение устройства в Центре Интернета вещей.

createQuery(string, number)

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

delete(string)
delete(string, HttpResponseCallback<any>)

Удаляет существующее удостоверение устройства из Центра Интернета вещей.

exportDevicesToBlob(string, boolean)
exportDevicesToBlob(string, boolean, Callback<JobStatus>)

Экспорт устройств в большой двоичный объект в массовом задании.

exportDevicesToBlobByIdentity(string, boolean)
exportDevicesToBlobByIdentity(string, boolean, Callback<JobStatus>)

Экспорт устройств в большой двоичный объект в массовом задании с помощью настроенного удостоверения.

exportDevicesToBlobByIdentity(string, boolean, string)
exportDevicesToBlobByIdentity(string, boolean, string, Callback<JobStatus>)
fromConnectionString(string)

Создает объект Реестра из заданной строки подключения.

fromSharedAccessSignature(string)

Создает объект Реестра из заданной подписанной url-адреса.

fromTokenCredential(string, TokenCredential)

Создает объект Реестра из заданного токена Azure TokenCredential.

get(string)
get(string, HttpResponseCallback<Device>)

Запрашивает сведения о существующем удостоверении устройства в Центре Интернета вещей.

getConfiguration(string)
getConfiguration(string, HttpResponseCallback<Configuration>)

Получение одной конфигурации из Центра Интернета вещей

getConfigurations()
getConfigurations(HttpResponseCallback<Configuration[]>)

Получение всех конфигураций в Центре Интернета вещей

getJob(string)
getJob(string, Callback<JobStatus>)

Получение состояния задания массового импорта и экспорта.

getModule(string, string)
getModule(string, string, HttpResponseCallback<Module>)

Получение одного модуля с устройства в Центре Интернета вещей

getModulesOnDevice(string)
getModulesOnDevice(string, HttpResponseCallback<Module[]>)

Получение списка всех модулей на устройстве Центра Интернета вещей

getModuleTwin(string, string)
getModuleTwin(string, string, HttpResponseCallback<Twin>)

Возвращает двойник модуля модуля с указанным идентификатором модуля.

getRegistryStatistics()
getRegistryStatistics(HttpResponseCallback<RegistryStatistics>)

Получает статистику о устройствах в реестре удостоверений устройств.

getTwin(string)
getTwin(string, HttpResponseCallback<Twin>)

Возвращает двойник устройства с указанным идентификатором устройства.

importDevicesFromBlob(string, string)
importDevicesFromBlob(string, string, Callback<JobStatus>)

Импортирует устройства из большого двоичного объекта в массовом задании.

importDevicesFromBlobByIdentity(string, string)
importDevicesFromBlobByIdentity(string, string, Callback<JobStatus>)

Импортирует устройства из большого двоичного объекта в массовом задании с помощью настроенного удостоверения.

importDevicesFromBlobByIdentity(string, string, string)
importDevicesFromBlobByIdentity(string, string, string, Callback<JobStatus>)
list()
list(HttpResponseCallback<Device[]>)

Запрашивает сведения о первых 1000 удостоверениях устройств в Центре Интернета вещей.

listJobs()
listJobs(HttpResponseCallback<any>)

Вывод списка последних заданий импорта и экспорта (включая активный, если таковой есть).

removeConfiguration(string)
removeConfiguration(string, HttpResponseCallback<any>)

Удаление конфигурации с заданным идентификатором из Центра Интернета вещей

removeDevices(DeviceDescription[], boolean)
removeDevices(DeviceDescription[], boolean, HttpResponseCallback<BulkRegistryOperationResult>)

Обновляет массив устройств.

removeModule(Module, TripleValueCallback<any, any>)

Удаление заданного модуля из реестра

removeModule(string | Module)
removeModule(string | Module, string)
removeModule(string, string, TripleValueCallback<any, any>)
update(DeviceDescription)
update(DeviceDescription, HttpResponseCallback<Device>)

Обновляет существующее удостоверение устройства в Центре Интернета вещей с заданными сведениями об устройстве. Параметр deviceInfo должен содержать все свойства, обновляемые. Например, при обновлении свойства status от disabled до enabledобъект deviceInfo также должен иметь состояниеReason, проверку подлинности (и его вложенные свойства), возможности и deviceScope, заданные устройствами текущими значениями, или эти свойства будут сброшены. Перед обновлением рекомендуется вызвать API get.

updateConfiguration(Configuration)
updateConfiguration(Configuration, boolean)
updateConfiguration(Configuration, boolean, HttpResponseCallback<any>)
updateConfiguration(Configuration, HttpResponseCallback<any>)

Обновление конфигурации в Центре Интернета вещей

updateDevices(DeviceDescription[], boolean)
updateDevices(DeviceDescription[], boolean, HttpResponseCallback<BulkRegistryOperationResult>)

Обновляет массив устройств. Отдельные элементы параметра devices должны содержать все свойства, обновляемые. Например, при обновлении свойства status от disabled до enabledобъект также должен иметь состояниеReason, проверку подлинности (и его вложенные свойства), возможности и deviceScope, заданные для устройств текущие значения, или эти свойства будут сброшены. Перед обновлением рекомендуется вызвать API get.

updateModule(Module)
updateModule(Module, boolean)
updateModule(Module, boolean, HttpResponseCallback<any>)
updateModule(Module, TripleValueCallback<any, any>)

Обновление заданного объекта модуля в реестре

updateModuleTwin(string, string, any, string)
updateModuleTwin(string, string, any, string, HttpResponseCallback<Twin>)

Обновляет двойник определенного модуля с заданным исправлением.

updateTwin(string, any, string)
updateTwin(string, any, string, HttpResponseCallback<Twin>)

Обновляет двойник устройства определенного устройства с заданным исправлением.

Сведения о методе

addConfiguration(Configuration)

function addConfiguration(configuration: Configuration): Promise<ResultWithHttpResponse<any>>

Параметры

configuration
Configuration

Возвращаемое значение

Promise<ResultWithHttpResponse<any>>

addConfiguration(Configuration, HttpResponseCallback<any>)

Добавьте конфигурацию в центр Интернета вещей.

function addConfiguration(configuration: Configuration, done?: HttpResponseCallback<any>)

Параметры

configuration
Configuration

Объект модуля типа:azure-iothub. Настройка для добавления в концентратор

done

HttpResponseCallback<any>

Необязательная функция для вызова при завершении операции. done будет вызываться с тремя аргументами: объект error (может иметь значение NULL), текст ответа и объект ответа, предназначенный для ведения журнала или отладки.

addDevices(DeviceDescription[])

function addDevices(devices: DeviceDescription[]): Promise<ResultWithHttpResponse<BulkRegistryOperationResult>>

Параметры

devices

DeviceDescription[]

Возвращаемое значение

Promise<ResultWithHttpResponse<BulkRegistryOperationResult>>

addDevices(DeviceDescription[], HttpResponseCallback<BulkRegistryOperationResult>)

Добавляет массив устройств.

function addDevices(devices: DeviceDescription[], done?: HttpResponseCallback<BulkRegistryOperationResult>)

Параметры

devices

DeviceDescription[]

Массив объектов, который должен содержать свойство deviceId, значение которого является допустимым идентификатором устройства.

done

HttpResponseCallback<BulkRegistryOperationResult>

Необязательная функция для вызова при завершении операции. done будет вызываться с тремя аргументами: объект Error (может иметь значение NULL), BulkRegistryOperationResult и объект ответа, зависящий от транспорта, полезный для ведения журнала или отладки.

addModule(Module)

function addModule(module: Module): Promise<ResultWithHttpResponse<any>>

Параметры

module
Module

Возвращаемое значение

Promise<ResultWithHttpResponse<any>>

addModule(Module, HttpResponseCallback<any>)

Добавьте заданный модуль в реестр.

function addModule(module: Module, done?: HttpResponseCallback<any>)

Параметры

module
Module

Объект модуля для добавления в реестр.

done

HttpResponseCallback<any>

Необязательная функция для вызова при завершении операции. done будет вызываться с тремя аргументами: объект error (может иметь значение NULL), текст ответа и объект ответа, предназначенный для ведения журнала или отладки.

applyConfigurationContentOnDevice(string, ConfigurationContent)

function applyConfigurationContentOnDevice(deviceId: string, content: ConfigurationContent): Promise<ResultWithHttpResponse<any>>

Параметры

deviceId

string

Возвращаемое значение

Promise<ResultWithHttpResponse<any>>

applyConfigurationContentOnDevice(string, ConfigurationContent, HttpResponseCallback<any>)

Применение заданной конфигурации к устройству в Центре Интернета вещей

function applyConfigurationContentOnDevice(deviceId: string, content: ConfigurationContent, done?: HttpResponseCallback<any>)

Параметры

deviceId

string

Идентификатор устройства для применения конфигурации к

content
ConfigurationContent

Конфигурация, применяемая

done

HttpResponseCallback<any>

Необязательная функция для вызова при завершении операции. done будет вызываться с тремя аргументами: объект error (может иметь значение NULL), текст ответа и объект ответа, предназначенный для ведения журнала или отладки.

cancelJob(string)

function cancelJob(jobId: string): Promise<JobStatus>

Параметры

jobId

string

Возвращаемое значение

Promise<JobStatus>

cancelJob(string, Callback<JobStatus>)

Отмена задания массового импорта и экспорта.

function cancelJob(jobId: string, done?: Callback<JobStatus>)

Параметры

jobId

string

Идентификатор задания, для которого пользователь хочет получить сведения о состоянии.

done

Callback<JobStatus>

Необязательная функция для вызова с двумя аргументами: объект ошибки, если произошла ошибка, (null в противном случае) и состояние (отменено) задания, идентификатор которого был передан в качестве аргумента.

create(DeviceDescription)

function create(deviceInfo: DeviceDescription): Promise<ResultWithHttpResponse<Device>>

Параметры

deviceInfo
DeviceDescription

Возвращаемое значение

Promise<ResultWithHttpResponse<Device>>

create(DeviceDescription, HttpResponseCallback<Device>)

Создает новое удостоверение устройства в Центре Интернета вещей.

function create(deviceInfo: DeviceDescription, done?: HttpResponseCallback<Device>)

Параметры

deviceInfo
DeviceDescription

Объект должен содержать свойство deviceId с допустимым идентификатором устройства.

done

HttpResponseCallback<Device>

Необязательная функция для вызова при завершении операции. done будет вызываться с тремя аргументами: объект error (может быть null), объект device, представляющий созданное удостоверение устройства, а также объект ответа для конкретного транспорта, полезный для ведения журнала или отладки.

createQuery(string, number)

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

function createQuery(sqlQuery: string, pageSize?: number): Query

Параметры

sqlQuery

string

Запрос, написанный как строка SQL.

pageSize

number

Требуемое количество результатов на страницу (необязательно. значение по умолчанию: 1000, макс. 10000).

Возвращаемое значение

Query

delete(string)

function delete(deviceId: string): Promise<ResultWithHttpResponse<any>>

Параметры

deviceId

string

Возвращаемое значение

Promise<ResultWithHttpResponse<any>>

delete(string, HttpResponseCallback<any>)

Удаляет существующее удостоверение устройства из Центра Интернета вещей.

function delete(deviceId: string, done?: HttpResponseCallback<any>)

Параметры

deviceId

string

Идентификатор существующего удостоверения устройства.

done

HttpResponseCallback<any>

Необязательная функция для вызова при завершении операции. done будет вызываться с тремя аргументами: объект Error (может быть null), аргумент always-NULL (для согласованности с другими методами) и объект ответа, зависящий от транспорта, полезный для ведения журнала или отладки.

exportDevicesToBlob(string, boolean)

function exportDevicesToBlob(outputBlobContainerUri: string, excludeKeys: boolean): Promise<JobStatus>

Параметры

outputBlobContainerUri

string

excludeKeys

boolean

Возвращаемое значение

Promise<JobStatus>

exportDevicesToBlob(string, boolean, Callback<JobStatus>)

Экспорт устройств в большой двоичный объект в массовом задании.

function exportDevicesToBlob(outputBlobContainerUri: string, excludeKeys: boolean, done?: Callback<JobStatus>)

Параметры

outputBlobContainerUri

string

Универсальный код ресурса (URI) для контейнера, в котором будет создан большой двоичный объект с именем "devices.txt", содержащий список устройств.

excludeKeys

boolean

Логическое значение, указывающее, следует ли исключать ключи безопасности из экспортированных данных.

done

Callback<JobStatus>

Необязательная функция для вызова при создании задания с двумя аргументами: объект ошибки, если произошла ошибка, (null в противном случае) и состояние задания, которое можно использовать для отслеживания хода выполнения экспорта устройств.

exportDevicesToBlobByIdentity(string, boolean)

function exportDevicesToBlobByIdentity(outputBlobContainerUri: string, excludeKeys: boolean): Promise<JobStatus>

Параметры

outputBlobContainerUri

string

excludeKeys

boolean

Возвращаемое значение

Promise<JobStatus>

exportDevicesToBlobByIdentity(string, boolean, Callback<JobStatus>)

Экспорт устройств в большой двоичный объект в массовом задании с помощью настроенного удостоверения.

function exportDevicesToBlobByIdentity(outputBlobContainerUri: string, excludeKeys: boolean, done?: Callback<JobStatus>)

Параметры

outputBlobContainerUri

string

Универсальный код ресурса (URI) для контейнера, в котором будет создан большой двоичный объект с именем "devices.txt", содержащий список устройств.

excludeKeys

boolean

Логическое значение, указывающее, следует ли исключать ключи безопасности из экспортированных данных.

done

Callback<JobStatus>

Необязательная функция для вызова при создании задания с двумя аргументами: объект ошибки, если произошла ошибка, (null в противном случае) и состояние задания, которое можно использовать для отслеживания хода выполнения экспорта устройств.

exportDevicesToBlobByIdentity(string, boolean, string)

function exportDevicesToBlobByIdentity(outputBlobContainerUri: string, excludeKeys: boolean, userAssignedIdentity: string): Promise<JobStatus>

Параметры

outputBlobContainerUri

string

excludeKeys

boolean

userAssignedIdentity

string

Возвращаемое значение

Promise<JobStatus>

exportDevicesToBlobByIdentity(string, boolean, string, Callback<JobStatus>)

function exportDevicesToBlobByIdentity(outputBlobContainerUri: string, excludeKeys: boolean, userAssignedIdentity: string, done: Callback<JobStatus>)

Параметры

outputBlobContainerUri

string

excludeKeys

boolean

userAssignedIdentity

string

done

Callback<JobStatus>

fromConnectionString(string)

Создает объект Реестра из заданной строки подключения.

static function fromConnectionString(value: string): Registry

Параметры

value

string

Строка подключения, инкапсулирующая соответствующие разрешения реестра (чтение и запись).

Возвращаемое значение

fromSharedAccessSignature(string)

Создает объект Реестра из заданной подписанной url-адреса.

static function fromSharedAccessSignature(value: string): Registry

Параметры

value

string

Подписанный URL-адрес, инкапсулирующий соответствующие разрешения реестра (чтение и запись).

Возвращаемое значение

fromTokenCredential(string, TokenCredential)

Создает объект Реестра из заданного токена Azure TokenCredential.

static function fromTokenCredential(hostName: string, tokenCredential: TokenCredential): Registry

Параметры

hostName

string

Имя узла службы Azure.

tokenCredential
TokenCredential

Токен AzureCredential, используемый для проверки подлинности в службе Azure

Возвращаемое значение

get(string)

function get(deviceId: string): Promise<ResultWithHttpResponse<Device>>

Параметры

deviceId

string

Возвращаемое значение

Promise<ResultWithHttpResponse<Device>>

get(string, HttpResponseCallback<Device>)

Запрашивает сведения о существующем удостоверении устройства в Центре Интернета вещей.

function get(deviceId: string, done?: HttpResponseCallback<Device>)

Параметры

deviceId

string

Идентификатор существующего удостоверения устройства.

done

HttpResponseCallback<Device>

Необязательная функция для вызова при завершении операции. done будет вызываться с тремя аргументами: объект error (может быть null), объект device, представляющий созданное удостоверение устройства, а также объект ответа для конкретного транспорта, полезный для ведения журнала или отладки.

getConfiguration(string)

function getConfiguration(configurationId: string): Promise<ResultWithHttpResponse<Configuration>>

Параметры

configurationId

string

Возвращаемое значение

Promise<ResultWithHttpResponse<Configuration>>

getConfiguration(string, HttpResponseCallback<Configuration>)

Получение одной конфигурации из Центра Интернета вещей

function getConfiguration(configurationId: string, done?: HttpResponseCallback<Configuration>)

Параметры

configurationId

string

Идентификатор конфигурации, с помощью которого требуется получить

done

HttpResponseCallback<Configuration>

Необязательный обратный вызов, который будет вызываться с объектом Error или модулем:azure-iothub. Объект конфигурации с подробными сведениями о конфигурации.

getConfigurations()

function getConfigurations(): Promise<ResultWithHttpResponse<Configuration[]>>

Возвращаемое значение

Promise<ResultWithHttpResponse<Configuration[]>>

getConfigurations(HttpResponseCallback<Configuration[]>)

Получение всех конфигураций в Центре Интернета вещей

function getConfigurations(done?: HttpResponseCallback<Configuration[]>)

Параметры

done

HttpResponseCallback<Configuration[]>

Необязательный обратный вызов, который будет вызываться с объектом Error или массивом модуля:azure-iothub. Объекты конфигурации для всех конфигураций.

getJob(string)

function getJob(jobId: string): Promise<JobStatus>

Параметры

jobId

string

Возвращаемое значение

Promise<JobStatus>

getJob(string, Callback<JobStatus>)

Получение состояния задания массового импорта и экспорта.

function getJob(jobId: string, done?: Callback<JobStatus>)

Параметры

jobId

string

Идентификатор задания, для которого пользователь хочет получить сведения о состоянии.

done

Callback<JobStatus>

Необязательная функция для вызова с двумя аргументами: объект ошибки, если произошла ошибка, (null в противном случае) и состояние задания, идентификатор которого был передан в качестве аргумента.

getModule(string, string)

function getModule(deviceId: string, moduleId: string): Promise<ResultWithHttpResponse<Module>>

Параметры

deviceId

string

moduleId

string

Возвращаемое значение

Promise<ResultWithHttpResponse<Module>>

getModule(string, string, HttpResponseCallback<Module>)

Получение одного модуля с устройства в Центре Интернета вещей

function getModule(deviceId: string, moduleId: string, done?: HttpResponseCallback<Module>)

Параметры

deviceId

string

Идентификатор устройства, принадлежащий модулю.

moduleId

string

Идентификатор модуля для получения

done

HttpResponseCallback<Module>

Необязательный обратный вызов, который будет вызываться с объектом Error или модулем:azure-iothub. Объект модуля для запрошенного модуля

getModulesOnDevice(string)

function getModulesOnDevice(deviceId: string): Promise<ResultWithHttpResponse<Module[]>>

Параметры

deviceId

string

Возвращаемое значение

Promise<ResultWithHttpResponse<Module[]>>

getModulesOnDevice(string, HttpResponseCallback<Module[]>)

Получение списка всех модулей на устройстве Центра Интернета вещей

function getModulesOnDevice(deviceId: string, done?: HttpResponseCallback<Module[]>)

Параметры

deviceId

string

Идентификатор устройства, для который мы получаем модули

done

HttpResponseCallback<Module[]>

Необязательный обратный вызов, который будет вызываться с объектом Error или массивом модуля:azure-iothub. Объекты модуля для всех модулей.

getModuleTwin(string, string)

function getModuleTwin(deviceId: string, moduleId: string): Promise<ResultWithHttpResponse<Twin>>

Параметры

deviceId

string

moduleId

string

Возвращаемое значение

Promise<ResultWithHttpResponse<Twin>>

getModuleTwin(string, string, HttpResponseCallback<Twin>)

Возвращает двойник модуля модуля с указанным идентификатором модуля.

function getModuleTwin(deviceId: string, moduleId: string, done?: HttpResponseCallback<Twin>)

Параметры

deviceId

string

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

moduleId

string

Идентификатор модуля.

done

HttpResponseCallback<Twin>

Необязательный обратный вызов, который будет вызываться с объектом Error или экземпляром двойника модуля.

getRegistryStatistics()

function getRegistryStatistics(): Promise<ResultWithHttpResponse<RegistryStatistics>>

Возвращаемое значение

Promise<ResultWithHttpResponse<RegistryStatistics>>

getRegistryStatistics(HttpResponseCallback<RegistryStatistics>)

Получает статистику о устройствах в реестре удостоверений устройств.

function getRegistryStatistics(done?: HttpResponseCallback<RegistryStatistics>)

Параметры

done

HttpResponseCallback<RegistryStatistics>

Необязательный обратный вызов, который будет вызываться с объектом error или статистикой реестра устройств.

getTwin(string)

function getTwin(deviceId: string): Promise<ResultWithHttpResponse<Twin>>

Параметры

deviceId

string

Возвращаемое значение

Promise<ResultWithHttpResponse<Twin>>

getTwin(string, HttpResponseCallback<Twin>)

Возвращает двойник устройства с указанным идентификатором устройства.

function getTwin(deviceId: string, done?: HttpResponseCallback<Twin>)

Параметры

deviceId

string

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

done

HttpResponseCallback<Twin>

Необязательный обратный вызов, который будет вызываться с объектом Error или экземпляром двойника устройства.

importDevicesFromBlob(string, string)

function importDevicesFromBlob(inputBlobContainerUri: string, outputBlobContainerUri: string): Promise<JobStatus>

Параметры

inputBlobContainerUri

string

outputBlobContainerUri

string

Возвращаемое значение

Promise<JobStatus>

importDevicesFromBlob(string, string, Callback<JobStatus>)

Импортирует устройства из большого двоичного объекта в массовом задании.

function importDevicesFromBlob(inputBlobContainerUri: string, outputBlobContainerUri: string, done?: Callback<JobStatus>)

Параметры

inputBlobContainerUri

string

Универсальный код ресурса (URI) для контейнера с большим двоичным объектом с именем "devices.txt", содержащий список устройств для импорта.

outputBlobContainerUri

string

Универсальный код ресурса (URI) для контейнера, в котором большой двоичный объект будет создан с журналами процесса импорта.

done

Callback<JobStatus>

Необязательная функция для вызова при создании задания с двумя аргументами: объект ошибки, если произошла ошибка, (null в противном случае) и состояние задания, которое можно использовать для отслеживания хода импорта устройств.

importDevicesFromBlobByIdentity(string, string)

function importDevicesFromBlobByIdentity(inputBlobContainerUri: string, outputBlobContainerUri: string): Promise<JobStatus>

Параметры

inputBlobContainerUri

string

outputBlobContainerUri

string

Возвращаемое значение

Promise<JobStatus>

importDevicesFromBlobByIdentity(string, string, Callback<JobStatus>)

Импортирует устройства из большого двоичного объекта в массовом задании с помощью настроенного удостоверения.

function importDevicesFromBlobByIdentity(inputBlobContainerUri: string, outputBlobContainerUri: string, done?: Callback<JobStatus>)

Параметры

inputBlobContainerUri

string

Универсальный код ресурса (URI) для контейнера с большим двоичным объектом с именем "devices.txt", содержащий список устройств для импорта.

outputBlobContainerUri

string

Универсальный код ресурса (URI) для контейнера, в котором большой двоичный объект будет создан с журналами процесса импорта.

done

Callback<JobStatus>

Необязательная функция для вызова при создании задания с двумя аргументами: объект ошибки, если произошла ошибка, (null в противном случае) и состояние задания, которое можно использовать для отслеживания хода импорта устройств.

importDevicesFromBlobByIdentity(string, string, string)

function importDevicesFromBlobByIdentity(inputBlobContainerUri: string, outputBlobContainerUri: string, userAssignedIdentity: string): Promise<JobStatus>

Параметры

inputBlobContainerUri

string

outputBlobContainerUri

string

userAssignedIdentity

string

Возвращаемое значение

Promise<JobStatus>

importDevicesFromBlobByIdentity(string, string, string, Callback<JobStatus>)

function importDevicesFromBlobByIdentity(inputBlobContainerUri: string, outputBlobContainerUri: string, userAssignedIdentity: string, done: Callback<JobStatus>)

Параметры

inputBlobContainerUri

string

outputBlobContainerUri

string

userAssignedIdentity

string

done

Callback<JobStatus>

list()

function list(): Promise<ResultWithHttpResponse<Device[]>>

Возвращаемое значение

Promise<ResultWithHttpResponse<Device[]>>

list(HttpResponseCallback<Device[]>)

Запрашивает сведения о первых 1000 удостоверениях устройств в Центре Интернета вещей.

function list(done?: HttpResponseCallback<Device[]>)

Параметры

done

HttpResponseCallback<Device[]>

Необязательная функция для вызова при завершении операции. done будет вызываться с тремя аргументами: объект error (может быть null), массив объектов Device, представляющих перечисленные удостоверения устройства, а также объект ответа для конкретного транспорта, полезный для ведения журнала или отладки.

listJobs()

function listJobs(): Promise<ResultWithHttpResponse<any>>

Возвращаемое значение

Promise<ResultWithHttpResponse<any>>

listJobs(HttpResponseCallback<any>)

Вывод списка последних заданий импорта и экспорта (включая активный, если таковой есть).

function listJobs(done?: HttpResponseCallback<any>)

Параметры

done

HttpResponseCallback<any>

Необязательная функция для вызова с двумя аргументами: объект ошибки, если произошла ошибка, (null в противном случае) и список прошлых заданий в качестве аргумента.

removeConfiguration(string)

function removeConfiguration(configurationId: string): Promise<ResultWithHttpResponse<any>>

Параметры

configurationId

string

Возвращаемое значение

Promise<ResultWithHttpResponse<any>>

removeConfiguration(string, HttpResponseCallback<any>)

Удаление конфигурации с заданным идентификатором из Центра Интернета вещей

function removeConfiguration(configurationId: string, done?: HttpResponseCallback<any>)

Параметры

configurationId

string

Идентификатор конфигурации для удаления

done

HttpResponseCallback<any>

Необязательная функция для вызова при завершении операции. done будет вызываться с тремя аргументами: объект error (может иметь значение NULL), текст ответа и объект ответа, предназначенный для ведения журнала или отладки.

removeDevices(DeviceDescription[], boolean)

function removeDevices(devices: DeviceDescription[], forceRemove: boolean): Promise<ResultWithHttpResponse<BulkRegistryOperationResult>>

Параметры

devices

DeviceDescription[]

forceRemove

boolean

Возвращаемое значение

Promise<ResultWithHttpResponse<BulkRegistryOperationResult>>

removeDevices(DeviceDescription[], boolean, HttpResponseCallback<BulkRegistryOperationResult>)

Обновляет массив устройств.

function removeDevices(devices: DeviceDescription[], forceRemove: boolean, done?: HttpResponseCallback<BulkRegistryOperationResult>)

Параметры

devices

DeviceDescription[]

Массив объектов, который должен содержать свойство deviceId, значение которого является допустимым идентификатором устройства.

forceRemove

boolean

Если forceRemove имеет значение true, устройство будет удалено независимо от etag. В противном случае должны совпадать etags.

done

HttpResponseCallback<BulkRegistryOperationResult>

Необязательная функция для вызова при завершении операции. done будет вызываться с тремя аргументами: объект Error (может иметь значение NULL), BulkRegistryOperationResult и объект ответа, зависящий от транспорта, полезный для ведения журнала или отладки.

removeModule(Module, TripleValueCallback<any, any>)

Удаление заданного модуля из реестра

function removeModule(module: Module, done?: TripleValueCallback<any, any>)

Параметры

module
Module
done

TripleValueCallback<any, any>

Необязательная функция для вызова при завершении операции. done будет вызываться с тремя аргументами: объект error (может иметь значение NULL), текст ответа и объект ответа, предназначенный для ведения журнала или отладки.

removeModule(string | Module)

function removeModule(moduleOrDeviceId: string | Module): Promise<ResultWithHttpResponse<any>>

Параметры

moduleOrDeviceId

string | Module

Возвращаемое значение

Promise<ResultWithHttpResponse<any>>

removeModule(string | Module, string)

function removeModule(moduleOrDeviceId: string | Module, moduleId: string): Promise<ResultWithHttpResponse<any>>

Параметры

moduleOrDeviceId

string | Module

moduleId

string

Возвращаемое значение

Promise<ResultWithHttpResponse<any>>

removeModule(string, string, TripleValueCallback<any, any>)

function removeModule(deviceId: string, moduleId: string, done: TripleValueCallback<any, any>)

Параметры

deviceId

string

moduleId

string

done

TripleValueCallback<any, any>

update(DeviceDescription)

function update(deviceInfo: DeviceDescription): Promise<ResultWithHttpResponse<Device>>

Параметры

deviceInfo
DeviceDescription

Возвращаемое значение

Promise<ResultWithHttpResponse<Device>>

update(DeviceDescription, HttpResponseCallback<Device>)

Обновляет существующее удостоверение устройства в Центре Интернета вещей с заданными сведениями об устройстве. Параметр deviceInfo должен содержать все свойства, обновляемые. Например, при обновлении свойства status от disabled до enabledобъект deviceInfo также должен иметь состояниеReason, проверку подлинности (и его вложенные свойства), возможности и deviceScope, заданные устройствами текущими значениями, или эти свойства будут сброшены. Перед обновлением рекомендуется вызвать API get.

function update(deviceInfo: DeviceDescription, done?: HttpResponseCallback<Device>)

Параметры

deviceInfo
DeviceDescription

Объект, который должен содержать свойство deviceId, значение которого является допустимым идентификатором устройства.

done

HttpResponseCallback<Device>

Необязательная функция для вызова при завершении операции. done будет вызываться с тремя аргументами: объект Error (может иметь значение NULL), объект Device, представляющий обновленное удостоверение устройства, и объект ответа, зависящий от транспорта, полезный для ведения журнала или отладки.

updateConfiguration(Configuration)

function updateConfiguration(configuration: Configuration): Promise<ResultWithHttpResponse<any>>

Параметры

configuration
Configuration

Возвращаемое значение

Promise<ResultWithHttpResponse<any>>

updateConfiguration(Configuration, boolean)

function updateConfiguration(configuration: Configuration, forceUpdate: boolean): Promise<ResultWithHttpResponse<any>>

Параметры

configuration
Configuration
forceUpdate

boolean

Возвращаемое значение

Promise<ResultWithHttpResponse<any>>

updateConfiguration(Configuration, boolean, HttpResponseCallback<any>)

function updateConfiguration(configuration: Configuration, forceUpdate: boolean, done: HttpResponseCallback<any>)

Параметры

configuration
Configuration
forceUpdate

boolean

done

HttpResponseCallback<any>

updateConfiguration(Configuration, HttpResponseCallback<any>)

Обновление конфигурации в Центре Интернета вещей

function updateConfiguration(configuration: Configuration, done?: HttpResponseCallback<any>)

Параметры

configuration
Configuration

Объект модуля типа:azure-iothub. Настройка для добавления в концентратор

done

HttpResponseCallback<any>

Необязательная функция для вызова при завершении операции. done будет вызываться с тремя аргументами: объект error (может иметь значение NULL), текст ответа и объект ответа, предназначенный для ведения журнала или отладки.

updateDevices(DeviceDescription[], boolean)

function updateDevices(devices: DeviceDescription[], forceUpdate: boolean): Promise<ResultWithHttpResponse<BulkRegistryOperationResult>>

Параметры

devices

DeviceDescription[]

forceUpdate

boolean

Возвращаемое значение

Promise<ResultWithHttpResponse<BulkRegistryOperationResult>>

updateDevices(DeviceDescription[], boolean, HttpResponseCallback<BulkRegistryOperationResult>)

Обновляет массив устройств. Отдельные элементы параметра devices должны содержать все свойства, обновляемые. Например, при обновлении свойства status от disabled до enabledобъект также должен иметь состояниеReason, проверку подлинности (и его вложенные свойства), возможности и deviceScope, заданные для устройств текущие значения, или эти свойства будут сброшены. Перед обновлением рекомендуется вызвать API get.

function updateDevices(devices: DeviceDescription[], forceUpdate: boolean, done?: HttpResponseCallback<BulkRegistryOperationResult>)

Параметры

devices

DeviceDescription[]

Массив объектов, который должен содержать свойство deviceId, значение которого является допустимым идентификатором устройства.

forceUpdate

boolean

Значение , если forceUpdate имеет значение true, устройство будет обновлено независимо от etag. В противном случае должны совпадать etags.

done

HttpResponseCallback<BulkRegistryOperationResult>

Необязательная функция для вызова при завершении операции. done будет вызываться с тремя аргументами: объект Error (может иметь значение NULL), BulkRegistryOperationResult и объект ответа, зависящий от транспорта, полезный для ведения журнала или отладки.

updateModule(Module)

function updateModule(module: Module): Promise<ResultWithHttpResponse<any>>

Параметры

module
Module

Возвращаемое значение

Promise<ResultWithHttpResponse<any>>

updateModule(Module, boolean)

function updateModule(module: Module, forceUpdate: boolean): Promise<ResultWithHttpResponse<any>>

Параметры

module
Module
forceUpdate

boolean

Возвращаемое значение

Promise<ResultWithHttpResponse<any>>

updateModule(Module, boolean, HttpResponseCallback<any>)

function updateModule(module: Module, forceUpdate: boolean, done: HttpResponseCallback<any>)

Параметры

module
Module
forceUpdate

boolean

done

HttpResponseCallback<any>

updateModule(Module, TripleValueCallback<any, any>)

Обновление заданного объекта модуля в реестре

function updateModule(module: Module, done?: TripleValueCallback<any, any>)

Параметры

module
Module

Объект модуля для обновления.

done

TripleValueCallback<any, any>

Необязательная функция для вызова при завершении операции. done будет вызываться с тремя аргументами: объект error (может иметь значение NULL), текст ответа и объект ответа, предназначенный для ведения журнала или отладки.

updateModuleTwin(string, string, any, string)

function updateModuleTwin(deviceId: string, moduleId: string, patch: any, etag: string): Promise<ResultWithHttpResponse<Twin>>

Параметры

deviceId

string

moduleId

string

patch

any

etag

string

Возвращаемое значение

Promise<ResultWithHttpResponse<Twin>>

updateModuleTwin(string, string, any, string, HttpResponseCallback<Twin>)

Обновляет двойник определенного модуля с заданным исправлением.

function updateModuleTwin(deviceId: string, moduleId: string, patch: any, etag: string, done?: HttpResponseCallback<Twin>)

Параметры

deviceId

string

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

moduleId

string

Идентификатор модуля

patch

any

Требуемые свойства и теги для исправления двойника модуля.

etag

string

Последний тег etag для этого двойника модуля или "*", чтобы принудительно выполнить обновление, даже если двойник модуля был обновлен с момента получения etag.

done

HttpResponseCallback<Twin>

Необязательный обратный вызов, который будет вызываться с объектом Error или экземпляром двойника модуля.

updateTwin(string, any, string)

function updateTwin(deviceId: string, patch: any, etag: string): Promise<ResultWithHttpResponse<Twin>>

Параметры

deviceId

string

patch

any

etag

string

Возвращаемое значение

Promise<ResultWithHttpResponse<Twin>>

updateTwin(string, any, string, HttpResponseCallback<Twin>)

Обновляет двойник устройства определенного устройства с заданным исправлением.

function updateTwin(deviceId: string, patch: any, etag: string, done?: HttpResponseCallback<Twin>)

Параметры

deviceId

string

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

patch

any

Требуемые свойства и теги для исправления двойника устройства.

etag

string

Последний etag для этого двойника устройства или "*", чтобы принудительно обновить, даже если двойник устройства был обновлен с момента получения etag.

done

HttpResponseCallback<Twin>

Необязательный обратный вызов, который будет вызываться с объектом Error или экземпляром двойника устройства.