Reference Data Sets - Create Or Update

Vytvoří nebo aktualizuje referenční datovou sadu v zadaném prostředí.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TimeSeriesInsights/environments/{environmentName}/referenceDataSets/{referenceDataSetName}?api-version=2018-08-15-preview

Parametry identifikátoru URI

Name In Required Type Description
environmentName
path True
  • string

Název prostředí Time Series Insights přidruženého k zadané skupině prostředků

referenceDataSetName
path True
  • string

Název referenční sady dat

Regex pattern: ^[A-Za-z0-9]

resourceGroupName
path True
  • string

Název skupiny prostředků Azure.

subscriptionId
path True
  • string

ID předplatného Azure.

api-version
query True
  • string

Verze rozhraní API, která se má použít s požadavkem klienta

Text požadavku

Name Required Type Description
location True
  • string

Umístění prostředku.

properties.keyProperties True

Seznam vlastností klíče pro referenční datovou sadu.

properties.dataStringComparisonBehavior

Pomocí této vlastnosti lze nastavit chování porovnání klíčů referenční datové sady. Ve výchozím nastavení je tato hodnota "ordinální" – což znamená, že se při spojování referenčních dat s událostmi nebo při přidávání nových referenčních dat provede porovnávání klíčů s rozlišováním velkých a malých písmen. Když je nastavená možnost OrdinalIgnoreCase, použije se porovnávání bez rozlišení velkých a malých písmen.

tags
  • object

Páry klíč-hodnota dalších vlastností prostředku.

Odpovědi

Name Type Description
200 OK

Existující definice referenční sady dat se úspěšně aktualizovala.

201 Created

Referenční sada dat se úspěšně vytvořila.

Other Status Codes

HTTP 400 (chybný požadavek): daný text požadavku na referenční datovou sadu je neplatný. Podrobnosti najdete v kódu chyby a zprávě v odpovědi.

Zabezpečení

azure_auth

Azure Active Directory tok OAuth2

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

Scopes

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

ReferenceDataSetsCreate

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.TimeSeriesInsights/environments/env1/referenceDataSets/rds1?api-version=2018-08-15-preview
{
  "location": "West US",
  "properties": {
    "keyProperties": [
      {
        "name": "DeviceId1",
        "type": "String"
      },
      {
        "name": "DeviceFloor",
        "type": "Double"
      }
    ]
  }
}

Sample Response

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.TimeSeriesInsights/Environments/env1/referenceDataSets/rds1",
  "location": "West US",
  "name": "rds1",
  "type": "Microsoft.TimeSeriesInsights/Environments/ReferenceDataSets",
  "tags": {},
  "properties": {
    "keyProperties": [
      {
        "name": "DeviceId1",
        "type": "String"
      },
      {
        "name": "DeviceFloor",
        "type": "Double"
      }
    ],
    "provisioningState": "Succeeded",
    "creationTime": "2017-04-18T19:20:33.2288820Z"
  }
}
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.TimeSeriesInsights/Environments/env1/referenceDataSets/rds1",
  "location": "West US",
  "name": "rds1",
  "type": "Microsoft.TimeSeriesInsights/Environments/ReferenceDataSets",
  "tags": {},
  "properties": {
    "keyProperties": [
      {
        "name": "DeviceId1",
        "type": "String"
      },
      {
        "name": "DeviceFloor",
        "type": "Double"
      }
    ],
    "provisioningState": "Succeeded",
    "creationTime": "2017-04-18T19:20:33.2288820Z"
  }
}

Definice

CloudError

Obsahuje informace o chybě rozhraní API.

CloudErrorBody

Popisuje konkrétní chybu rozhraní API s kódem chyby a zprávou.

DataStringComparisonBehavior

Pomocí této vlastnosti lze nastavit chování porovnání klíčů referenční datové sady. Ve výchozím nastavení je tato hodnota "ordinální" – což znamená, že se při spojování referenčních dat s událostmi nebo při přidávání nových referenčních dat provede porovnávání klíčů s rozlišováním velkých a malých písmen. Když je nastavená možnost OrdinalIgnoreCase, použije se porovnávání bez rozlišení velkých a malých písmen.

ProvisioningState

Stav zřizování prostředku.

ReferenceDataKeyPropertyType

Typ klíčové vlastnosti

ReferenceDataSetCreateOrUpdateParameters
ReferenceDataSetKeyProperty

Klíčová vlastnost pro referenční datovou sadu. Referenční sada dat může mít více klíčových vlastností.

ReferenceDataSetResource

Referenční sada dat poskytuje metadata o událostech v prostředí. Metadata v referenční sadě dat budou spojena s událostmi, když jsou čtena ze zdrojů událostí. Metadata, která tvoří referenční datovou sadu, se nahrají nebo upraví prostřednictvím rozhraní API roviny dat Time Series Insights.

CloudError

Obsahuje informace o chybě rozhraní API.

Name Type Description
error

Popisuje konkrétní chybu rozhraní API s kódem chyby a zprávou.

CloudErrorBody

Popisuje konkrétní chybu rozhraní API s kódem chyby a zprávou.

Name Type Description
code
  • string

Kód chyby, který popisuje chybovou podmínku přesněji než stavový kód HTTP. Dá se použít k programovému zpracování konkrétních chybových případů.

details

Obsahuje vnořené chyby související s touto chybou.

message
  • string

Zpráva, která podrobně popisuje chybu a poskytuje informace o ladění.

target
  • string

Cíl konkrétní chyby (například název vlastnosti v chybě).

DataStringComparisonBehavior

Pomocí této vlastnosti lze nastavit chování porovnání klíčů referenční datové sady. Ve výchozím nastavení je tato hodnota "ordinální" – což znamená, že se při spojování referenčních dat s událostmi nebo při přidávání nových referenčních dat provede porovnávání klíčů s rozlišováním velkých a malých písmen. Když je nastavená možnost OrdinalIgnoreCase, použije se porovnávání bez rozlišení velkých a malých písmen.

Name Type Description
Ordinal
  • string
OrdinalIgnoreCase
  • string

ProvisioningState

Stav zřizování prostředku.

Name Type Description
Accepted
  • string
Creating
  • string
Deleting
  • string
Failed
  • string
Succeeded
  • string
Updating
  • string

ReferenceDataKeyPropertyType

Typ klíčové vlastnosti

Name Type Description
Bool
  • string
DateTime
  • string
Double
  • string
String
  • string

ReferenceDataSetCreateOrUpdateParameters

Name Type Description
location
  • string

Umístění prostředku.

properties.dataStringComparisonBehavior

Pomocí této vlastnosti lze nastavit chování porovnání klíčů referenční datové sady. Ve výchozím nastavení je tato hodnota "ordinální" – což znamená, že se při spojování referenčních dat s událostmi nebo při přidávání nových referenčních dat provede porovnávání klíčů s rozlišováním velkých a malých písmen. Když je nastavená možnost OrdinalIgnoreCase, použije se porovnávání bez rozlišení velkých a malých písmen.

properties.keyProperties

Seznam vlastností klíče pro referenční datovou sadu.

tags
  • object

Páry klíč-hodnota dalších vlastností prostředku.

ReferenceDataSetKeyProperty

Klíčová vlastnost pro referenční datovou sadu. Referenční sada dat může mít více klíčových vlastností.

Name Type Description
name
  • string

Název klíčové vlastnosti

type

Typ klíčové vlastnosti

ReferenceDataSetResource

Referenční sada dat poskytuje metadata o událostech v prostředí. Metadata v referenční sadě dat budou spojena s událostmi, když jsou čtena ze zdrojů událostí. Metadata, která tvoří referenční datovou sadu, se nahrají nebo upraví prostřednictvím rozhraní API roviny dat Time Series Insights.

Name Type Description
id
  • string

ID prostředku

location
  • string

Umístění prostředku

name
  • string

Název prostředku

properties.creationTime
  • string

Čas, kdy byl prostředek vytvořen.

properties.dataStringComparisonBehavior

Pomocí této vlastnosti lze nastavit chování porovnání klíčů referenční datové sady. Ve výchozím nastavení je tato hodnota "ordinální" – což znamená, že se při spojování referenčních dat s událostmi nebo při přidávání nových referenčních dat provede porovnávání klíčů s rozlišováním velkých a malých písmen. Když je nastavená možnost OrdinalIgnoreCase, použije se porovnávání bez rozlišení velkých a malých písmen.

properties.keyProperties

Seznam vlastností klíče pro referenční datovou sadu.

properties.provisioningState

Stav zřizování prostředku.

tags
  • object

Značky prostředků

type
  • string

Typ prostředku