Reference Data Sets - Create Or Update

Hozzon létre vagy frissítsen egy hivatkozási adatkészletet a megadott környezetben.

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

URI-paraméterek

Name In Required Type Description
environmentName
path True
  • string

A megadott erőforráscsoporthoz társított Time Series Insights környezet neve.

referenceDataSetName
path True
  • string

A hivatkozási adathalmaz neve.

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

resourceGroupName
path True
  • string

Egy Azure-erőforráscsoport neve.

subscriptionId
path True
  • string

Azure-előfizetés azonosítója.

api-version
query True
  • string

Az ügyfél-kérelemmel használandó API verziója.

Kérelem törzse

Name Required Type Description
location True
  • string

Az erőforrás helye.

properties.dataStringComparisonBehavior

A hivatkozási adatkészlet kulcsának összehasonlító viselkedése a tulajdonság használatával állítható be. Alapértelmezés szerint az érték "sorszám" – Ez azt jelenti, hogy a kis-és nagybetűket megkülönböztető kulcs összehasonlítására kerül sor, miközben az eseményekkel vagy új hivatkozási adatok hozzáadásával csatlakozik a hivatkozáshoz. Ha a "OrdinalIgnoreCase" be van állítva, a rendszer a kis-és nagybetűk megkülönböztetésének összehasonlítását fogja használni.

properties.keyProperties True

A hivatkozási adatkészlethez tartozó főbb tulajdonságok listája.

tags
  • object

Az erőforráshoz tartozó további tulajdonságok kulcs-érték párok.

Válaszok

Name Type Description
200 OK

A meglévő hivatkozási adathalmaz definíciójának frissítése sikeresen megtörtént.

201 Created

A hivatkozási adathalmaz létrehozása sikeresen megtörtént.

Other Status Codes

HTTP 400 (hibás kérelem): a megadott hivatkozási adathalmaz-kérelem törzse érvénytelen; A részletekért tekintse meg a hibakódot és az üzenetet a válaszban.

Biztonság

azure_auth

Azure Active Directory OAuth2 folyamat

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

Scopes

Name Description
user_impersonation felhasználói fiók megszemélyesítése

Példák

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"
  }
}

Definíciók

CloudError

API-hibával kapcsolatos információkat tartalmaz.

CloudErrorBody

Egy adott API-hibát ismertet egy hibakódtal és egy üzenettel.

DataStringComparisonBehavior

A hivatkozási adatkészlet kulcsának összehasonlító viselkedése a tulajdonság használatával állítható be. Alapértelmezés szerint az érték "sorszám" – Ez azt jelenti, hogy a kis-és nagybetűket megkülönböztető kulcs összehasonlítására kerül sor, miközben az eseményekkel vagy új hivatkozási adatok hozzáadásával csatlakozik a hivatkozáshoz. Ha a "OrdinalIgnoreCase" be van állítva, a rendszer a kis-és nagybetűk megkülönböztetésének összehasonlítását fogja használni.

ProvisioningState

Az erőforrás kiépítési állapota.

ReferenceDataKeyPropertyType

A Key tulajdonság típusa

ReferenceDataSetCreateOrUpdateParameters
ReferenceDataSetKeyProperty

A hivatkozási adatkészlethez tartozó Key tulajdonság. Egy hivatkozási adathalmaz több kulcs tulajdonsággal is rendelkezhet.

ReferenceDataSetResource

A hivatkozási adatkészletek metaadatokat biztosítanak egy adott környezetben lévő eseményekről. A rendszer a hivatkozási adatkészletben lévő metaadatokat az esemény forrásaiból beolvasott eseményekhez fogja csatlakoztatni. A rendszer a hivatkozási adatkészletet alkotó metaadatokat a Time Series Insights adatsík API-kkal feltölti vagy módosítja.

CloudError

API-hibával kapcsolatos információkat tartalmaz.

Name Type Description
error

Egy adott API-hibát ismertet egy hibakódtal és egy üzenettel.

CloudErrorBody

Egy adott API-hibát ismertet egy hibakódtal és egy üzenettel.

Name Type Description
code
  • string

Egy hibakód, amely a hiba feltételét pontosabban leírja, mint egy HTTP-állapotkód. Felhasználható adott hibák programozott kezelésére is.

details

A hibához kapcsolódó beágyazott hibákat tartalmaz.

message
  • string

Egy üzenet, amely részletesen leírja a hibát, és hibakeresési információkat biztosít.

target
  • string

Az adott hiba célja (például a tulajdonság neve, hiba).

DataStringComparisonBehavior

A hivatkozási adatkészlet kulcsának összehasonlító viselkedése a tulajdonság használatával állítható be. Alapértelmezés szerint az érték "sorszám" – Ez azt jelenti, hogy a kis-és nagybetűket megkülönböztető kulcs összehasonlítására kerül sor, miközben az eseményekkel vagy új hivatkozási adatok hozzáadásával csatlakozik a hivatkozáshoz. Ha a "OrdinalIgnoreCase" be van állítva, a rendszer a kis-és nagybetűk megkülönböztetésének összehasonlítását fogja használni.

Name Type Description
Ordinal
  • string
OrdinalIgnoreCase
  • string

ProvisioningState

Az erőforrás kiépítési állapota.

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

ReferenceDataKeyPropertyType

A Key tulajdonság típusa

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

ReferenceDataSetCreateOrUpdateParameters

Name Type Description
location
  • string

Az erőforrás helye.

properties.dataStringComparisonBehavior

A hivatkozási adatkészlet kulcsának összehasonlító viselkedése a tulajdonság használatával állítható be. Alapértelmezés szerint az érték "sorszám" – Ez azt jelenti, hogy a kis-és nagybetűket megkülönböztető kulcs összehasonlítására kerül sor, miközben az eseményekkel vagy új hivatkozási adatok hozzáadásával csatlakozik a hivatkozáshoz. Ha a "OrdinalIgnoreCase" be van állítva, a rendszer a kis-és nagybetűk megkülönböztetésének összehasonlítását fogja használni.

properties.keyProperties

A hivatkozási adatkészlethez tartozó főbb tulajdonságok listája.

tags
  • object

Az erőforráshoz tartozó további tulajdonságok kulcs-érték párok.

ReferenceDataSetKeyProperty

A hivatkozási adatkészlethez tartozó Key tulajdonság. Egy hivatkozási adathalmaz több kulcs tulajdonsággal is rendelkezhet.

Name Type Description
name
  • string

A Key tulajdonság neve

type

A Key tulajdonság típusa

ReferenceDataSetResource

A hivatkozási adatkészletek metaadatokat biztosítanak egy adott környezetben lévő eseményekről. A rendszer a hivatkozási adatkészletben lévő metaadatokat az esemény forrásaiból beolvasott eseményekhez fogja csatlakoztatni. A rendszer a hivatkozási adatkészletet alkotó metaadatokat a Time Series Insights adatsík API-kkal feltölti vagy módosítja.

Name Type Description
id
  • string

Erőforrás-azonosító

location
  • string

Erőforrás helye

name
  • string

Erőforrás neve

properties.creationTime
  • string

Az erőforrás létrehozásának ideje.

properties.dataStringComparisonBehavior

A hivatkozási adatkészlet kulcsának összehasonlító viselkedése a tulajdonság használatával állítható be. Alapértelmezés szerint az érték "sorszám" – Ez azt jelenti, hogy a kis-és nagybetűket megkülönböztető kulcs összehasonlítására kerül sor, miközben az eseményekkel vagy új hivatkozási adatok hozzáadásával csatlakozik a hivatkozáshoz. Ha a "OrdinalIgnoreCase" be van állítva, a rendszer a kis-és nagybetűk megkülönböztetésének összehasonlítását fogja használni.

properties.keyProperties

A hivatkozási adatkészlethez tartozó főbb tulajdonságok listája.

properties.provisioningState

Az erőforrás kiépítési állapota.

tags
  • object

Erőforráscímkék

type
  • string

Erőforrás típusa