Partager via


Event Sources - Create Or Update

Créez ou mettez à jour une source d’événements dans l’environnement spécifié.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TimeSeriesInsights/environments/{environmentName}/eventSources/{eventSourceName}?api-version=2020-05-15

Paramètres URI

Nom Dans Obligatoire Type Description
environmentName
path True

string

Nom de l’environnement Time Series Insights associé au groupe de ressources spécifié.

eventSourceName
path True

string

Nom de la source de l’événement.

Regex pattern: ^[-\w\._\(\)]+$

resourceGroupName
path True

string

Nom d’un groupe de ressources Azure.

subscriptionId
path True

string

ID d’abonnement Azure.

api-version
query True

string

Version de l’API à utiliser avec la demande du client.

Corps de la demande

Le corps de la requête peut être l’un des suivants :

Nom Description
EventHubEventSourceCreateOrUpdateParameters

Paramètres fournis à l’opération Créer ou mettre à jour une source d’événements pour une source d’événement EventHub.

IoTHubEventSourceCreateOrUpdateParameters

Paramètres fournis à l’opération Créer ou mettre à jour une source d’événements pour une source d’événements IoTHub.

EventHubEventSourceCreateOrUpdateParameters

Paramètres fournis à l’opération Créer ou mettre à jour une source d’événements pour une source d’événement EventHub.

Nom Obligatoire Type Description
eventSourceResourceId True

string

ID de ressource de la source d’événement dans Azure Resource Manager.

kind True string:

Microsoft.EventHub

Type de la source de l’événement.

location True

string

Emplacement de la ressource.

properties.consumerGroupName True

string

Nom du groupe de consommateurs du hub d’événements qui contient les partitions à partir desquelles les événements seront lus.

properties.eventHubName True

string

Nom du hub d’événements.

properties.keyName True

string

Nom de la clé SAS qui accorde au service Time Series Insights l’accès au hub d’événements. Les stratégies d’accès partagé pour cette clé doivent accorder des autorisations « Écouter » au hub d’événements.

properties.serviceBusNamespace True

string

Nom du service bus qui contient le hub d’événements.

properties.sharedAccessKey True

string

Valeur de la clé d’accès partagé qui accorde au service Time Series Insights un accès en lecture au hub d’événements. Cette propriété n’est pas affichée dans les réponses à la source d’événement.

ingressStartAt.time

string

ISO8601 datetime UTC avec une précision en secondes (les millisecondes sont facultatives), en spécifiant la date et l’heure qui seront le point de départ des événements à consommer.

ingressStartAt.type

IngressStartAtType

Type de l’ingressStartAt, Il peut être « EarliestAvailable », « EventSourceCreationTime », « CustomEnqueuedTime ».

localTimestamp

LocalTimestamp

Objet qui représente la propriété timestamp locale. Il contient le format de l’horodatage local qui doit être utilisé et les informations de décalage de fuseau horaire correspondantes. Si aucune valeur n’est spécifiée pour localTimestamp, ou si la valeur est null, l’horodatage local n’est pas entré avec les événements.

tags

object

Paires clé-valeur de propriétés supplémentaires pour la ressource.

timestampPropertyName

string

Propriété de l’événement qui sera utilisée comme horodateur de la source de l’événement. Si aucune valeur n’est spécifiée pour timestampPropertyName, ou si la valeur Null ou une chaîne vide est spécifiée, l’heure de création de l’événement sera utilisée.

IoTHubEventSourceCreateOrUpdateParameters

Paramètres fournis à l’opération Créer ou mettre à jour une source d’événements pour une source d’événements IoTHub.

Nom Obligatoire Type Description
eventSourceResourceId True

string

ID de ressource de la source d’événement dans Azure Resource Manager.

kind True string:

Microsoft.IoTHub

Type de la source de l’événement.

location True

string

Emplacement de la ressource.

properties.consumerGroupName True

string

Nom du groupe de consommateurs du hub iot qui contient les partitions à partir desquelles les événements seront lus.

properties.iotHubName True

string

Nom du hub iot.

properties.keyName True

string

Nom de la clé de stratégie d’accès partagé qui accorde au service Time Series Insights l’accès au hub iot. Cette clé de stratégie d’accès partagé doit accorder des autorisations de connexion de service au hub iot.

properties.sharedAccessKey True

string

Valeur de la clé de stratégie d’accès partagé qui accorde au service Time Series Insights un accès en lecture au hub iot. Cette propriété n’est pas affichée dans les réponses à la source d’événement.

ingressStartAt.time

string

ISO8601 datetime UTC avec une précision en secondes (les millisecondes sont facultatives), en spécifiant la date et l’heure qui seront le point de départ des événements à consommer.

ingressStartAt.type

IngressStartAtType

Type de l’ingressStartAt, Il peut être « EarliestAvailable », « EventSourceCreationTime », « CustomEnqueuedTime ».

localTimestamp

LocalTimestamp

Objet qui représente la propriété timestamp locale. Il contient le format de l’horodatage local qui doit être utilisé et les informations de décalage de fuseau horaire correspondantes. Si aucune valeur n’est spécifiée pour localTimestamp, ou si la valeur est null, l’horodatage local n’est pas entré avec les événements.

tags

object

Paires clé-valeur de propriétés supplémentaires pour la ressource.

timestampPropertyName

string

Propriété de l’événement qui sera utilisée comme horodateur de la source de l’événement. Si aucune valeur n’est spécifiée pour timestampPropertyName, ou si la valeur Null ou une chaîne vide est spécifiée, l’heure de création de l’événement sera utilisée.

Réponses

Nom Type Description
200 OK EventSourceResource:

La définition de source d’événement existante a été correctement mise à jour.

201 Created EventSourceResource:

La source de l’événement a été créée avec succès.

Other Status Codes

CloudError

HTTP 400 (Requête incorrecte) : le corps de la demande de source d’événement donné n’est pas valide ; Pour plus d’informations, consultez le code d’erreur et le message dans la réponse.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

CreateEventHubEventSource
EventSourcesCreateEventHubWithCustomEnquedTime

CreateEventHubEventSource

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.TimeSeriesInsights/environments/env1/eventSources/es1?api-version=2020-05-15

{
  "location": "West US",
  "kind": "Microsoft.EventHub",
  "properties": {
    "eventSourceResourceId": "somePathInArm",
    "serviceBusNamespace": "sbn",
    "consumerGroupName": "cgn",
    "eventHubName": "ehn",
    "keyName": "managementKey",
    "sharedAccessKey": "someSecretvalue",
    "timestampPropertyName": "someTimestampProperty",
    "localTimestamp": {
      "format": "TimeSpan",
      "timeZoneOffset": {
        "propertyName": "someEventPropertyName"
      }
    },
    "ingressStartAt": {
      "type": "EarliestAvailable"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.TimeSeriesInsights/Environments/env1/eventSources/es1",
  "location": "West US",
  "name": "es1",
  "type": "Microsoft.TimeSeriesInsights/Environments/EventSources",
  "tags": {},
  "kind": "Microsoft.EventHub",
  "properties": {
    "eventSourceResourceId": "somePathInArm",
    "serviceBusNamespace": "sbn",
    "consumerGroupName": "cgn",
    "eventHubName": "ehn",
    "keyName": "managementKey",
    "provisioningState": "Succeeded",
    "creationTime": "2017-04-18T19:20:33.2288820Z",
    "localTimestamp": {
      "format": "TimeSpan",
      "timeZoneOffset": {
        "propertyName": "someEventPropertyName"
      }
    },
    "ingressStartAt": {
      "type": "EarliestAvailable"
    }
  }
}
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.TimeSeriesInsights/Environments/env1/eventSources/es1",
  "location": "West US",
  "name": "es1",
  "type": "Microsoft.TimeSeriesInsights/Environments/EventSources",
  "tags": {},
  "kind": "Microsoft.EventHub",
  "properties": {
    "eventSourceResourceId": "somePathInArm",
    "serviceBusNamespace": "sbn",
    "consumerGroupName": "cgn",
    "eventHubName": "ehn",
    "keyName": "managementKey",
    "provisioningState": "Succeeded",
    "creationTime": "2017-04-18T19:20:33.2288820Z",
    "localTimestamp": {
      "format": "TimeSpan",
      "timeZoneOffset": {
        "propertyName": "someEventPropertyName"
      }
    },
    "ingressStartAt": {
      "type": "EarliestAvailable"
    }
  }
}

EventSourcesCreateEventHubWithCustomEnquedTime

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.TimeSeriesInsights/environments/env1/eventSources/es1?api-version=2020-05-15

{
  "location": "West US",
  "kind": "Microsoft.EventHub",
  "properties": {
    "eventSourceResourceId": "somePathInArm",
    "serviceBusNamespace": "sbn",
    "consumerGroupName": "cgn",
    "eventHubName": "ehn",
    "keyName": "managementKey",
    "sharedAccessKey": "someSecretvalue",
    "timestampPropertyName": "someTimestampProperty",
    "ingressStartAt": {
      "type": "CustomEnqueuedTime",
      "time": "2017-04-01T19:20:33.2288820Z"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.TimeSeriesInsights/Environments/env1/eventSources/es1",
  "location": "West US",
  "name": "es1",
  "type": "Microsoft.TimeSeriesInsights/Environments/EventSources",
  "tags": {},
  "kind": "Microsoft.EventHub",
  "properties": {
    "eventSourceResourceId": "somePathInArm",
    "serviceBusNamespace": "sbn",
    "consumerGroupName": "cgn",
    "eventHubName": "ehn",
    "keyName": "managementKey",
    "provisioningState": "Succeeded",
    "creationTime": "2017-04-18T19:20:33.2288820Z",
    "ingressStartAt": {
      "type": "CustomEnqueuedTime",
      "time": "2017-04-01T19:20:33.2288820Z"
    }
  }
}
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.TimeSeriesInsights/Environments/env1/eventSources/es1",
  "location": "West US",
  "name": "es1",
  "type": "Microsoft.TimeSeriesInsights/Environments/EventSources",
  "tags": {},
  "kind": "Microsoft.EventHub",
  "properties": {
    "eventSourceResourceId": "somePathInArm",
    "serviceBusNamespace": "sbn",
    "consumerGroupName": "cgn",
    "eventHubName": "ehn",
    "keyName": "managementKey",
    "provisioningState": "Succeeded",
    "creationTime": "2017-04-18T19:20:33.2288820Z",
    "ingressStartAt": {
      "type": "CustomEnqueuedTime",
      "time": "2017-04-01T19:20:33.2288820Z"
    }
  }
}

Définitions

Nom Description
CloudError

Contient des informations sur une erreur d’API.

CloudErrorBody

Décrit une erreur d’API particulière avec un code d’erreur et un message.

EventHubEventSourceCreateOrUpdateParameters

Paramètres fournis à l’opération Créer ou mettre à jour une source d’événements pour une source d’événement EventHub.

EventHubEventSourceResource

Source d’événement qui reçoit ses données d’un EventHub Azure.

IngressStartAtType

Type de l’ingressStartAt, Il peut être « EarliestAvailable », « EventSourceCreationTime », « CustomEnqueuedTime ».

IoTHubEventSourceCreateOrUpdateParameters

Paramètres fournis à l’opération Créer ou mettre à jour une source d’événements pour une source d’événements IoTHub.

IoTHubEventSourceResource

Source d’événement qui reçoit ses données d’un Azure IoTHub.

LocalTimestamp

Objet qui représente la propriété timestamp locale. Il contient le format de l’horodatage local qui doit être utilisé et les informations de décalage de fuseau horaire correspondantes. Si aucune valeur n’est spécifiée pour localTimestamp, ou si la valeur est null, l’horodatage local n’est pas entré avec les événements.

LocalTimestampFormat

Enum qui représente le format de la propriété timestamp locale qui doit être définie.

ProvisioningState

État d’approvisionnement de la ressource.

TimeZoneOffset

Objet qui représente les informations de décalage pour le format d’horodatage local spécifié. Ne doit pas être spécifié pour LocalTimestampFormat - Embedded.

CloudError

Contient des informations sur une erreur d’API.

Nom Type Description
error

CloudErrorBody

Décrit une erreur d’API particulière avec un code d’erreur et un message.

CloudErrorBody

Décrit une erreur d’API particulière avec un code d’erreur et un message.

Nom Type Description
code

string

Code d’erreur qui décrit la condition d’erreur plus précisément qu’un code status HTTP. Peut être utilisé pour gérer par programmation des cas d’erreur spécifiques.

details

CloudErrorBody[]

Contient des erreurs imbriquées liées à cette erreur.

message

string

Message qui décrit l’erreur en détail et fournit des informations de débogage.

target

string

Cible de l’erreur particulière (par exemple, le nom de la propriété dans l’erreur).

EventHubEventSourceCreateOrUpdateParameters

Paramètres fournis à l’opération Créer ou mettre à jour une source d’événements pour une source d’événement EventHub.

Nom Type Description
creationTime

string

Heure à laquelle la ressource a été créée.

eventSourceResourceId

string

ID de ressource de la source d’événement dans Azure Resource Manager.

ingressStartAt.time

string

ISO8601 datetime UTC avec une précision en secondes (les millisecondes sont facultatives), en spécifiant la date et l’heure qui seront le point de départ des événements à consommer.

ingressStartAt.type

IngressStartAtType

Type de l’ingressStartAt, Il peut être « EarliestAvailable », « EventSourceCreationTime », « CustomEnqueuedTime ».

kind string:

Microsoft.EventHub

Type de la source de l’événement.

localTimestamp

LocalTimestamp

Objet qui représente la propriété timestamp locale. Il contient le format de l’horodatage local qui doit être utilisé et les informations de décalage de fuseau horaire correspondantes. Si aucune valeur n’est spécifiée pour localTimestamp, ou si la valeur est null, l’horodatage local n’est pas entré avec les événements.

location

string

Emplacement de la ressource.

properties.consumerGroupName

string

Nom du groupe de consommateurs du hub d’événements qui contient les partitions à partir desquelles les événements seront lus.

properties.eventHubName

string

Nom du hub d’événements.

properties.keyName

string

Nom de la clé SAS qui accorde au service Time Series Insights l’accès au hub d’événements. Les stratégies d’accès partagé pour cette clé doivent accorder des autorisations « Écouter » au hub d’événements.

properties.serviceBusNamespace

string

Nom du service bus qui contient le hub d’événements.

properties.sharedAccessKey

string

Valeur de la clé d’accès partagé qui accorde au service Time Series Insights un accès en lecture au hub d’événements. Cette propriété n’est pas affichée dans les réponses à la source d’événement.

provisioningState

ProvisioningState

État d’approvisionnement de la ressource.

tags

object

Paires clé-valeur de propriétés supplémentaires pour la ressource.

timestampPropertyName

string

Propriété de l’événement qui sera utilisée comme horodateur de la source de l’événement. Si aucune valeur n’est spécifiée pour timestampPropertyName, ou si la valeur Null ou une chaîne vide est spécifiée, l’heure de création de l’événement sera utilisée.

EventHubEventSourceResource

Source d’événement qui reçoit ses données d’un EventHub Azure.

Nom Type Description
creationTime

string

Heure à laquelle la ressource a été créée.

eventSourceResourceId

string

ID de ressource de la source d’événement dans Azure Resource Manager.

id

string

ID de ressource

ingressStartAt.time

string

ISO8601 datetime UTC avec une précision en secondes (les millisecondes sont facultatives), en spécifiant la date et l’heure qui seront le point de départ des événements à consommer.

ingressStartAt.type

IngressStartAtType

Type de l’ingressStartAt, Il peut être « EarliestAvailable », « EventSourceCreationTime », « CustomEnqueuedTime ».

kind string:

Microsoft.EventHub

Type de la source de l’événement.

localTimestamp

LocalTimestamp

Objet qui représente la propriété timestamp locale. Il contient le format de l’horodatage local qui doit être utilisé et les informations de décalage de fuseau horaire correspondantes. Si aucune valeur n’est spécifiée pour localTimestamp, ou si la valeur est null, l’horodatage local n’est pas entré avec les événements.

location

string

Emplacement de la ressource

name

string

Nom de la ressource

properties.consumerGroupName

string

Nom du groupe de consommateurs du hub d’événements qui contient les partitions à partir desquelles les événements seront lus.

properties.eventHubName

string

Nom du hub d’événements.

properties.keyName

string

Nom de la clé SAS qui accorde au service Time Series Insights l’accès au hub d’événements. Les stratégies d’accès partagé pour cette clé doivent accorder des autorisations « Écouter » au hub d’événements.

properties.serviceBusNamespace

string

Nom du service bus qui contient le hub d’événements.

provisioningState

ProvisioningState

État d’approvisionnement de la ressource.

tags

object

Balises de ressource

timestampPropertyName

string

Propriété de l’événement qui sera utilisée comme horodateur de la source de l’événement. Si aucune valeur n’est spécifiée pour timestampPropertyName, ou si la valeur Null ou une chaîne vide est spécifiée, l’heure de création de l’événement sera utilisée.

type

string

Type de ressource

IngressStartAtType

Type de l’ingressStartAt, Il peut être « EarliestAvailable », « EventSourceCreationTime », « CustomEnqueuedTime ».

Nom Type Description
CustomEnqueuedTime

string

EarliestAvailable

string

EventSourceCreationTime

string

IoTHubEventSourceCreateOrUpdateParameters

Paramètres fournis à l’opération Créer ou mettre à jour une source d’événements pour une source d’événements IoTHub.

Nom Type Description
creationTime

string

Heure à laquelle la ressource a été créée.

eventSourceResourceId

string

ID de ressource de la source d’événement dans Azure Resource Manager.

ingressStartAt.time

string

ISO8601 datetime UTC avec une précision en secondes (les millisecondes sont facultatives), en spécifiant la date et l’heure qui seront le point de départ des événements à consommer.

ingressStartAt.type

IngressStartAtType

Type de l’ingressStartAt, Il peut être « EarliestAvailable », « EventSourceCreationTime », « CustomEnqueuedTime ».

kind string:

Microsoft.IoTHub

Type de la source de l’événement.

localTimestamp

LocalTimestamp

Objet qui représente la propriété timestamp locale. Il contient le format de l’horodatage local qui doit être utilisé et les informations de décalage de fuseau horaire correspondantes. Si aucune valeur n’est spécifiée pour localTimestamp, ou si la valeur est null, l’horodatage local n’est pas entré avec les événements.

location

string

Emplacement de la ressource.

properties.consumerGroupName

string

Nom du groupe de consommateurs du hub iot qui contient les partitions à partir desquelles les événements seront lus.

properties.iotHubName

string

Nom du hub iot.

properties.keyName

string

Nom de la clé de stratégie d’accès partagé qui accorde au service Time Series Insights l’accès au hub iot. Cette clé de stratégie d’accès partagé doit accorder des autorisations de connexion de service au hub iot.

properties.sharedAccessKey

string

Valeur de la clé de stratégie d’accès partagé qui accorde au service Time Series Insights un accès en lecture au hub iot. Cette propriété n’est pas affichée dans les réponses à la source d’événement.

provisioningState

ProvisioningState

État d’approvisionnement de la ressource.

tags

object

Paires clé-valeur de propriétés supplémentaires pour la ressource.

timestampPropertyName

string

Propriété de l’événement qui sera utilisée comme horodateur de la source de l’événement. Si aucune valeur n’est spécifiée pour timestampPropertyName, ou si la valeur Null ou une chaîne vide est spécifiée, l’heure de création de l’événement sera utilisée.

IoTHubEventSourceResource

Source d’événement qui reçoit ses données d’un Azure IoTHub.

Nom Type Description
creationTime

string

Heure à laquelle la ressource a été créée.

eventSourceResourceId

string

ID de ressource de la source d’événement dans Azure Resource Manager.

id

string

ID de ressource

ingressStartAt.time

string

ISO8601 datetime UTC avec une précision en secondes (les millisecondes sont facultatives), en spécifiant la date et l’heure qui seront le point de départ des événements à consommer.

ingressStartAt.type

IngressStartAtType

Type de l’ingressStartAt, Il peut être « EarliestAvailable », « EventSourceCreationTime », « CustomEnqueuedTime ».

kind string:

Microsoft.IoTHub

Type de la source de l’événement.

localTimestamp

LocalTimestamp

Objet qui représente la propriété timestamp locale. Il contient le format de l’horodatage local qui doit être utilisé et les informations de décalage de fuseau horaire correspondantes. Si aucune valeur n’est spécifiée pour localTimestamp, ou si la valeur est null, l’horodatage local n’est pas entré avec les événements.

location

string

Emplacement de la ressource

name

string

Nom de la ressource

properties.consumerGroupName

string

Nom du groupe de consommateurs du hub iot qui contient les partitions à partir desquelles les événements seront lus.

properties.iotHubName

string

Nom du hub iot.

properties.keyName

string

Nom de la clé de stratégie d’accès partagé qui accorde au service Time Series Insights l’accès au hub iot. Cette clé de stratégie d’accès partagé doit accorder des autorisations de connexion de service au hub iot.

provisioningState

ProvisioningState

État d’approvisionnement de la ressource.

tags

object

Balises de ressource

timestampPropertyName

string

Propriété de l’événement qui sera utilisée comme horodateur de la source de l’événement. Si aucune valeur n’est spécifiée pour timestampPropertyName, ou si la valeur Null ou une chaîne vide est spécifiée, l’heure de création de l’événement sera utilisée.

type

string

Type de ressource

LocalTimestamp

Objet qui représente la propriété timestamp locale. Il contient le format de l’horodatage local qui doit être utilisé et les informations de décalage de fuseau horaire correspondantes. Si aucune valeur n’est spécifiée pour localTimestamp, ou si la valeur est null, l’horodatage local n’est pas entré avec les événements.

Nom Type Description
format

LocalTimestampFormat

Enum qui représente le format de la propriété timestamp locale qui doit être définie.

timeZoneOffset

TimeZoneOffset

Objet qui représente les informations de décalage pour le format d’horodatage local spécifié. Ne doit pas être spécifié pour LocalTimestampFormat - Embedded.

LocalTimestampFormat

Enum qui représente le format de la propriété timestamp locale qui doit être définie.

Nom Type Description
Embedded

string

ProvisioningState

État d’approvisionnement de la ressource.

Nom Type Description
Accepted

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

TimeZoneOffset

Objet qui représente les informations de décalage pour le format d’horodatage local spécifié. Ne doit pas être spécifié pour LocalTimestampFormat - Embedded.

Nom Type Description
propertyName

string

Propriété d’événement qui contiendra les informations de décalage pour calculer l’horodatage local. Lorsque localTimestampFormat est Iana, le nom de la propriété contient le nom de la colonne qui contient le nom du fuseau horaire IANA (par exemple, Americas/Los Angeles). Lorsque LocalTimestampFormat est Timespan, il contient le nom de la propriété qui contient des valeurs représentant le décalage (par exemple : P1D ou 1.00 :00 :00)