你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Reference Data Sets - Create Or Update

在指定环境中创建或更新引用数据集。

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

URI 参数

Name In Required Type Description
environmentName
path True
  • string

与指定资源组关联的时序Insights环境的名称。

referenceDataSetName
path True
  • string

引用数据集的名称。

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

resourceGroupName
path True
  • string

Azure 资源组的名称。

subscriptionId
path True
  • string

Azure 订阅 ID。

api-version
query True
  • string

要与客户端请求一起使用的 API 版本。

请求正文

Name Required Type Description
location True
  • string

资源的位置。

properties.keyProperties True

引用数据集的键属性列表。

properties.dataStringComparisonBehavior

可以使用此属性设置引用数据集键比较行为。 默认情况下,该值为“Ordinal”,这意味着在将引用数据与事件联接或添加新引用数据时,将执行区分大小写的键比较。 设置“OrdinalIgnoreCase”时,将使用不区分大小写的比较。

tags
  • object

资源的附加属性的键值对。

响应

Name Type Description
200 OK

已成功更新现有的引用数据集定义。

201 Created

已成功创建引用数据集。

Other Status Codes

HTTP 400 (错误请求) :给定的引用数据集请求正文无效;有关详细信息,请参阅响应中的错误代码和消息。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation 模拟用户帐户

示例

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

定义

CloudError

包含有关 API 错误的信息。

CloudErrorBody

描述具有错误代码和消息的特定 API 错误。

DataStringComparisonBehavior

可以使用此属性设置引用数据集键比较行为。 默认情况下,该值为“Ordinal”,这意味着在将引用数据与事件联接或添加新引用数据时,将执行区分大小写的键比较。 设置“OrdinalIgnoreCase”时,将使用不区分大小写的比较。

ProvisioningState

资源预配状态。

ReferenceDataKeyPropertyType

键属性的类型。

ReferenceDataSetCreateOrUpdateParameters
ReferenceDataSetKeyProperty

引用数据集的键属性。 引用数据集可以具有多个键属性。

ReferenceDataSetResource

引用数据集提供有关环境中事件的元数据。 引用数据集中的元数据将与事件联接,因为它们是从事件源中读取的。 组成引用数据集的元数据通过时序Insights数据平面 API 上传或修改。

CloudError

包含有关 API 错误的信息。

Name Type Description
error

描述具有错误代码和消息的特定 API 错误。

CloudErrorBody

描述具有错误代码和消息的特定 API 错误。

Name Type Description
code
  • string

描述错误条件的错误代码比 HTTP 状态代码更精确。 可用于以编程方式处理特定错误案例。

details

包含与此错误相关的嵌套错误。

message
  • string

描述错误的详细信息并提供调试信息的消息。

target
  • string

例如,特定错误的目标 (错误) 属性的名称。

DataStringComparisonBehavior

可以使用此属性设置引用数据集键比较行为。 默认情况下,该值为“Ordinal”,这意味着在将引用数据与事件联接或添加新引用数据时,将执行区分大小写的键比较。 设置“OrdinalIgnoreCase”时,将使用不区分大小写的比较。

Name Type Description
Ordinal
  • string
OrdinalIgnoreCase
  • string

ProvisioningState

资源预配状态。

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

ReferenceDataKeyPropertyType

键属性的类型。

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

ReferenceDataSetCreateOrUpdateParameters

Name Type Description
location
  • string

资源的位置。

properties.dataStringComparisonBehavior

可以使用此属性设置引用数据集键比较行为。 默认情况下,该值为“Ordinal”,这意味着在将引用数据与事件联接或添加新引用数据时,将执行区分大小写的键比较。 设置“OrdinalIgnoreCase”时,将使用不区分大小写的比较。

properties.keyProperties

引用数据集的键属性列表。

tags
  • object

资源的附加属性的键值对。

ReferenceDataSetKeyProperty

引用数据集的键属性。 引用数据集可以具有多个键属性。

Name Type Description
name
  • string

键属性的名称。

type

键属性的类型。

ReferenceDataSetResource

引用数据集提供有关环境中事件的元数据。 引用数据集中的元数据将与事件联接,因为它们是从事件源中读取的。 组成引用数据集的元数据通过时序Insights数据平面 API 上传或修改。

Name Type Description
id
  • string

资源 ID

location
  • string

资源位置

name
  • string

资源名称

properties.creationTime
  • string

创建资源的时间。

properties.dataStringComparisonBehavior

可以使用此属性设置引用数据集键比较行为。 默认情况下,该值为“Ordinal”,这意味着在将引用数据与事件联接或添加新引用数据时,将执行区分大小写的键比较。 设置“OrdinalIgnoreCase”时,将使用不区分大小写的比较。

properties.keyProperties

引用数据集的键属性列表。

properties.provisioningState

资源预配状态。

tags
  • object

资源标记

type
  • string

资源类型