Iot Hub Resource - Delete
Usuń centrum IoT Hub.
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}?api-version=2023-06-30
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
resource
|
path | True |
string |
Nazwa grupy zasobów zawierającej centrum IoT. |
resource
|
path | True |
string |
Nazwa centrum IoT. |
subscription
|
path | True |
string |
Identyfikator subskrypcji. |
api-version
|
query | True |
string |
Wersja interfejsu API. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Jest to zwracane jako odpowiedź na żądanie sondowania stanu dla operacji usuwania. Treść zawiera reprezentację zasobu, która wskazuje stan przejściowej aprowizacji. |
|
202 Accepted |
Dostawca zasobów usługi Iot Hub zawsze zwraca kod stanu 202 Zaakceptowane z prawidłową lokalizacją i nagłówkami Retry-After. Dostawca zasobów ustawia również nagłówek Azure-AsyncOperation z adresem URL wskazującym zasób operacji dla tej operacji. Kolejne próby GET dla zasobu po operacji DELETE zwracają reprezentację zasobu, która wskazuje stan przejściowej aprowizacji (na przykład zakończenie). Aby pobrać stan operacji, klient może sondować adres URL zwrócony w nagłówku Location po interwale Retry-After, pobrać stan usługi IoT Hub bezpośrednio lub wysłać zapytanie do zasobu operacji. Nagłówki
|
|
204 No Content |
Po pomyślnym zakończeniu długotrwałej operacji usuwania zostanie zwrócony kod stanu 204 Brak zawartości, gdy żądanie sondowania stanu odnajduje metadane centrum IoT w usłudze, a stan operacji usuwania jest ustawiony na ukończony stan. |
|
404 Not Found |
Po pomyślnym zakończeniu długotrwałej operacji usuwania zwracany jest błąd 404 Nie znaleziono, gdy żądanie sondowania stanu nie znajdzie już metadanych centrum IoT w usłudze. |
|
Other Status Codes |
DefaultErrorResponse |
Zabezpieczenia
azure_auth
Przepływ OAuth2 usługi Azure Active Directory
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresy
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
IotHubResource_Delete
Przykładowe żądanie
Przykładowa odpowiedź
{
"id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub",
"name": "testHub",
"type": "Microsoft.Devices/IotHubs",
"location": "centraluseuap",
"tags": {},
"etag": "AAAAAAFD6M4=",
"properties": {
"state": "Active",
"provisioningState": "Succeeded",
"ipFilterRules": [
{
"filterName": "rule1",
"action": "Accept",
"ipMask": "131.117.159.53"
},
{
"filterName": "rule2",
"action": "Accept",
"ipMask": "157.55.59.128/25"
}
],
"networkRuleSets": {
"defaultAction": "Deny",
"applyToBuiltInEventHubEndpoint": true,
"ipRules": [
{
"filterName": "rule1",
"action": "Allow",
"ipMask": "131.117.159.53"
},
{
"filterName": "rule2",
"action": "Allow",
"ipMask": "157.55.59.128/25"
}
]
},
"hostName": "iot-dps-cit-hub-1.azure-devices.net",
"eventHubEndpoints": {
"events": {
"retentionTimeInDays": 1,
"partitionCount": 2,
"partitionIds": [
"0",
"1"
],
"path": "iot-dps-cit-hub-1",
"endpoint": "sb://iothub-ns-iot-dps-ci-245306-76aca8e13b.servicebus.windows.net/"
}
},
"routing": {
"endpoints": {
"serviceBusQueues": [],
"serviceBusTopics": [],
"eventHubs": [],
"storageContainers": []
},
"routes": [],
"fallbackRoute": {
"source": "DeviceMessages",
"condition": "true",
"endpointNames": [
"events"
],
"isEnabled": true
}
},
"storageEndpoints": {
"$default": {
"sasTtlAsIso8601": "PT1H",
"connectionString": "",
"containerName": ""
}
},
"messagingEndpoints": {
"fileNotifications": {
"lockDurationAsIso8601": "PT1M",
"ttlAsIso8601": "PT1H",
"maxDeliveryCount": 10
}
},
"enableFileUploadNotifications": false,
"cloudToDevice": {
"maxDeliveryCount": 10,
"defaultTtlAsIso8601": "PT1H",
"feedback": {
"lockDurationAsIso8601": "PT1M",
"ttlAsIso8601": "PT1H",
"maxDeliveryCount": 10
}
},
"features": "None"
},
"sku": {
"name": "S1",
"tier": "Standard",
"capacity": 1
},
"systemData": {
"createdAt": "2021-01-30T00:28:38.963Z"
}
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/providers/Microsoft.Devices/operationResults/b3NfaWhfYmJhZmM4OWItNzQ3My00OWExLTg0NWUtNzQ3NWU2ODBkNDA3?api-version=2023-06-30-preview&operationSource=os_ih&asyncinfo
Location: https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/providers/Microsoft.Devices/operationResults/b3NfaWhfYmJhZmM4OWItNzQ3My00OWExLTg0NWUtNzQ3NWU2ODBkNDA3?api-version=2022-11-01-preview&operationSource=os_ih
{
"id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub",
"name": "testHub",
"type": "Microsoft.Devices/IotHubs",
"location": "centraluseuap",
"tags": {},
"etag": "AAAAAAFD6M4=",
"properties": {
"state": "Active",
"provisioningState": "Succeeded",
"ipFilterRules": [
{
"filterName": "rule1",
"action": "Accept",
"ipMask": "131.117.159.53"
},
{
"filterName": "rule2",
"action": "Accept",
"ipMask": "157.55.59.128/25"
}
],
"networkRuleSets": {
"defaultAction": "Deny",
"applyToBuiltInEventHubEndpoint": true,
"ipRules": [
{
"filterName": "rule1",
"action": "Allow",
"ipMask": "131.117.159.53"
},
{
"filterName": "rule2",
"action": "Allow",
"ipMask": "157.55.59.128/25"
}
]
},
"hostName": "iot-dps-cit-hub-1.azure-devices.net",
"eventHubEndpoints": {
"events": {
"retentionTimeInDays": 1,
"partitionCount": 2,
"partitionIds": [
"0",
"1"
],
"path": "iot-dps-cit-hub-1",
"endpoint": "sb://iothub-ns-iot-dps-ci-245306-76aca8e13b.servicebus.windows.net/"
}
},
"routing": {
"endpoints": {
"serviceBusQueues": [],
"serviceBusTopics": [],
"eventHubs": [],
"storageContainers": []
},
"routes": [],
"fallbackRoute": {
"source": "DeviceMessages",
"condition": "true",
"endpointNames": [
"events"
],
"isEnabled": true
}
},
"storageEndpoints": {
"$default": {
"sasTtlAsIso8601": "PT1H",
"connectionString": "",
"containerName": ""
}
},
"messagingEndpoints": {
"fileNotifications": {
"lockDurationAsIso8601": "PT1M",
"ttlAsIso8601": "PT1H",
"maxDeliveryCount": 10
}
},
"enableFileUploadNotifications": false,
"cloudToDevice": {
"maxDeliveryCount": 10,
"defaultTtlAsIso8601": "PT1H",
"feedback": {
"lockDurationAsIso8601": "PT1M",
"ttlAsIso8601": "PT1H",
"maxDeliveryCount": 10
}
},
"features": "None"
},
"sku": {
"name": "S1",
"tier": "Standard",
"capacity": 1
}
}
{}
Definicje
Nazwa | Opis |
---|---|
Access |
Uprawnienia przypisane do zasad dostępu współdzielonego. |
Arm |
|
Arm |
|
Authentication |
Określa typ uwierzytelniania używany do nawiązywania połączenia z kontem magazynu. |
authentication |
Metoda używana do uwierzytelniania względem punktu końcowego kolejki usługi Service Bus |
Capabilities |
Możliwości i funkcje włączone dla centrum IoT. |
Cloud |
Właściwości komunikatów z chmury do urządzenia w usłudze IoT Hub. |
created |
Typ tożsamości, która utworzyła zasób. |
Default |
Domyślna akcja dla zestawu reguł sieciowych |
Enrichment |
Właściwości wzbogacania, które centrum IoT ma zastosowanie do komunikatów dostarczanych do punktów końcowych. |
Error |
Szczegóły błędu. |
Event |
Właściwości aprowizowanego punktu końcowego zgodnego z centrum zdarzeń używanego przez centrum IoT Hub. |
Fallback |
Właściwości trasy rezerwowej. IoT Hub używa tych właściwości, gdy kieruje komunikaty do rezerwowego punktu końcowego. |
Feedback |
Właściwości kolejki opinii dla komunikatów z chmury do urządzenia. |
Iot |
Opis centrum IoT. |
Iot |
Publiczna reprezentacja jednej z lokalizacji, w których aprowizowany jest zasób. |
Iot |
Właściwości centrum IoT. |
Iot |
Rola regionu może być podstawowa lub pomocnicza. Region podstawowy to miejsce, w którym jest obecnie aprowizowane centrum IoT. Region pomocniczy to sparowany region odzyskiwania po awarii platformy Azure, a także region, w którym centrum IoT może przejść w tryb failover. |
Iot |
Nazwa jednostki SKU. |
Iot |
Informacje o jednostce SKU centrum IoT. |
Iot |
Warstwa rozliczeń centrum IoT. |
Ip |
Żądana akcja żądań przechwyconych przez tę regułę. |
Ip |
Reguły filtrowania adresów IP dla centrum IoT. |
Managed |
Właściwości tożsamości zarządzanej. |
Messaging |
Właściwości punktów końcowych obsługi komunikatów używanych przez to centrum IoT. |
Network |
Akcja filtru IP |
Network |
Reguła adresu IP, która ma być stosowana w ramach zestawu reguł sieciowych |
Network |
Właściwości zestawu reguł sieciowych usługi IotHub |
Private |
Właściwość prywatnego punktu końcowego połączenia prywatnego punktu końcowego |
Private |
Połączenie prywatnego punktu końcowego usługi IotHub |
Private |
Właściwości połączenia prywatnego punktu końcowego |
Private |
Bieżący stan połączenia prywatnego punktu końcowego |
Private |
Stan połączenia prywatnego punktu końcowego |
Public |
Czy żądania z sieci publicznej są dozwolone |
Resource |
Typ tożsamości używanej dla zasobu. Typ "SystemAssigned, UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "None" spowoduje usunięcie tożsamości z usługi. |
Route |
Właściwości reguły routingu używanej przez centrum IoT do kierowania komunikatów do punktów końcowych. |
Routing |
Właściwości związane z punktem końcowym kontenera sql usługi Cosmos DB. |
Routing |
Właściwości związane z niestandardowymi punktami końcowymi, do których centrum IoT kieruje komunikaty na podstawie reguł routingu. Maksymalnie 10 niestandardowych punktów końcowych jest dozwolonych we wszystkich typach punktów końcowych dla płatnych centrów, a tylko 1 niestandardowy punkt końcowy jest dozwolony we wszystkich typach punktów końcowych dla bezpłatnych centrów. |
Routing |
Właściwości związane z punktem końcowym centrum zdarzeń. |
Routing |
Właściwości powiązane z routingiem centrum IoT. Zobacz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging |
Routing |
Właściwości związane z typami punktów końcowych kolejki usługi Service Bus. |
Routing |
Właściwości związane z typami punktów końcowych tematu usługi Service Bus. |
Routing |
Źródłem, do którego ma zostać zastosowana reguła routingu, na przykład DeviceMessages. |
Routing |
Właściwości związane z punktem końcowym kontenera magazynu. |
Shared |
Właściwości zasad dostępu współdzielonego centrum IoT. |
Storage |
Właściwości punktu końcowego usługi Azure Storage na potrzeby przekazywania plików. |
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
AccessRights
Uprawnienia przypisane do zasad dostępu współdzielonego.
Nazwa | Typ | Opis |
---|---|---|
DeviceConnect |
string |
|
RegistryRead |
string |
|
RegistryRead, DeviceConnect |
string |
|
RegistryRead, RegistryWrite |
string |
|
RegistryRead, RegistryWrite, DeviceConnect |
string |
|
RegistryRead, RegistryWrite, ServiceConnect |
string |
|
RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect |
string |
|
RegistryRead, ServiceConnect |
string |
|
RegistryRead, ServiceConnect, DeviceConnect |
string |
|
RegistryWrite |
string |
|
RegistryWrite, DeviceConnect |
string |
|
RegistryWrite, ServiceConnect |
string |
|
RegistryWrite, ServiceConnect, DeviceConnect |
string |
|
ServiceConnect |
string |
|
ServiceConnect, DeviceConnect |
string |
ArmIdentity
Nazwa | Typ | Opis |
---|---|---|
principalId |
string |
Identyfikator podmiotu zabezpieczeń |
tenantId |
string |
Identyfikator dzierżawy |
type |
Typ tożsamości używanej dla zasobu. Typ "SystemAssigned, UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "Brak" spowoduje usunięcie wszystkich tożsamości z usługi. |
|
userAssignedIdentities |
<string,
Arm |
ArmUserIdentity
Nazwa | Typ | Opis |
---|---|---|
clientId |
string |
|
principalId |
string |
AuthenticationType
Określa typ uwierzytelniania używany do nawiązywania połączenia z kontem magazynu.
Nazwa | Typ | Opis |
---|---|---|
identityBased |
string |
|
keyBased |
string |
authenticationType
Metoda używana do uwierzytelniania względem punktu końcowego kolejki usługi Service Bus
Nazwa | Typ | Opis |
---|---|---|
identityBased |
string |
|
keyBased |
string |
Capabilities
Możliwości i funkcje włączone dla centrum IoT.
Nazwa | Typ | Opis |
---|---|---|
DeviceManagement |
string |
|
None |
string |
CloudToDeviceProperties
Właściwości komunikatów z chmury do urządzenia w usłudze IoT Hub.
Nazwa | Typ | Opis |
---|---|---|
defaultTtlAsIso8601 |
string |
Domyślny czas wygaśnięcia komunikatów z chmury do urządzenia w kolejce urządzenia. Zobacz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. |
feedback |
Właściwości kolejki opinii dla komunikatów z chmury do urządzenia. |
|
maxDeliveryCount |
integer |
Maksymalna liczba dostarczania komunikatów z chmury do urządzenia w kolejce urządzenia. Zobacz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. |
createdByType
Typ tożsamości, która utworzyła zasób.
Nazwa | Typ | Opis |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DefaultAction
Domyślna akcja dla zestawu reguł sieciowych
Nazwa | Typ | Opis |
---|---|---|
Allow |
string |
|
Deny |
string |
EnrichmentProperties
Właściwości wzbogacania, które centrum IoT ma zastosowanie do komunikatów dostarczanych do punktów końcowych.
Nazwa | Typ | Opis |
---|---|---|
endpointNames |
string[] |
Lista punktów końcowych, dla których wzbogacenie jest stosowane do komunikatu. |
key |
string |
Klucz lub nazwa właściwości wzbogacania. |
value |
string |
Wartość właściwości wzbogacania. |
ErrorDetails
Szczegóły błędu.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Kod błędu. |
details |
string |
Szczegóły błędu. |
httpStatusCode |
string |
Kod stanu HTTP. |
message |
string |
Komunikat o błędzie. |
EventHubProperties
Właściwości aprowizowanego punktu końcowego zgodnego z centrum zdarzeń używanego przez centrum IoT Hub.
Nazwa | Typ | Opis |
---|---|---|
endpoint |
string |
Punkt końcowy zgodny z centrum zdarzeń. |
partitionCount |
integer |
Liczba partycji do odbierania komunikatów z urządzenia do chmury w punkcie końcowym zgodnym z centrum zdarzeń. Zobacz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. |
partitionIds |
string[] |
Identyfikatory partycji w punkcie końcowym zgodnym z centrum zdarzeń. |
path |
string |
Nazwa zgodna z centrum zdarzeń. |
retentionTimeInDays |
integer |
Czas przechowywania komunikatów z urządzenia do chmury w dniach. Zobacz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages |
FallbackRouteProperties
Właściwości trasy rezerwowej. IoT Hub używa tych właściwości, gdy kieruje komunikaty do rezerwowego punktu końcowego.
Nazwa | Typ | Opis |
---|---|---|
condition |
string |
Warunek, który jest oceniany w celu zastosowania trasy powrotu. Jeśli warunek nie zostanie podany, zostanie on obliczony domyślnie na wartość true. W przypadku gramatyki zobacz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language |
endpointNames |
string[] |
Lista punktów końcowych, do których są kierowane komunikaty spełniające warunek. Obecnie dozwolony jest tylko 1 punkt końcowy. |
isEnabled |
boolean |
Służy do określania, czy trasa rezerwowa jest włączona. |
name |
string |
Nazwa trasy. Nazwa może zawierać tylko znaki alfanumeryczne, kropki, podkreślenia, łączniki, ma maksymalną długość 64 znaków i musi być unikatowa. |
source |
Źródło, do którego ma zostać zastosowana reguła routingu. Na przykład DeviceMessages |
FeedbackProperties
Właściwości kolejki opinii dla komunikatów z chmury do urządzenia.
Nazwa | Typ | Opis |
---|---|---|
lockDurationAsIso8601 |
string |
Czas trwania blokady kolejki opinii. Zobacz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. |
maxDeliveryCount |
integer |
Liczba prób dostarczenia komunikatu w kolejce opinii przez centrum IoT Hub. Zobacz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. |
ttlAsIso8601 |
string |
Okres, przez który komunikat jest dostępny do użytku, zanim wygaśnie przez centrum IoT. Zobacz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. |
IotHubDescription
Opis centrum IoT.
Nazwa | Typ | Opis |
---|---|---|
etag |
string |
Pole Etag nie jest wymagane. Jeśli jest on podany w treści odpowiedzi, musi być również podany jako nagłówek zgodnie z normalną konwencją ETag. |
id |
string |
Identyfikator zasobu. |
identity |
Tożsamości zarządzane dla usługi IotHub. |
|
location |
string |
Lokalizacja zasobu. |
name |
string |
Nazwa zasobu. |
properties |
Właściwości usługi IotHub |
|
sku |
Informacje o jednostce SKU usługi IotHub |
|
systemData |
Metadane systemowe odnoszące się do tego zasobu. |
|
tags |
object |
Tagi zasobów. |
type |
string |
Typ zasobu. |
IotHubLocationDescription
Publiczna reprezentacja jednej z lokalizacji, w których aprowizowany jest zasób.
Nazwa | Typ | Opis |
---|---|---|
location |
string |
Nazwa regionu świadczenia usługi Azure |
role |
Rola regionu może być podstawowa lub pomocnicza. Region podstawowy to miejsce, w którym jest obecnie aprowizowane centrum IoT. Region pomocniczy to sparowany region odzyskiwania po awarii platformy Azure, a także region, w którym centrum IoT może przejść w tryb failover. |
IotHubProperties
Właściwości centrum IoT.
Nazwa | Typ | Opis |
---|---|---|
allowedFqdnList |
string[] |
Lista dozwolonych nazw FQDN (w pełni kwalifikowana nazwa domeny) dla ruchu wychodzącego z usługi IoT Hub. |
authorizationPolicies |
Zasady dostępu współdzielonego, których można użyć do zabezpieczenia połączenia z centrum IoT. |
|
cloudToDevice |
Właściwości obsługi komunikatów z chmury do urządzenia w usłudze IoT Hub. |
|
comments |
string |
Komentarze do centrum IoT Hub. |
disableDeviceSAS |
boolean |
Jeśli to prawda, nie można używać wszystkich urządzeń (w tym urządzeń brzegowych, ale z wyłączeniem modułów) kluczy SAS w zakresie. |
disableLocalAuth |
boolean |
Jeśli to prawda, tokeny SAS z kluczami sygnatur dostępu współdzielonego o zakresie usługi Iot Hub nie mogą być używane do uwierzytelniania. |
disableModuleSAS |
boolean |
Jeśli to prawda, nie można użyć wszystkich kluczy SAS o zakresie modułu do uwierzytelniania. |
enableDataResidency |
boolean |
Ta właściwość po ustawieniu wartości true włączy rezydencję danych, co spowoduje wyłączenie odzyskiwania po awarii. |
enableFileUploadNotifications |
boolean |
Jeśli wartość True, powiadomienia dotyczące przekazywania plików są włączone. |
eventHubEndpoints |
<string,
Event |
Właściwości punktu końcowego zgodnego z centrum zdarzeń. Jedynymi możliwymi kluczami do tego słownika są zdarzenia. Ten klucz musi być obecny w słowniku podczas tworzenia lub aktualizowania wywołań dla centrum IoT. |
features |
Możliwości i funkcje włączone dla centrum IoT. |
|
hostName |
string |
Nazwa hosta. |
ipFilterRules |
Reguły filtrowania adresów IP. |
|
locations |
Lokalizacja podstawowa i pomocnicza dla centrum iot |
|
messagingEndpoints |
<string,
Messaging |
Właściwości punktu końcowego obsługi komunikatów dla kolejki powiadomień przekazywania plików. |
minTlsVersion |
string |
Określa minimalną wersję protokołu TLS do obsługi dla tego centrum. Można ustawić wartość "1.2", aby klienci korzystający z protokołu TLS w wersji starszej niż 1.2 zostali odrzuceni. |
networkRuleSets |
Właściwości zestawu reguł sieciowych usługi IotHub |
|
privateEndpointConnections |
Połączenia prywatnego punktu końcowego utworzone w tej usłudze IotHub |
|
provisioningState |
string |
Stan aprowizacji. |
publicNetworkAccess |
Czy żądania z sieci publicznej są dozwolone |
|
restrictOutboundNetworkAccess |
boolean |
W przypadku wartości true ruch wychodzący z usługi IotHub będzie ograniczony tylko do dozwolonych nazw FQDN skonfigurowanych za pośrednictwem listy allowedFqdnList. |
routing |
Właściwości powiązane z routingiem centrum IoT. Zobacz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging |
|
state |
string |
Stan centrum. |
storageEndpoints |
<string,
Storage |
Lista punktów końcowych usługi Azure Storage, w których można przekazywać pliki. Obecnie można skonfigurować tylko jedno konto usługi Azure Storage i musi mieć jego klucz jako $default. Określenie więcej niż jednego konta magazynu powoduje zgłoszenie błędu. Nie określono wartości dla tej właściwości, gdy właściwość enableFileUploadNotifications jest ustawiona na wartość True, powoduje zgłoszenie błędu. |
IotHubReplicaRoleType
Rola regionu może być podstawowa lub pomocnicza. Region podstawowy to miejsce, w którym jest obecnie aprowizowane centrum IoT. Region pomocniczy to sparowany region odzyskiwania po awarii platformy Azure, a także region, w którym centrum IoT może przejść w tryb failover.
Nazwa | Typ | Opis |
---|---|---|
primary |
string |
|
secondary |
string |
IotHubSku
Nazwa jednostki SKU.
Nazwa | Typ | Opis |
---|---|---|
B1 |
string |
|
B2 |
string |
|
B3 |
string |
|
F1 |
string |
|
S1 |
string |
|
S2 |
string |
|
S3 |
string |
IotHubSkuInfo
Informacje o jednostce SKU centrum IoT.
Nazwa | Typ | Opis |
---|---|---|
capacity |
integer |
Liczba aprowizowania jednostek IoT Hub. Zobacz: https://docs.microsoft.com/azure/azure-subscription-service-limits#iot-hub-limits. |
name |
Nazwa jednostki SKU. |
|
tier |
Warstwa rozliczeń dla centrum IoT. |
IotHubSkuTier
Warstwa rozliczeń centrum IoT.
Nazwa | Typ | Opis |
---|---|---|
Basic |
string |
|
Free |
string |
|
Standard |
string |
IpFilterActionType
Żądana akcja żądań przechwyconych przez tę regułę.
Nazwa | Typ | Opis |
---|---|---|
Accept |
string |
|
Reject |
string |
IpFilterRule
Reguły filtrowania adresów IP dla centrum IoT.
Nazwa | Typ | Opis |
---|---|---|
action |
Żądana akcja żądań przechwyconych przez tę regułę. |
|
filterName |
string |
Nazwa reguły filtrowania adresów IP. |
ipMask |
string |
Ciąg zawierający zakres adresów IP w notacji CIDR dla reguły. |
ManagedIdentity
Właściwości tożsamości zarządzanej.
Nazwa | Typ | Opis |
---|---|---|
userAssignedIdentity |
string |
Tożsamość przypisana przez użytkownika. |
MessagingEndpointProperties
Właściwości punktów końcowych obsługi komunikatów używanych przez to centrum IoT.
Nazwa | Typ | Opis |
---|---|---|
lockDurationAsIso8601 |
string |
Czas trwania blokady. Zobacz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload. |
maxDeliveryCount |
integer |
Liczba prób dostarczenia komunikatu przez centrum IoT Hub. Zobacz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload. |
ttlAsIso8601 |
string |
Okres, przez który komunikat jest dostępny do użytku, zanim wygaśnie przez centrum IoT. Zobacz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload. |
NetworkRuleIPAction
Akcja filtru IP
Nazwa | Typ | Opis |
---|---|---|
Allow |
string |
NetworkRuleSetIpRule
Reguła adresu IP, która ma być stosowana w ramach zestawu reguł sieciowych
Nazwa | Typ | Domyślna wartość | Opis |
---|---|---|---|
action | Allow |
Akcja filtru IP |
|
filterName |
string |
Nazwa reguły filtrowania adresów IP. |
|
ipMask |
string |
Ciąg zawierający zakres adresów IP w notacji CIDR dla reguły. |
NetworkRuleSetProperties
Właściwości zestawu reguł sieciowych usługi IotHub
Nazwa | Typ | Domyślna wartość | Opis |
---|---|---|---|
applyToBuiltInEventHubEndpoint |
boolean |
Jeśli wartość True, zestaw reguł sieci jest również stosowany do aplikacji BuiltIn EventHub EndPoint of IotHub |
|
defaultAction | Deny |
Domyślna akcja dla zestawu reguł sieci |
|
ipRules |
Lista reguł adresów IP |
PrivateEndpoint
Właściwość prywatnego punktu końcowego połączenia prywatnego punktu końcowego
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator zasobu. |
PrivateEndpointConnection
Połączenie prywatnego punktu końcowego usługi IotHub
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator zasobu. |
name |
string |
Nazwa zasobu. |
properties |
Właściwości połączenia prywatnego punktu końcowego |
|
type |
string |
Typ zasobu. |
PrivateEndpointConnectionProperties
Właściwości połączenia prywatnego punktu końcowego
Nazwa | Typ | Opis |
---|---|---|
privateEndpoint |
Właściwość prywatnego punktu końcowego połączenia prywatnego punktu końcowego |
|
privateLinkServiceConnectionState |
Bieżący stan połączenia prywatnego punktu końcowego |
PrivateLinkServiceConnectionState
Bieżący stan połączenia prywatnego punktu końcowego
Nazwa | Typ | Opis |
---|---|---|
actionsRequired |
string |
Akcje wymagane dla połączenia prywatnego punktu końcowego |
description |
string |
Opis bieżącego stanu połączenia prywatnego punktu końcowego |
status |
Stan połączenia prywatnego punktu końcowego |
PrivateLinkServiceConnectionStatus
Stan połączenia prywatnego punktu końcowego
Nazwa | Typ | Opis |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
PublicNetworkAccess
Czy żądania z sieci publicznej są dozwolone
Nazwa | Typ | Opis |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ResourceIdentityType
Typ tożsamości używanej dla zasobu. Typ "SystemAssigned, UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "None" spowoduje usunięcie tożsamości z usługi.
Nazwa | Typ | Opis |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
RouteProperties
Właściwości reguły routingu używanej przez centrum IoT do kierowania komunikatów do punktów końcowych.
Nazwa | Typ | Opis |
---|---|---|
condition |
string |
Warunek, który jest oceniany w celu zastosowania reguły routingu. Jeśli nie podano warunku, wartość jest domyślnie obliczana na wartość true. Aby uzyskać gramatykę, zobacz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language |
endpointNames |
string[] |
Lista punktów końcowych, do których są kierowane komunikaty spełniające warunek. Obecnie dozwolony jest tylko jeden punkt końcowy. |
isEnabled |
boolean |
Służy do określania, czy trasa jest włączona. |
name |
string |
Nazwa trasy. Nazwa może zawierać tylko znaki alfanumeryczne, kropki, podkreślenia, łączniki, ma maksymalną długość 64 znaków i musi być unikatowa. |
source |
Źródłem, do którego ma zostać zastosowana reguła routingu, na przykład DeviceMessages. |
RoutingCosmosDBSqlApiProperties
Właściwości związane z punktem końcowym kontenera sql usługi Cosmos DB.
Nazwa | Typ | Opis |
---|---|---|
authenticationType |
Metoda używana do uwierzytelniania względem punktu końcowego kontenera sql usługi Cosmos DB |
|
containerName |
string |
Nazwa kontenera sql usługi Cosmos DB w bazie danych cosmos DB. |
databaseName |
string |
Nazwa bazy danych cosmos DB na koncie usługi Cosmos DB. |
endpointUri |
string |
Adres URL konta usługi Cosmos DB. Musi zawierać protokół https:// |
id |
string |
Identyfikator punktu końcowego kontenera sql usługi Cosmos DB |
identity |
Właściwości tożsamości zarządzanej dotyczące routingu punktu końcowego kontenera usługi Cosmos DB. |
|
name |
string |
Nazwa identyfikująca ten punkt końcowy. Nazwa może zawierać tylko znaki alfanumeryczne, kropki, podkreślenia, łączniki i ma maksymalną długość 64 znaków. Następujące nazwy są zarezerwowane: zdarzenia, fileNotifications, $default. Nazwy punktów końcowych muszą być unikatowe w różnych typach punktów końcowych. |
partitionKeyName |
string |
Nazwa klucza partycji skojarzonego z tym kontenerem sql usługi Cosmos DB, jeśli istnieje. Jest to opcjonalny parametr. |
partitionKeyTemplate |
string |
Szablon służący do generowania syntetycznej wartości klucza partycji do użycia z tym kontenerem sql usługi Cosmos DB. Szablon musi zawierać co najmniej jeden z następujących symboli zastępczych: {iothub}, {deviceid}, {DD}, {MM}i {RRRR}. Każdy symbol zastępczy może być określony co najwyżej raz, ale składniki kolejności i symboli zastępczych są dowolne. Ten parametr jest wymagany tylko wtedy, gdy określono parametr PartitionKeyName. |
primaryKey |
string |
Klucz podstawowy konta usługi Cosmos DB. |
resourceGroup |
string |
Nazwa grupy zasobów konta usługi Cosmos DB. |
secondaryKey |
string |
Klucz pomocniczy konta usługi Cosmos DB. |
subscriptionId |
string |
Identyfikator subskrypcji konta usługi Cosmos DB. |
RoutingEndpoints
Właściwości związane z niestandardowymi punktami końcowymi, do których centrum IoT kieruje komunikaty na podstawie reguł routingu. Maksymalnie 10 niestandardowych punktów końcowych jest dozwolonych we wszystkich typach punktów końcowych dla płatnych centrów, a tylko 1 niestandardowy punkt końcowy jest dozwolony we wszystkich typach punktów końcowych dla bezpłatnych centrów.
Nazwa | Typ | Opis |
---|---|---|
cosmosDBSqlContainers |
Lista punktów końcowych kontenera usługi Cosmos DB, do których usługa IoT Hub kieruje komunikaty na podstawie reguł routingu. |
|
eventHubs |
Lista punktów końcowych usługi Event Hubs, do których usługa IoT Hub kieruje komunikaty na podstawie reguł routingu. Ta lista nie zawiera wbudowanego punktu końcowego usługi Event Hubs. |
|
serviceBusQueues |
Lista punktów końcowych kolejki usługi Service Bus, do których usługa IoT Hub kieruje komunikaty na podstawie reguł routingu. |
|
serviceBusTopics |
Lista punktów końcowych tematu usługi Service Bus, do których centrum IoT kieruje komunikaty na podstawie reguł routingu. |
|
storageContainers |
Lista punktów końcowych kontenera magazynu, do których usługa IoT Hub kieruje komunikaty na podstawie reguł routingu. |
RoutingEventHubProperties
Właściwości związane z punktem końcowym centrum zdarzeń.
Nazwa | Typ | Opis |
---|---|---|
authenticationType |
Metoda używana do uwierzytelniania względem punktu końcowego centrum zdarzeń |
|
connectionString |
string |
Parametry połączenia punktu końcowego centrum zdarzeń. |
endpointUri |
string |
Adres URL punktu końcowego centrum zdarzeń. Musi zawierać protokół sb:// |
entityPath |
string |
Nazwa centrum zdarzeń w przestrzeni nazw centrum zdarzeń |
id |
string |
Identyfikator punktu końcowego centrum zdarzeń |
identity |
Właściwości tożsamości zarządzanej punktu końcowego centrum zdarzeń routingu. |
|
name |
string |
Nazwa identyfikująca ten punkt końcowy. Nazwa może zawierać tylko znaki alfanumeryczne, kropki, podkreślenia, łączniki i ma maksymalną długość 64 znaków. Następujące nazwy są zarezerwowane: zdarzenia, fileNotifications, $default. Nazwy punktów końcowych muszą być unikatowe w różnych typach punktów końcowych. |
resourceGroup |
string |
Nazwa grupy zasobów punktu końcowego centrum zdarzeń. |
subscriptionId |
string |
Identyfikator subskrypcji punktu końcowego centrum zdarzeń. |
RoutingProperties
Właściwości powiązane z routingiem centrum IoT. Zobacz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging
Nazwa | Typ | Opis |
---|---|---|
endpoints |
Właściwości związane z niestandardowymi punktami końcowymi, do których centrum IoT kieruje komunikaty na podstawie reguł routingu. Maksymalnie 10 niestandardowych punktów końcowych jest dozwolonych we wszystkich typach punktów końcowych dla płatnych centrów, a tylko 1 niestandardowy punkt końcowy jest dozwolony we wszystkich typach punktów końcowych dla bezpłatnych centrów. |
|
enrichments |
Lista wzbogacenia udostępnianych przez użytkownika, które centrum IoT ma zastosowanie do komunikatów dostarczanych do wbudowanych i niestandardowych punktów końcowych. Zobacz: https://aka.ms/telemetryoneventgrid |
|
fallbackRoute |
Właściwości trasy, która jest używana jako trasa rezerwowa, gdy żaden z warunków określonych w sekcji "trasy" nie jest spełniony. Jest to opcjonalny parametr. Jeśli ta właściwość nie jest obecna w szablonie, trasa rezerwowa jest domyślnie wyłączona. |
|
routes |
Lista reguł routingu udostępnianych przez użytkownika, których usługa IoT Hub używa do kierowania komunikatów do wbudowanych i niestandardowych punktów końcowych. Dla płatnych koncentratorów dozwolonych jest maksymalnie 100 reguł routingu, a w przypadku bezpłatnych koncentratorów dozwolonych jest maksymalnie 5 reguł routingu. |
RoutingServiceBusQueueEndpointProperties
Właściwości związane z typami punktów końcowych kolejki usługi Service Bus.
Nazwa | Typ | Opis |
---|---|---|
authenticationType |
Metoda używana do uwierzytelniania względem punktu końcowego kolejki usługi Service Bus |
|
connectionString |
string |
Parametry połączenia punktu końcowego kolejki usługi Service Bus. |
endpointUri |
string |
Adres URL punktu końcowego kolejki usługi Service Bus. Musi zawierać protokół sb:// |
entityPath |
string |
Nazwa kolejki w przestrzeni nazw usługi Service Bus |
id |
string |
Identyfikator punktu końcowego kolejki usługi Service Bus |
identity |
Właściwości tożsamości zarządzanej punktu końcowego kolejki usługi Service Bus. |
|
name |
string |
Nazwa identyfikująca ten punkt końcowy. Nazwa może zawierać tylko znaki alfanumeryczne, kropki, podkreślenia, łączniki i ma maksymalną długość 64 znaków. Następujące nazwy są zarezerwowane: zdarzenia, fileNotifications, $default. Nazwy punktów końcowych muszą być unikatowe w różnych typach punktów końcowych. Nazwa nie musi być taka sama jak rzeczywista nazwa kolejki. |
resourceGroup |
string |
Nazwa grupy zasobów punktu końcowego kolejki usługi Service Bus. |
subscriptionId |
string |
Identyfikator subskrypcji punktu końcowego kolejki usługi Service Bus. |
RoutingServiceBusTopicEndpointProperties
Właściwości związane z typami punktów końcowych tematu usługi Service Bus.
Nazwa | Typ | Opis |
---|---|---|
authenticationType |
Metoda używana do uwierzytelniania względem punktu końcowego tematu usługi Service Bus |
|
connectionString |
string |
Parametry połączenia punktu końcowego tematu usługi Service Bus. |
endpointUri |
string |
Adres URL punktu końcowego tematu usługi Service Bus. Musi zawierać protokół sb:// |
entityPath |
string |
Nazwa kolejki w temacie usługi Service Bus |
id |
string |
Identyfikator punktu końcowego tematu usługi Service Bus |
identity |
Właściwości tożsamości zarządzanej punktu końcowego tematu usługi Service Bus routingu. |
|
name |
string |
Nazwa identyfikująca ten punkt końcowy. Nazwa może zawierać tylko znaki alfanumeryczne, kropki, podkreślenia, łączniki i ma maksymalną długość 64 znaków. Następujące nazwy są zarezerwowane: zdarzenia, fileNotifications, $default. Nazwy punktów końcowych muszą być unikatowe w różnych typach punktów końcowych. Nazwa nie musi być taka sama jak rzeczywista nazwa tematu. |
resourceGroup |
string |
Nazwa grupy zasobów punktu końcowego tematu usługi Service Bus. |
subscriptionId |
string |
Identyfikator subskrypcji punktu końcowego tematu usługi Service Bus. |
RoutingSource
Źródłem, do którego ma zostać zastosowana reguła routingu, na przykład DeviceMessages.
Nazwa | Typ | Opis |
---|---|---|
DeviceConnectionStateEvents |
string |
|
DeviceJobLifecycleEvents |
string |
|
DeviceLifecycleEvents |
string |
|
DeviceMessages |
string |
|
Invalid |
string |
|
TwinChangeEvents |
string |
RoutingStorageContainerProperties
Właściwości związane z punktem końcowym kontenera magazynu.
Nazwa | Typ | Opis |
---|---|---|
authenticationType |
Metoda używana do uwierzytelniania w punkcie końcowym magazynu |
|
batchFrequencyInSeconds |
integer |
Interwał czasu, w którym obiekty blob są zapisywane w magazynie. Wartość powinna wynosić od 60 do 720 sekund. Wartość domyślna to 300 sekund. |
connectionString |
string |
Parametry połączenia konta magazynu. |
containerName |
string |
Nazwa kontenera magazynu na koncie magazynu. |
encoding |
enum:
|
Kodowanie używane do serializacji komunikatów do obiektów blob. Obsługiwane wartości to "avro", "avrodeflate" i "JSON". Wartość domyślna to "avro". |
endpointUri |
string |
Adres URL punktu końcowego magazynu. Musi zawierać protokół https:// |
fileNameFormat |
string |
Format nazwy pliku dla obiektu blob. Domyślny format to {iothub}/{partition}/{RRRR}/{MM}/{DD}/{HH}/{mm}.{mm}. Wszystkie parametry są obowiązkowe, ale można zmienić kolejność. |
id |
string |
Identyfikator punktu końcowego kontenera magazynu |
identity |
Właściwości tożsamości zarządzanej punktu końcowego magazynu routingu. |
|
maxChunkSizeInBytes |
integer |
Maksymalna liczba bajtów dla każdego obiektu blob zapisanego w magazynie. Wartość powinna należeć do 10485760 (10 MB) i 524288000(500 MB). Wartość domyślna to 314572800 (300 MB). |
name |
string |
Nazwa identyfikująca ten punkt końcowy. Nazwa może zawierać tylko znaki alfanumeryczne, kropki, podkreślenia, łączniki i ma maksymalną długość 64 znaków. Następujące nazwy są zarezerwowane: zdarzenia, fileNotifications, $default. Nazwy punktów końcowych muszą być unikatowe w różnych typach punktów końcowych. |
resourceGroup |
string |
Nazwa grupy zasobów konta magazynu. |
subscriptionId |
string |
Identyfikator subskrypcji konta magazynu. |
SharedAccessSignatureAuthorizationRule
Właściwości zasad dostępu współdzielonego centrum IoT.
Nazwa | Typ | Opis |
---|---|---|
keyName |
string |
Nazwa zasad dostępu współdzielonego. |
primaryKey |
string |
Klucz podstawowy. |
rights |
Uprawnienia przypisane do zasad dostępu współdzielonego. |
|
secondaryKey |
string |
Klucz pomocniczy. |
StorageEndpointProperties
Właściwości punktu końcowego usługi Azure Storage na potrzeby przekazywania plików.
Nazwa | Typ | Opis |
---|---|---|
authenticationType |
Określa typ uwierzytelniania używany do nawiązywania połączenia z kontem magazynu. |
|
connectionString |
string |
Parametry połączenia dla konta usługi Azure Storage, do którego są przekazywane pliki. |
containerName |
string |
Nazwa kontenera głównego, w którym są przekazywane pliki. Kontener nie musi istnieć, ale powinien być creatable przy użyciu określonego parametru connectionString. |
identity |
Właściwości tożsamości zarządzanej punktu końcowego magazynu na potrzeby przekazywania plików. |
|
sasTtlAsIso8601 |
string |
Okres, dla którego identyfikator URI sygnatury dostępu współdzielonego wygenerowany przez IoT Hub przekazywania plików jest prawidłowy. Zobacz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. |
systemData
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
Nazwa | Typ | Opis |
---|---|---|
createdAt |
string |
Sygnatura czasowa tworzenia zasobów (UTC). |
createdBy |
string |
Tożsamość, która utworzyła zasób. |
createdByType |
Typ tożsamości, która utworzyła zasób. |
|
lastModifiedAt |
string |
Sygnatura czasowa ostatniej modyfikacji zasobu (UTC) |
lastModifiedBy |
string |
Tożsamość, która ostatnio zmodyfikowała zasób. |
lastModifiedByType |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |