Iot Connectors - Create Or Update
Tworzy lub aktualizuje zasób IoT Connector przy użyciu określonych parametrów.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HealthcareApis/workspaces/{workspaceName}/iotconnectors/{iotConnectorName}?api-version=2022-06-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
iot
|
path | True |
string |
Nazwa zasobu IoT Connector. |
resource
|
path | True |
string |
Nazwa grupy zasobów zawierającej wystąpienie usługi. Regex pattern: |
subscription
|
path | True |
string |
Identyfikator subskrypcji. |
workspace
|
path | True |
string |
Nazwa zasobu obszaru roboczego. |
api-version
|
query | True |
string |
Wersja interfejsu API klienta. |
Treść żądania
Nazwa | Typ | Opis |
---|---|---|
etag |
string |
Element etag skojarzony z zasobem, używany do optymistycznej współbieżności podczas jej edytowania. |
identity |
Ustawienie wskazujące, czy usługa ma skojarzona tożsamość zarządzaną. |
|
location |
string |
Lokalizacja zasobu. |
properties.deviceMapping |
Mapowania urządzeń. |
|
properties.ingestionEndpointConfiguration |
Konfiguracja źródła. |
|
tags |
object |
Tagi zasobów. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Zaktualizowano — umieść żądanie zaakceptowane i zaktualizowano istniejący zasób. |
|
201 Created |
Utworzone — umieść żądanie zaakceptowane i istniejący zasób jest tworzony asynchronicznie. |
|
202 Accepted |
Zaakceptowane — zaakceptuj żądanie, a istniejący zasób jest aktualizowany asynchronicznie. |
|
Other Status Codes |
Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. |
Zabezpieczenia
azure_auth
Przepływ OAuth2 usługi Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
Create an IoT Connector
Sample Request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/testRG/providers/Microsoft.HealthcareApis/workspaces/workspace1/iotconnectors/blue?api-version=2022-06-01
{
"location": "westus",
"tags": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
},
"identity": {
"type": "SystemAssigned"
},
"properties": {
"ingestionEndpointConfiguration": {
"eventHubName": "MyEventHubName",
"consumerGroup": "ConsumerGroupA",
"fullyQualifiedEventHubNamespace": "myeventhub.servicesbus.windows.net"
},
"deviceMapping": {
"content": {
"templateType": "CollectionContent",
"template": [
{
"templateType": "JsonPathContent",
"template": {
"typeName": "heartrate",
"typeMatchExpression": "$..[?(@heartrate)]",
"deviceIdExpression": "$.deviceid",
"timestampExpression": "$.measurementdatetime",
"values": [
{
"required": "true",
"valueExpression": "$.heartrate",
"valueName": "hr"
}
]
}
}
]
}
}
}
}
Sample Response
{
"name": "blue",
"id": "/subscriptions/subid/resourceGroups/testRG/providers/Microsoft.HealthcareApis/workspaces/workspace1/iotconnectors/blue",
"type": "Microsoft.HealthcareApis/workspaces/iotconnectors",
"location": "westus",
"etag": "00000000-0000-0000-f5ac-912ca49e01d6",
"tags": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
},
"identity": {
"type": "SystemAssigned"
},
"properties": {
"provisioningState": "Succeeded",
"ingestionEndpointConfiguration": {
"eventHubName": "MyEventHubName",
"consumerGroup": "ConsumerGroupA",
"fullyQualifiedEventHubNamespace": "myeventhub.servicesbus.windows.net"
},
"deviceMapping": {
"content": {
"templateType": "CollectionContent",
"template": [
{
"templateType": "JsonPathContent",
"template": {
"typeName": "heartrate",
"typeMatchExpression": "$..[?(@heartrate)]",
"deviceIdExpression": "$.deviceid",
"timestampExpression": "$.measurementdatetime",
"values": [
{
"required": "true",
"valueExpression": "$.heartrate",
"valueName": "hr"
}
]
}
}
]
}
}
},
"systemData": {
"createdBy": "string",
"createdAt": "2021-01-28T19:26:24.072Z",
"lastModifiedBy": "string",
"lastModifiedAt": "2021-01-28T19:26:24.072Z"
}
}
{
"name": "blue",
"id": "/subscriptions/subid/resourceGroups/testRG/providers/Microsoft.HealthcareApis/workspaces/workspace1/iotconnectors/blue",
"type": "Microsoft.HealthcareApis/workspaces/iotconnectors",
"location": "westus",
"etag": "00000000-0000-0000-f5ac-912ca49e01d6",
"tags": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
},
"identity": {
"type": "SystemAssigned"
},
"properties": {
"provisioningState": "Creating",
"ingestionEndpointConfiguration": {
"eventHubName": "MyEventHubName",
"consumerGroup": "ConsumerGroupA",
"fullyQualifiedEventHubNamespace": "myeventhub.servicesbus.windows.net"
},
"deviceMapping": {
"content": {
"templateType": "CollectionContent",
"template": [
{
"templateType": "JsonPathContent",
"template": {
"typeName": "heartrate",
"typeMatchExpression": "$..[?(@heartrate)]",
"deviceIdExpression": "$.deviceid",
"timestampExpression": "$.measurementdatetime",
"values": [
{
"required": "true",
"valueExpression": "$.heartrate",
"valueName": "hr"
}
]
}
}
]
}
}
},
"systemData": {
"createdBy": "string",
"createdAt": "2021-01-28T19:26:24.072Z",
"lastModifiedBy": "string",
"lastModifiedAt": "2021-01-28T19:26:24.072Z"
}
}
{
"name": "blue",
"id": "/subscriptions/subid/resourceGroups/testRG/providers/Microsoft.HealthcareApis/workspaces/workspace1/iotconnectors/blue",
"type": "Microsoft.HealthcareApis/workspaces/iotconnectors",
"location": "westus",
"etag": "00000000-0000-0000-f5ac-912ca49e01d6",
"tags": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
},
"identity": {
"type": "SystemAssigned"
},
"properties": {
"provisioningState": "Accepted",
"ingestionEndpointConfiguration": {
"eventHubName": "MyEventHubName",
"consumerGroup": "ConsumerGroupA",
"fullyQualifiedEventHubNamespace": "myeventhub.servicesbus.windows.net"
},
"deviceMapping": {
"content": {
"templateType": "CollectionContent",
"template": [
{
"templateType": "JsonPathContent",
"template": {
"typeName": "heartrate",
"typeMatchExpression": "$..[?(@heartrate)]",
"deviceIdExpression": "$.deviceid",
"timestampExpression": "$.measurementdatetime",
"values": [
{
"required": "true",
"valueExpression": "$.heartrate",
"valueName": "hr"
}
]
}
}
]
}
}
},
"systemData": {
"createdBy": "string",
"createdAt": "2021-01-28T19:26:24.072Z",
"lastModifiedBy": "string",
"lastModifiedAt": "2021-01-28T19:26:24.072Z"
}
}
Definicje
Nazwa | Opis |
---|---|
created |
Typ tożsamości, która utworzyła zasób. |
Error |
Szczegóły błędu. |
Error |
Szczegóły błędu. |
Identity |
Ustawienie wskazujące, czy usługa ma skojarzona tożsamość zarządzaną. |
Iot |
definicja IoT Connector. |
Iot |
Konfiguracja punktu końcowego pozyskiwania centrum zdarzeń |
Iot |
Zawartość mapowania. |
provisioning |
Stan aprowizacji. |
Service |
Typ określonej tożsamości, obecnie SystemAssigned i None są dozwolone. |
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
User |
Właściwości tożsamości przypisanej przez użytkownika |
createdByType
Typ tożsamości, która utworzyła zasób.
Nazwa | Typ | Opis |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorDetails
Szczegóły błędu.
Nazwa | Typ | Opis |
---|---|---|
error |
Szczegóły błędu |
ErrorDetailsInternal
Szczegóły błędu.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Kod błędu. |
message |
string |
Komunikat o błędzie. |
target |
string |
Element docelowy określonego błędu. |
Identity
Ustawienie wskazujące, czy usługa ma skojarzona tożsamość zarządzaną.
Nazwa | Typ | Opis |
---|---|---|
principalId |
string |
Identyfikator jednostki usługi tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system. |
tenantId |
string |
Identyfikator dzierżawy tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system. |
type |
Typ określonej tożsamości, obecnie SystemAssigned i None są dozwolone. |
|
userAssignedIdentities |
<string,
User |
tożsamości User-Assigned |
IotConnector
definicja IoT Connector.
Nazwa | Typ | Opis |
---|---|---|
etag |
string |
Element etag skojarzony z zasobem, używany do optymistycznej współbieżności podczas jej edytowania. |
id |
string |
Identyfikator zasobu. |
identity |
Ustawienie wskazujące, czy usługa ma skojarzona tożsamość zarządzaną. |
|
location |
string |
Lokalizacja zasobu. |
name |
string |
Nazwa zasobu. |
properties.deviceMapping |
Mapowania urządzeń. |
|
properties.ingestionEndpointConfiguration |
Konfiguracja źródła. |
|
properties.provisioningState |
Stan aprowizacji. |
|
systemData |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
|
tags |
object |
Tagi zasobów. |
type |
string |
Typ zasobu. |
IotEventHubIngestionEndpointConfiguration
Konfiguracja punktu końcowego pozyskiwania centrum zdarzeń
Nazwa | Typ | Opis |
---|---|---|
consumerGroup |
string |
Grupa odbiorców centrum zdarzeń do połączenia. |
eventHubName |
string |
Nazwa centrum zdarzeń do nawiązania połączenia. |
fullyQualifiedEventHubNamespace |
string |
W pełni kwalifikowana przestrzeń nazw centrum zdarzeń do nawiązania połączenia. |
IotMappingProperties
Zawartość mapowania.
Nazwa | Typ | Opis |
---|---|---|
content |
object |
Mapowanie. |
provisioningState
Stan aprowizacji.
Nazwa | Typ | Opis |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Deprovisioned |
string |
|
Failed |
string |
|
Moving |
string |
|
Succeeded |
string |
|
Suspended |
string |
|
SystemMaintenance |
string |
|
Updating |
string |
|
Verifying |
string |
|
Warned |
string |
ServiceManagedIdentityType
Typ określonej tożsamości, obecnie SystemAssigned i None są dozwolone.
Nazwa | Typ | Opis |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned,UserAssigned |
string |
|
UserAssigned |
string |
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. |
UserAssignedIdentity
Właściwości tożsamości przypisanej przez użytkownika
Nazwa | Typ | Opis |
---|---|---|
clientId |
string |
Identyfikator klienta przypisanej tożsamości. |
principalId |
string |
Identyfikator podmiotu zabezpieczeń przypisanej tożsamości. |