Model Settings - Get
Возвращает параметры модели, включающие отображаемое имя модели, свойства идентификатора временных рядов и идентификатор типа по умолчанию. Каждая среда 2-го поколения имеет модель, которая создается автоматически.
GET https://{environmentFqdn}/timeseries/modelSettings?api-version=2020-07-31
Параметры URI
| Name | In | Required | Type | Description |
|---|---|---|---|---|
|
environment
|
path | True |
|
Полное доменное имя среды, например 10000000-0000-0000-0000-100000000109.env.timeseries.azure.com. Это доменное имя можно получить из ответа API get Environments, портал Azure или Azure Resource Manager. |
|
api-version
|
query | True |
|
Версия API, используемая с клиентским запросом. В настоящее время поддерживается версия 2020-07-31. |
Заголовок запроса
| Name | Required | Type | Description |
|---|---|---|---|
| x-ms-client-request-id |
|
Необязательный идентификатор запроса клиента. Служба записывает это значение. Позволяет службе отслеживать операции между службами и позволяет клиенту обращаться в службу поддержки в отношении конкретного запроса. |
|
| x-ms-client-session-id |
|
Необязательный идентификатор сеанса клиента. Служба записывает это значение. Позволяет службе отслеживать группу связанных операций между службами и позволяет клиенту обращаться в службу поддержки в отношении определенной группы запросов. |
Ответы
| Name | Type | Description |
|---|---|---|
| 200 OK |
Успешная операция. Headers
|
|
| Other Status Codes |
Непредвиденная ошибка. Headers
|
Безопасность
azure_auth
Flow OAuth2 Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
| Name | Description |
|---|---|
| user_impersonation | олицетворения учетной записи пользователя |
Примеры
ModelSettingsGet
Sample Request
GET https://10000000-0000-0000-0000-100000000109.env.timeseries.azure.com/timeseries/modelSettings?api-version=2020-07-31
Sample Response
{
"modelSettings": {
"name": "DefaultModel",
"timeSeriesIdProperties": [
{
"name": "DeviceId",
"type": "String"
}
],
"defaultTypeId": "5AB70D71-A8CD-410E-B70D-6F04AB9C132C"
}
}
Определения
|
Model |
Ответ, содержащий параметры модели полных временных рядов, включая имя модели, свойства идентификатора временных рядов и идентификатор типа по умолчанию. |
|
Time |
Определение одного свойства, которое может использоваться в свойствах идентификатора временных рядов, определенных во время создания среды. |
|
Time |
Тип свойства. В настоящее время поддерживается только строка. |
|
Time |
Параметры модели временных рядов, включая имя модели, свойства идентификатора временных рядов и идентификатор типа по умолчанию. |
|
Tsi |
Сведения об ошибке API. |
|
Tsi |
Конкретная ошибка API с кодом ошибки и сообщением. |
|
Tsi |
Дополнительные сведения об ошибке. |
ModelSettingsResponse
Ответ, содержащий параметры модели полных временных рядов, включая имя модели, свойства идентификатора временных рядов и идентификатор типа по умолчанию.
| Name | Type | Description |
|---|---|---|
| modelSettings |
Параметры модели, включая имя модели, свойства идентификатора временных рядов и идентификатор типа по умолчанию. |
TimeSeriesIdProperty
Определение одного свойства, которое может использоваться в свойствах идентификатора временных рядов, определенных во время создания среды.
| Name | Type | Description |
|---|---|---|
| name |
|
Имя свойства. |
| type |
Тип свойства. В настоящее время поддерживается только строка. |
TimeSeriesIdPropertyTypes
Тип свойства. В настоящее время поддерживается только строка.
| Name | Type | Description |
|---|---|---|
| String |
|
TimeSeriesModelSettings
Параметры модели временных рядов, включая имя модели, свойства идентификатора временных рядов и идентификатор типа по умолчанию.
| Name | Type | Description |
|---|---|---|
| defaultTypeId |
|
Идентификатор типа по умолчанию модели, к которой автоматически принадлежат новые экземпляры временных рядов. |
| name |
|
Отображаемое имя модели временных рядов, отображаемое в пользовательском интерфейсе. Примеры: "Датчики температуры", "MyDevices". |
| timeSeriesIdProperties |
Свойства идентификатора временных рядов, определенные во время создания среды. |
TsiError
Сведения об ошибке API.
| Name | Type | Description |
|---|---|---|
| error |
Конкретная ошибка API с кодом ошибки и сообщением. |
TsiErrorBody
Конкретная ошибка API с кодом ошибки и сообщением.
| Name | Type | Description |
|---|---|---|
| code |
|
Независимая от языка строка, читаемая человеком, которая определяет код ошибки, относящуюся к конкретной службе. Этот код служит более конкретным индикатором для кода ошибки HTTP, указанного в ответе. Можно использовать для программной обработки конкретных случаев ошибок. |
| details |
Содержит дополнительные сведения об ошибке. Может принимать значение NULL. |
|
| innerError |
Содержит более конкретную ошибку, которая сужает причину. Может принимать значение NULL. |
|
| message |
|
Удобочитаемое, независимое от языка представление ошибки. Она предназначена для разработчиков и не подходит для воздействия на конечных пользователей. |
| target |
|
Целевой объект конкретной ошибки (например, имя свойства в ошибке). Может принимать значение NULL. |
TsiErrorDetails
Дополнительные сведения об ошибке.
| Name | Type | Description |
|---|---|---|
| code |
|
Независимая от языка строка, читаемая человеком, которая определяет код ошибки, относящуюся к конкретной службе. Этот код служит более конкретным индикатором для кода ошибки HTTP, указанного в ответе. Можно использовать для программной обработки конкретных случаев ошибок. |
| message |
|
Удобочитаемое, независимое от языка представление ошибки. Она предназначена для разработчиков и не подходит для воздействия на конечных пользователей. |