Iot Hub Resource - Import Devices
IoT hub kimlik kayıt defterindeki cihaz kimliklerini bir blobdan içeri aktarın, güncelleştirin veya silin. Daha fazla bilgi için, bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-identity-registry#import-and-export-device-identities.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/importDevices?api-version=2023-06-30
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
resource
|
path | True |
string |
IoT hub'ını içeren kaynak grubunun adı. |
resource
|
path | True |
string |
IoT hub'ının adı. |
subscription
|
path | True |
string |
Abonelik tanımlayıcısı. |
api-version
|
query | True |
string |
API sürümü. |
İstek Gövdesi
Name | Gerekli | Tür | Description |
---|---|---|---|
inputBlobContainerUri | True |
string |
Giriş blob kapsayıcısı URI'si. |
outputBlobContainerUri | True |
string |
Çıktı blob kapsayıcısı URI'si. |
authenticationType |
Depolama hesabına bağlanmak için kullanılan kimlik doğrulama türünü belirtir. |
||
configurationsBlobName |
string |
Sağlanan giriş blob kapsayıcısından yapılandırmalar içeri aktarılırken kullanılacak blob adı. |
|
identity |
İçeri aktarma cihazları için depolama uç noktasının yönetilen kimlik özellikleri. |
||
includeConfigurations |
boolean |
Yapılandırmaların içeri aktarılıp aktarılmayacağını gösteren değer. |
|
inputBlobName |
string |
Sağlanan giriş blobu kapsayıcısından içeri aktarılırken kullanılacak blob adı. |
|
outputBlobName |
string |
İçeri aktarma işinin durumunu depolamak için kullanılacak blob adı. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Tamam |
|
Other Status Codes |
DefaultErrorResponse |
Güvenlik
azure_auth
Azure Active Directory OAuth2 Flow
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
Name | Description |
---|---|
user_impersonation | kullanıcı hesabınızın kimliğine bürünme |
Örnekler
IotHubResource_ImportDevices
Örnek isteği
POST https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub/importDevices?api-version=2023-06-30
{
"inputBlobContainerUri": "testBlob",
"outputBlobContainerUri": "testBlob"
}
Örnek yanıt
{
"jobId": "test",
"startTimeUtc": "Thu, 15 Jun 2017 19:20:58 GMT",
"endTimeUtc": "Thu, 15 Jun 2017 19:20:58 GMT",
"type": "unknown",
"status": "unknown"
}
Tanımlar
Name | Description |
---|---|
Authentication |
Depolama hesabına bağlanmak için kullanılan kimlik doğrulama türünü belirtir. |
Error |
Hata ayrıntıları. |
Import |
Hub'daki tüm cihazların içeri aktarılmasını istediğinizde parametreleri sağlamak için kullanın. |
Job |
İş Yanıtı nesnesinin özellikleri. |
Job |
İşin durumu. |
Job |
İşin türü. |
Managed |
Yönetilen kimliğin özellikleri. |
AuthenticationType
Depolama hesabına bağlanmak için kullanılan kimlik doğrulama türünü belirtir.
Name | Tür | Description |
---|---|---|
identityBased |
string |
|
keyBased |
string |
ErrorDetails
Hata ayrıntıları.
Name | Tür | Description |
---|---|---|
code |
string |
Hata kodu. |
details |
string |
Hata ayrıntıları. |
httpStatusCode |
string |
HTTP durum kodu. |
message |
string |
Hata iletisi. |
ImportDevicesRequest
Hub'daki tüm cihazların içeri aktarılmasını istediğinizde parametreleri sağlamak için kullanın.
Name | Tür | Description |
---|---|---|
authenticationType |
Depolama hesabına bağlanmak için kullanılan kimlik doğrulama türünü belirtir. |
|
configurationsBlobName |
string |
Sağlanan giriş blob kapsayıcısından yapılandırmalar içeri aktarılırken kullanılacak blob adı. |
identity |
İçeri aktarma cihazları için depolama uç noktasının yönetilen kimlik özellikleri. |
|
includeConfigurations |
boolean |
Yapılandırmaların içeri aktarılıp aktarılmayacağını gösteren değer. |
inputBlobContainerUri |
string |
Giriş blob kapsayıcısı URI'si. |
inputBlobName |
string |
Sağlanan giriş blobu kapsayıcısından içeri aktarılırken kullanılacak blob adı. |
outputBlobContainerUri |
string |
Çıktı blob kapsayıcısı URI'si. |
outputBlobName |
string |
İçeri aktarma işinin durumunu depolamak için kullanılacak blob adı. |
JobResponse
İş Yanıtı nesnesinin özellikleri.
Name | Tür | Description |
---|---|---|
endTimeUtc |
string |
İşin işlemeyi durdurduğu zaman. |
failureReason |
string |
durum == başarısız olursa, hatanın nedenini içeren bu dize. |
jobId |
string |
İş tanımlayıcısı. |
parentJobId |
string |
Varsa, üst işin iş tanımlayıcısı. |
startTimeUtc |
string |
İşin başlangıç saati. |
status |
İşin durumu. |
|
statusMessage |
string |
İşin durum iletisi. |
type |
İşin türü. |
JobStatus
İşin durumu.
Name | Tür | Description |
---|---|---|
cancelled |
string |
|
completed |
string |
|
enqueued |
string |
|
failed |
string |
|
running |
string |
|
unknown |
string |
JobType
İşin türü.
Name | Tür | Description |
---|---|---|
backup |
string |
|
export |
string |
|
factoryResetDevice |
string |
|
firmwareUpdate |
string |
|
import |
string |
|
readDeviceProperties |
string |
|
rebootDevice |
string |
|
unknown |
string |
|
updateDeviceConfiguration |
string |
|
writeDeviceProperties |
string |
ManagedIdentity
Yönetilen kimliğin özellikleri.
Name | Tür | Description |
---|---|---|
userAssignedIdentity |
string |
Kullanıcı tarafından atanan kimlik. |