Model Settings - Get

Returns the model settings which includes model display name, Time Series ID properties and default type ID. Every Gen2 environment has a model that is automatically created.

GET https://{environmentFqdn}/timeseries/modelSettings?api-version=2020-07-31

URI Parameters

Name In Required Type Description
environmentFqdn
path True

string

Per environment FQDN, for example 10000000-0000-0000-0000-100000000109.env.timeseries.azure.com. You can obtain this domain name from the response of the Get Environments API, Azure portal, or Azure Resource Manager.

api-version
query True

string

Version of the API to be used with the client request. Currently supported version is "2020-07-31".

Request Header

Name Required Type Description
x-ms-client-request-id

string

Optional client request ID. Service records this value. Allows the service to trace operation across services, and allows the customer to contact support regarding a particular request.

x-ms-client-session-id

string

Optional client session ID. Service records this value. Allows the service to trace a group of related operations across services, and allows the customer to contact support regarding a particular group of requests.

Responses

Name Type Description
200 OK

ModelSettingsResponse

Successful operation.

Headers

x-ms-request-id: string

Other Status Codes

TsiError

Unexpected error.

Headers

x-ms-request-id: string

Security

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 impersonate your user account

Examples

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

Definitions

Name Description
ModelSettingsResponse

Response containing full time series model settings which include model name, Time Series ID properties and default type ID.

TimeSeriesIdProperty

A definition of a single property that can be used in time series ID properties defined during environment creation.

TimeSeriesIdPropertyTypes

The type of the property. Currently, only "String" is supported.

TimeSeriesModelSettings

Time series model settings including model name, Time Series ID properties and default type ID.

TsiError

Information about an API error.

TsiErrorBody

A particular API error with an error code and a message.

TsiErrorDetails

Additional error information.

ModelSettingsResponse

Response containing full time series model settings which include model name, Time Series ID properties and default type ID.

Name Type Description
modelSettings

TimeSeriesModelSettings

Model settings including model name, Time Series ID properties and default type ID.

TimeSeriesIdProperty

A definition of a single property that can be used in time series ID properties defined during environment creation.

Name Type Description
name

string

The name of the property.

type

TimeSeriesIdPropertyTypes

The type of the property. Currently, only "String" is supported.

TimeSeriesIdPropertyTypes

The type of the property. Currently, only "String" is supported.

Name Type Description
String

string

TimeSeriesModelSettings

Time series model settings including model name, Time Series ID properties and default type ID.

Name Type Description
defaultTypeId

string

Default type ID of the model that new time series instances will automatically belong to.

name

string

Time series model display name which is shown in the UX. Examples: "Temperature Sensors", "MyDevices".

timeSeriesIdProperties

TimeSeriesIdProperty[]

Time series ID properties defined during environment creation.

TsiError

Information about an API error.

Name Type Description
error

TsiErrorBody

A particular API error with an error code and a message.

TsiErrorBody

A particular API error with an error code and a message.

Name Type Description
code

string

Language-independent, human-readable string that defines a service-specific error code. This code serves as a more specific indicator for the HTTP error code specified in the response. Can be used to programmatically handle specific error cases.

details

TsiErrorDetails[]

Contains additional error information. May be null.

innerError

TsiErrorBody

Contains more specific error that narrows down the cause. May be null.

message

string

Human-readable, language-independent representation of the error. It is intended as an aid to developers and is not suitable for exposure to end users.

target

string

Target of the particular error (for example, the name of the property in error). May be null.

TsiErrorDetails

Additional error information.

Name Type Description
code

string

Language-independent, human-readable string that defines a service-specific error code. This code serves as a more specific indicator for the HTTP error code specified in the response. Can be used to programmatically handle specific error cases.

message

string

Human-readable, language-independent representation of the error. It is intended as an aid to developers and is not suitable for exposure to end users.