Registry class
Класс Registry предоставляет доступ к службе удостоверений устройств Центра Интернета вещей. Пользователи пакета SDK должны создать экземпляр этого класса одним из методов фабрики: fromConnectionString или fromSharedAccessSignature.
Протокол, используемый для операций реестра удостоверений устройств, — HTTPS.
Методы
Сведения о методе
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
Возвращаемое значение
Promise<ResultWithHttpResponse<BulkRegistryOperationResult>>
addDevices(DeviceDescription[], HttpResponseCallback<BulkRegistryOperationResult>)
Добавляет массив устройств.
function addDevices(devices: DeviceDescription[], done?: HttpResponseCallback<BulkRegistryOperationResult>)
Параметры
- devices
Массив объектов, который должен содержать свойство 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
- content
- ConfigurationContent
Возвращаемое значение
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
- forceRemove
-
boolean
Возвращаемое значение
Promise<ResultWithHttpResponse<BulkRegistryOperationResult>>
removeDevices(DeviceDescription[], boolean, HttpResponseCallback<BulkRegistryOperationResult>)
Обновляет массив устройств.
function removeDevices(devices: DeviceDescription[], forceRemove: boolean, done?: HttpResponseCallback<BulkRegistryOperationResult>)
Параметры
- devices
Массив объектов, который должен содержать свойство 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
- 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
Массив объектов, который должен содержать свойство 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 или экземпляром двойника устройства.