Environments - Update
Updates the environment with the specified name in the specified subscription and resource group.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TimeSeriesInsights/environments/{environmentName}?api-version=2020-05-15
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
environment
|
path | True |
string |
The name of the Time Series Insights environment associated with the specified resource group. |
resource
|
path | True |
string |
Name of an Azure Resource group. |
subscription
|
path | True |
string |
Azure Subscription ID. |
api-version
|
query | True |
string |
Version of the API to be used with the client request. |
Request Body
The request body can be one of the following:
Name | Description |
---|---|
Gen1Environment |
Parameters supplied to the Update Environment operation to update a Gen1 environment. |
Gen2Environment |
Parameters supplied to the Update Environment operation to update a Gen2 environment. |
Gen1EnvironmentUpdateParameters
Parameters supplied to the Update Environment operation to update a Gen1 environment.
Name | Required | Type | Description |
---|---|---|---|
kind | True |
string:
Gen1 |
The kind of the environment. |
properties.dataRetentionTime |
string |
ISO8601 timespan specifying the minimum number of days the environment's events will be available for query. |
|
properties.storageLimitExceededBehavior |
The behavior the Time Series Insights service should take when the environment's capacity has been exceeded. If "PauseIngress" is specified, new events will not be read from the event source. If "PurgeOldData" is specified, new events will continue to be read and old events will be deleted from the environment. The default behavior is PurgeOldData. |
||
sku |
The sku of the environment. |
||
tags |
object |
Key-value pairs of additional properties for the environment. |
Gen2EnvironmentUpdateParameters
Parameters supplied to the Update Environment operation to update a Gen2 environment.
Name | Required | Type | Description |
---|---|---|---|
kind | True |
string:
Gen2 |
The kind of the environment. |
properties.storageConfiguration |
The storage configuration provides the connection details that allows the Time Series Insights service to connect to the customer storage account that is used to store the environment's data. |
||
properties.warmStoreConfiguration |
The warm store configuration provides the details to create a warm store cache that will retain a copy of the environment's data available for faster query. |
||
tags |
object |
Key-value pairs of additional properties for the environment. |
Responses
Name | Type | Description |
---|---|---|
200 OK | EnvironmentResource: |
The environment definition was successfully updated and is in the response. If the environment was updated synchronously, the response will include a provisioningState value of "Succeeded". If the environment was updated asynchronously, the response will include a provisioningState value of "Updating". You can periodically get your environment definition and monitor progress of the update via the provisioningState property. |
Other Status Codes |
HTTP 404 (Not Found): The subscription, resource group, or environment could not be found. |
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
EnvironmentsUpdate
Sample Request
Sample Response
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.TimeSeriesInsights/Environments/env1",
"location": "West US",
"name": "env1",
"type": "Microsoft.TimeSeriesInsights/Environments",
"kind": "Gen1",
"tags": {
"someTag": "someTagValue"
},
"properties": {
"dataRetentionTime": "P31D",
"provisioningState": "Succeeded",
"creationTime": "2017-04-18T19:20:33.2288820Z"
},
"sku": {
"name": "S1",
"capacity": 10
}
}
Definitions
Name | Description |
---|---|
Cloud |
Contains information about an API error. |
Cloud |
Describes a particular API error with an error code and a message. |
Environment |
An object that contains the details about an environment's state. |
Environment |
An object that represents the status of the environment, and its internal state in the Time Series Insights service. |
Gen1Environment |
An environment is a set of time-series data available for query, and is the top level Azure Time Series Insights resource. Gen1 environments have data retention limits. |
Gen1Environment |
Parameters supplied to the Update Environment operation to update a Gen1 environment. |
Gen2Environment |
An environment is a set of time-series data available for query, and is the top level Azure Time Series Insights resource. Gen2 environments do not have set data retention limits. |
Gen2Environment |
Parameters supplied to the Update Environment operation to update a Gen2 environment. |
Gen2Storage |
The storage configuration provides the connection details that allows the Time Series Insights service to connect to the customer storage account that is used to store the environment's data. |
Gen2Storage |
The storage configuration provides the non-secret connection details about the customer storage account that is used to store the environment's data. |
Ingress |
An object that represents the status of ingress on an environment. |
Ingress |
This string represents the state of ingress operations on an environment. It can be "Disabled", "Ready", "Running", "Paused" or "Unknown" |
Property |
The type of the property. |
Provisioning |
Provisioning state of the resource. |
Sku |
The sku determines the type of environment, either Gen1 (S1 or S2) or Gen2 (L1). For Gen1 environments the sku determines the capacity of the environment, the ingress rate, and the billing rate. |
Sku |
The name of this SKU. |
Storage |
The behavior the Time Series Insights service should take when the environment's capacity has been exceeded. If "PauseIngress" is specified, new events will not be read from the event source. If "PurgeOldData" is specified, new events will continue to be read and old events will be deleted from the environment. The default behavior is PurgeOldData. |
Time |
The structure of the property that a time series id can have. An environment can have multiple such properties. |
Warm |
An object that represents the status of warm storage on an environment. |
Warm |
This string represents the state of warm storage properties usage. It can be "Ok", "Error", "Unknown". |
Warm |
The warm store configuration provides the details to create a warm store cache that will retain a copy of the environment's data available for faster query. |
CloudError
Contains information about an API error.
Name | Type | Description |
---|---|---|
error |
Describes a particular API error with an error code and a message. |
CloudErrorBody
Describes a particular API error with an error code and a message.
Name | Type | Description |
---|---|---|
code |
string |
An error code that describes the error condition more precisely than an HTTP status code. Can be used to programmatically handle specific error cases. |
details |
Contains nested errors that are related to this error. |
|
message |
string |
A message that describes the error in detail and provides debugging information. |
target |
string |
The target of the particular error (for example, the name of the property in error). |
EnvironmentStateDetails
An object that contains the details about an environment's state.
Name | Type | Description |
---|---|---|
code |
string |
Contains the code that represents the reason of an environment being in a particular state. Can be used to programmatically handle specific cases. |
message |
string |
A message that describes the state in detail. |
EnvironmentStatus
An object that represents the status of the environment, and its internal state in the Time Series Insights service.
Name | Type | Description |
---|---|---|
ingress |
An object that represents the status of ingress on an environment. |
|
warmStorage |
An object that represents the status of warm storage on an environment. |
Gen1EnvironmentResource
An environment is a set of time-series data available for query, and is the top level Azure Time Series Insights resource. Gen1 environments have data retention limits.
Name | Type | Description |
---|---|---|
creationTime |
string |
The time the resource was created. |
id |
string |
Resource Id |
kind |
string:
Gen1 |
The kind of the environment. |
location |
string |
Resource location |
name |
string |
Resource name |
properties.dataAccessFqdn |
string |
The fully qualified domain name used to access the environment data, e.g. to query the environment's events or upload reference data for the environment. |
properties.dataAccessId |
string |
An id used to access the environment data, e.g. to query the environment's events or upload reference data for the environment. |
properties.dataRetentionTime |
string |
ISO8601 timespan specifying the minimum number of days the environment's events will be available for query. |
properties.partitionKeyProperties |
The list of event properties which will be used to partition data in the environment. Currently, only a single partition key property is supported. |
|
properties.status |
An object that represents the status of the environment, and its internal state in the Time Series Insights service. |
|
properties.storageLimitExceededBehavior |
The behavior the Time Series Insights service should take when the environment's capacity has been exceeded. If "PauseIngress" is specified, new events will not be read from the event source. If "PurgeOldData" is specified, new events will continue to be read and old events will be deleted from the environment. The default behavior is PurgeOldData. |
|
provisioningState |
Provisioning state of the resource. |
|
sku |
The sku determines the type of environment, either Gen1 (S1 or S2) or Gen2 (L1). For Gen1 environments the sku determines the capacity of the environment, the ingress rate, and the billing rate. |
|
tags |
object |
Resource tags |
type |
string |
Resource type |
Gen1EnvironmentUpdateParameters
Parameters supplied to the Update Environment operation to update a Gen1 environment.
Name | Type | Description |
---|---|---|
kind |
string:
Gen1 |
The kind of the environment. |
properties.dataRetentionTime |
string |
ISO8601 timespan specifying the minimum number of days the environment's events will be available for query. |
properties.storageLimitExceededBehavior |
The behavior the Time Series Insights service should take when the environment's capacity has been exceeded. If "PauseIngress" is specified, new events will not be read from the event source. If "PurgeOldData" is specified, new events will continue to be read and old events will be deleted from the environment. The default behavior is PurgeOldData. |
|
sku |
The sku of the environment. |
|
tags |
object |
Key-value pairs of additional properties for the environment. |
Gen2EnvironmentResource
An environment is a set of time-series data available for query, and is the top level Azure Time Series Insights resource. Gen2 environments do not have set data retention limits.
Name | Type | Description |
---|---|---|
creationTime |
string |
The time the resource was created. |
id |
string |
Resource Id |
kind |
string:
Gen2 |
The kind of the environment. |
location |
string |
Resource location |
name |
string |
Resource name |
properties.dataAccessFqdn |
string |
The fully qualified domain name used to access the environment data, e.g. to query the environment's events or upload reference data for the environment. |
properties.dataAccessId |
string |
An id used to access the environment data, e.g. to query the environment's events or upload reference data for the environment. |
properties.status |
An object that represents the status of the environment, and its internal state in the Time Series Insights service. |
|
properties.storageConfiguration |
The storage configuration provides the connection details that allows the Time Series Insights service to connect to the customer storage account that is used to store the environment's data. |
|
properties.timeSeriesIdProperties |
The list of event properties which will be used to define the environment's time series id. |
|
properties.warmStoreConfiguration |
The warm store configuration provides the details to create a warm store cache that will retain a copy of the environment's data available for faster query. |
|
provisioningState |
Provisioning state of the resource. |
|
sku |
The sku determines the type of environment, either Gen1 (S1 or S2) or Gen2 (L1). For Gen1 environments the sku determines the capacity of the environment, the ingress rate, and the billing rate. |
|
tags |
object |
Resource tags |
type |
string |
Resource type |
Gen2EnvironmentUpdateParameters
Parameters supplied to the Update Environment operation to update a Gen2 environment.
Name | Type | Description |
---|---|---|
kind |
string:
Gen2 |
The kind of the environment. |
properties.storageConfiguration |
The storage configuration provides the connection details that allows the Time Series Insights service to connect to the customer storage account that is used to store the environment's data. |
|
properties.warmStoreConfiguration |
The warm store configuration provides the details to create a warm store cache that will retain a copy of the environment's data available for faster query. |
|
tags |
object |
Key-value pairs of additional properties for the environment. |
Gen2StorageConfigurationMutableProperties
The storage configuration provides the connection details that allows the Time Series Insights service to connect to the customer storage account that is used to store the environment's data.
Name | Type | Description |
---|---|---|
managementKey |
string |
The value of the management key that grants the Time Series Insights service write access to the storage account. This property is not shown in environment responses. |
Gen2StorageConfigurationOutput
The storage configuration provides the non-secret connection details about the customer storage account that is used to store the environment's data.
Name | Type | Description |
---|---|---|
accountName |
string |
The name of the storage account that will hold the environment's Gen2 data. |
IngressEnvironmentStatus
An object that represents the status of ingress on an environment.
Name | Type | Description |
---|---|---|
state |
This string represents the state of ingress operations on an environment. It can be "Disabled", "Ready", "Running", "Paused" or "Unknown" |
|
stateDetails |
An object that contains the details about an environment's state. |
IngressState
This string represents the state of ingress operations on an environment. It can be "Disabled", "Ready", "Running", "Paused" or "Unknown"
Name | Type | Description |
---|---|---|
Disabled |
string |
|
Paused |
string |
|
Ready |
string |
|
Running |
string |
|
Unknown |
string |
PropertyType
The type of the property.
Name | Type | Description |
---|---|---|
String |
string |
ProvisioningState
Provisioning state of the resource.
Name | Type | Description |
---|---|---|
Accepted |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
Sku
The sku determines the type of environment, either Gen1 (S1 or S2) or Gen2 (L1). For Gen1 environments the sku determines the capacity of the environment, the ingress rate, and the billing rate.
Name | Type | Description |
---|---|---|
capacity |
integer |
The capacity of the sku. For Gen1 environments, this value can be changed to support scale out of environments after they have been created. |
name |
The name of this SKU. |
SkuName
The name of this SKU.
Name | Type | Description |
---|---|---|
L1 |
string |
|
P1 |
string |
|
S1 |
string |
|
S2 |
string |
StorageLimitExceededBehavior
The behavior the Time Series Insights service should take when the environment's capacity has been exceeded. If "PauseIngress" is specified, new events will not be read from the event source. If "PurgeOldData" is specified, new events will continue to be read and old events will be deleted from the environment. The default behavior is PurgeOldData.
Name | Type | Description |
---|---|---|
PauseIngress |
string |
|
PurgeOldData |
string |
TimeSeriesIdProperty
The structure of the property that a time series id can have. An environment can have multiple such properties.
Name | Type | Description |
---|---|---|
name |
string |
The name of the property. |
type |
The type of the property. |
WarmStorageEnvironmentStatus
An object that represents the status of warm storage on an environment.
Name | Type | Description |
---|---|---|
propertiesUsage.state |
This string represents the state of warm storage properties usage. It can be "Ok", "Error", "Unknown". |
|
propertiesUsage.stateDetails.currentCount |
integer |
A value that represents the number of properties used by the environment for S1/S2 SKU and number of properties used by Warm Store for PAYG SKU |
propertiesUsage.stateDetails.maxCount |
integer |
A value that represents the maximum number of properties used allowed by the environment for S1/S2 SKU and maximum number of properties allowed by Warm Store for PAYG SKU. |
WarmStoragePropertiesState
This string represents the state of warm storage properties usage. It can be "Ok", "Error", "Unknown".
Name | Type | Description |
---|---|---|
Error |
string |
|
Ok |
string |
|
Unknown |
string |
WarmStoreConfigurationProperties
The warm store configuration provides the details to create a warm store cache that will retain a copy of the environment's data available for faster query.
Name | Type | Description |
---|---|---|
dataRetention |
string |
ISO8601 timespan specifying the number of days the environment's events will be available for query from the warm store. |