Registry class

套件:

azure-iothub

登錄類別可讓您存取IoT 中樞裝置身分識別服務。 SDK 的使用者應該使用其中一個 Factory 方法具現化此類別： fromConnectionString 或 fromSharedAccessSignature。

用於裝置身分識別登錄作業的通訊協定是 HTTPS。

方法

addConfiguration(Configuration)
addConfiguration(Configuration, HttpResponseCallback<any>)	將設定新增至 IoT 中樞。
addDevices(DeviceDescription[])
addDevices(DeviceDescription[], HttpResponseCallback<BulkRegistryOperationResult>)	新增裝置陣列。
addModule(Module)
addModule(Module, HttpResponseCallback<any>)	將指定的模組新增至登錄。
applyConfigurationContentOnDevice(string, ConfigurationContent)
applyConfigurationContentOnDevice(string, ConfigurationContent, HttpResponseCallback<any>)	將指定的設定套用至IoT 中樞上的裝置
cancelJob(string)
cancelJob(string, Callback<JobStatus>)	取消大量匯入/匯出作業。
create(DeviceDescription)
create(DeviceDescription, HttpResponseCallback<Device>)	在 IoT 中樞上建立新的裝置身分識別。
createQuery(string, number)	建立可在 IoT 中樞 實例上執行的查詢，以尋找裝置或作業的相關資訊。
delete(string)
delete(string, HttpResponseCallback<any>)	從 IoT 中樞移除現有的裝置身分識別。
exportDevicesToBlob(string, boolean)
exportDevicesToBlob(string, boolean, Callback<JobStatus>)	將裝置匯出至大量作業中的 Blob。
exportDevicesToBlobByIdentity(string, boolean)
exportDevicesToBlobByIdentity(string, boolean, Callback<JobStatus>)	使用已設定的身分識別，將裝置匯出至大量作業中的 Blob。
exportDevicesToBlobByIdentity(string, boolean, string)
exportDevicesToBlobByIdentity(string, boolean, string, Callback<JobStatus>)
fromConnectionString(string)	從指定的連接字串建構 Registry 物件。
fromSharedAccessSignature(string)	從指定的共用存取簽章建構 Registry 物件。
fromTokenCredential(string, TokenCredential)	從指定的 Azure TokenCredential 建構 Registry 物件。
get(string)
get(string, HttpResponseCallback<Device>)	要求 IoT 中樞上現有裝置身分識別的相關資訊。
getConfiguration(string)
getConfiguration(string, HttpResponseCallback<Configuration>)	從IoT 中樞取得單一組態
getConfigurations()
getConfigurations(HttpResponseCallback<Configuration[]>)	取得IoT 中樞上的所有組態
getJob(string)
getJob(string, Callback<JobStatus>)	取得大量匯入/匯出作業的狀態。
getModule(string, string)
getModule(string, string, HttpResponseCallback<Module>)	從IoT 中樞上的裝置取得單一模組
getModulesOnDevice(string)
getModulesOnDevice(string, HttpResponseCallback<Module[]>)	取得IoT 中樞裝置上所有模組的清單
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>)	從大量作業中的 Blob 匯入裝置。
importDevicesFromBlobByIdentity(string, string)
importDevicesFromBlobByIdentity(string, string, Callback<JobStatus>)	使用已設定的身分識別，從 Blob 大容量作業匯入裝置。
importDevicesFromBlobByIdentity(string, string, string)
importDevicesFromBlobByIdentity(string, string, string, Callback<JobStatus>)
list()
list(HttpResponseCallback<Device[]>)	要求 IoT 中樞上前 1000 個裝置身分識別的相關資訊。
listJobs()
listJobs(HttpResponseCallback<any>)	列出最後一個匯入/匯出作業， (包含作用中的作業，如果有的話) 。
removeConfiguration(string)
removeConfiguration(string, HttpResponseCallback<any>)	從IoT 中樞移除具有指定識別碼的組態
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>)	更新具有指定裝置資訊的 IoT 中樞上現有的裝置身分識別。 參數 deviceInfo 必須包含所有可更新的屬性。 例如，如果將 屬性從 disabled 更新 status 為 enabled ，物件 deviceInfo 也應該具有 statusReason、驗證 (及其子屬性) 、功能和 deviceScope 設定為裝置目前的值，否則將會重設這些屬性。 建議您先呼叫 get api，再執行更新。
updateConfiguration(Configuration)
updateConfiguration(Configuration, boolean)
updateConfiguration(Configuration, boolean, HttpResponseCallback<any>)
updateConfiguration(Configuration, HttpResponseCallback<any>)	更新 IoT 中樞中的組態
updateDevices(DeviceDescription[], boolean)
updateDevices(DeviceDescription[], boolean, HttpResponseCallback<BulkRegistryOperationResult>)	更新裝置陣列。 參數的 devices 個別元素必須包含所有可更新的屬性。 例如，如果將 屬性從 disabled 更新 status 為 enabled ，則 物件也應該具有 statusReason、驗證 (及其子屬性) 、功能和 deviceScope 設定為裝置目前的值，否則將會重設這些屬性。 建議您先呼叫 get api，再執行更新。
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>)

將設定新增至 IoT 中樞。

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

參數

configuration

Configuration

module：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

要新增至登錄的 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>)

將指定的設定套用至IoT 中樞上的裝置

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>)

在 IoT 中樞上建立新的裝置身分識別。

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

參數

deviceInfo

DeviceDescription

物件必須包含 deviceId 具有有效裝置識別碼的屬性。

done

HttpResponseCallback<Device>

作業完成時要呼叫的選擇性函式。 done 會使用三個引數呼叫：Error 物件 (可以是 null) 、代表已建立裝置身分識別的 Device 物件，以及用於記錄或偵錯的傳輸特定回應物件。

createQuery(string, number)

建立可在 IoT 中樞 實例上執行的查詢，以尋找裝置或作業的相關資訊。

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>)

從 IoT 中樞移除現有的裝置身分識別。

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

參數

deviceId

string

現有裝置身分識別的識別碼。

done

HttpResponseCallback<any>

作業完成時要呼叫的選擇性函式。 done 會使用三個引數呼叫：Error 物件 (可以是 null) 、一律為 null 引數 (，以便與其他方法) 一致性，以及用於記錄或偵錯的傳輸特定回應物件。

exportDevicesToBlob(string, boolean)

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

參數

outputBlobContainerUri

string

excludeKeys

boolean

傳回

Promise<JobStatus>

exportDevicesToBlob(string, boolean, Callback<JobStatus>)

將裝置匯出至大量作業中的 Blob。

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

參數

outputBlobContainerUri

string

容器的 URI，其中將建立名為 'devices.txt' 的 Blob，其中包含裝置清單。

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>)

使用已設定的身分識別，將裝置匯出至大量作業中的 Blob。

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

參數

outputBlobContainerUri

string

容器的 URI，其中將建立名為 'devices.txt' 的 Blob，其中包含裝置清單。

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)

從指定的連接字串建構 Registry 物件。

static function fromConnectionString(value: string): Registry

參數

value

string

連接字串，封裝適當的 (讀取和/或寫入) 登入權利。

傳回

Registry

fromSharedAccessSignature(string)

從指定的共用存取簽章建構 Registry 物件。

static function fromSharedAccessSignature(value: string): Registry

參數

value

string

共用存取簽章，封裝適當的 (讀取和/或寫入) 登入權利。

傳回

Registry

fromTokenCredential(string, TokenCredential)

從指定的 Azure TokenCredential 建構 Registry 物件。

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

參數

hostName

string

Azure 服務的主機名稱。

tokenCredential

TokenCredential

用來向 Azure 服務進行驗證的 Azure TokenCredential

傳回

Registry

get(string)

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

參數

deviceId

string

傳回

Promise<ResultWithHttpResponse<Device>>

get(string, HttpResponseCallback<Device>)

要求 IoT 中樞上現有裝置身分識別的相關資訊。

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>)

從IoT 中樞取得單一組態

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

參數

configurationId

string

您用來擷取之組態的識別碼

done

HttpResponseCallback<Configuration>

會使用 Error 物件或 module：azure-iothub 呼叫的選擇性回呼。具有組態詳細資料的組態物件。

getConfigurations()

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

傳回

Promise<ResultWithHttpResponse<Configuration[]>>

getConfigurations(HttpResponseCallback<Configuration[]>)

取得IoT 中樞上的所有組態

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

參數

done

HttpResponseCallback<Configuration[]>

會使用 Error 物件或 module：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>)

從IoT 中樞上的裝置取得單一模組

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

參數

deviceId

string

擁有模組的裝置識別碼。

moduleId

string

要擷取的模組識別碼

done

HttpResponseCallback<Module>

會使用 Error 物件或 module：azure-iothub 呼叫的選擇性回呼。所要求模組的 Module 物件

getModulesOnDevice(string)

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

參數

deviceId

string

傳回

Promise<ResultWithHttpResponse<Module[]>>

getModulesOnDevice(string, HttpResponseCallback<Module[]>)

取得IoT 中樞裝置上所有模組的清單

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

參數

deviceId

string

我們取得模組的裝置識別碼

done

HttpResponseCallback<Module[]>

會使用 Error 物件或 module：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>)

從大量作業中的 Blob 匯入裝置。

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

參數

inputBlobContainerUri

string

容器的 URI，其 Blob 名為 'devices.txt'，其中包含要匯入的裝置清單。

outputBlobContainerUri

string

容器的 URI，其中 Blob 將會使用匯入程式的記錄來建立。

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>)

使用已設定的身分識別，從 Blob 大容量作業匯入裝置。

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

參數

inputBlobContainerUri

string

容器的 URI，其 Blob 名為 'devices.txt'，其中包含要匯入的裝置清單。

outputBlobContainerUri

string

容器的 URI，其中 Blob 將會使用匯入程式的記錄來建立。

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[]>)

要求 IoT 中樞上前 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>)

從IoT 中樞移除具有指定識別碼的組態

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 為何，都會移除裝置。 否則，etag 必須相符。

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>)

更新具有指定裝置資訊的 IoT 中樞上現有的裝置身分識別。 參數 deviceInfo 必須包含所有可更新的屬性。 例如，如果將 屬性從 disabled 更新 status 為 enabled ，物件 deviceInfo 也應該具有 statusReason、驗證 (及其子屬性) 、功能和 deviceScope 設定為裝置目前的值，否則將會重設這些屬性。 建議您先呼叫 get api，再執行更新。

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>)

更新 IoT 中樞中的組態

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

參數

configuration

Configuration

module：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 個別元素必須包含所有可更新的屬性。 例如，如果將 屬性從 disabled 更新 status 為 enabled ，則 物件也應該具有 statusReason、驗證 (及其子屬性) 、功能和 deviceScope 設定為裝置目前的值，否則將會重設這些屬性。 建議您先呼叫 get api，再執行更新。

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

參數

devices

DeviceDescription[]

物件的陣列，這個陣列必須包含 deviceId 其值為有效裝置識別碼的屬性。

forceUpdate

boolean

如果 forceUpdate 為 true，則無論 etag 為何，都會更新裝置。 否則，etag 必須相符。

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

要更新的 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 物件或裝置對應項實例呼叫的選擇性回呼。