Environments - Update
Belirtilen abonelikte ve kaynak grubunda belirtilen adla ortamı Güncelleştirmeler.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TimeSeriesInsights/environments/{environmentName}?api-version=2020-05-15
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
environment
|
path | True |
string |
Belirtilen kaynak grubuyla ilişkili Time Series Insights ortamının adı. |
resource
|
path | True |
string |
Azure Kaynak grubunun adı. |
subscription
|
path | True |
string |
Azure Abonelik Kimliği. |
api-version
|
query | True |
string |
İstemci isteğiyle kullanılacak API sürümü. |
İstek Gövdesi
İstek gövdesi şunlardan biri olabilir:
Name | Description |
---|---|
Gen1Environment |
1. Nesil ortamını güncelleştirmek için Ortamı Güncelleştir işlemine sağlanan parametreler. |
Gen2Environment |
2. Nesil ortamını güncelleştirmek için Ortamı Güncelleştir işlemine sağlanan parametreler. |
Gen1EnvironmentUpdateParameters
1. Nesil ortamını güncelleştirmek için Ortamı Güncelleştir işlemine sağlanan parametreler.
Name | Gerekli | Tür | Description |
---|---|---|---|
kind | True |
string:
Gen1 |
Ortamın türü. |
properties.dataRetentionTime |
string |
ISO8601 zaman aralığı, ortamın olaylarının sorgu için en az kaç gün süreyle kullanılabilir olacağını belirtir. |
|
properties.storageLimitExceededBehavior |
Ortamın kapasitesi aşıldığında Time Series Insights hizmetinin alması gereken davranış. "PauseIngress" belirtilirse, yeni olaylar olay kaynağından okunmayacak. "PurgeOldData" belirtilirse, yeni olaylar okunmaya devam eder ve eski olaylar ortamdan silinir. Varsayılan davranış PurgeOldData'dır. |
||
sku |
Ortamın sku'su. |
||
tags |
object |
Ortam için ek özelliklerin anahtar-değer çiftleri. |
Gen2EnvironmentUpdateParameters
2. Nesil ortamını güncelleştirmek için Ortamı Güncelleştir işlemine sağlanan parametreler.
Name | Gerekli | Tür | Description |
---|---|---|---|
kind | True |
string:
Gen2 |
Ortamın türü. |
properties.storageConfiguration |
Depolama yapılandırması, Time Series Insights hizmetinin ortamın verilerini depolamak için kullanılan müşteri depolama hesabına bağlanmasını sağlayan bağlantı ayrıntılarını sağlar. |
||
properties.warmStoreConfiguration |
Sıcak depo yapılandırması, ortamın daha hızlı sorgulanabilen verilerinin bir kopyasını saklayacak bir sıcak depo önbelleği oluşturma ayrıntılarını sağlar. |
||
tags |
object |
Ortam için ek özelliklerin anahtar-değer çiftleri. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK | EnvironmentResource: |
Ortam tanımı başarıyla güncelleştirildi ve yanıtta. Ortam zaman uyumlu olarak güncelleştirildiyse, yanıt "Başarılı" provisioningState değerini içerir. Ortam zaman uyumsuz olarak güncelleştirildiyse, yanıt "Güncelleştirme" provisioningState değerini içerir. ProvisioningState özelliği aracılığıyla düzenli aralıklarla ortam tanımınızı alabilir ve güncelleştirmenin ilerleme durumunu izleyebilirsiniz. |
Other Status Codes |
HTTP 404 (Bulunamadı): Abonelik, kaynak grubu veya ortam bulunamadı. |
Güvenlik
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 | kullanıcı hesabınızın kimliğine bürünme |
Örnekler
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
}
}
Tanımlar
Name | Description |
---|---|
Cloud |
API hatası hakkında bilgi içerir. |
Cloud |
Hata kodu ve ileti içeren belirli bir API hatası açıklanır. |
Environment |
Bir ortamın durumuyla ilgili ayrıntıları içeren bir nesne. |
Environment |
Ortamın durumunu ve Time Series Insights hizmetindeki iç durumunu temsil eden bir nesne. |
Gen1Environment |
Ortam, sorgu için kullanılabilen bir zaman serisi verileri kümesidir ve kaynak Azure Time Series Insights en üst düzeydir. 1. Nesil ortamlarının veri saklama sınırları vardır. |
Gen1Environment |
1. Nesil ortamını güncelleştirmek için Ortamı Güncelleştir işlemine sağlanan parametreler. |
Gen2Environment |
Ortam, sorgu için kullanılabilen bir zaman serisi verileri kümesidir ve kaynak Azure Time Series Insights en üst düzeydir. 2. Nesil ortamlarında veri saklama sınırları ayarlanmaz. |
Gen2Environment |
2. Nesil ortamını güncelleştirmek için Ortamı Güncelleştir işlemine sağlanan parametreler. |
Gen2Storage |
Depolama yapılandırması, Time Series Insights hizmetinin ortamın verilerini depolamak için kullanılan müşteri depolama hesabına bağlanmasını sağlayan bağlantı ayrıntılarını sağlar. |
Gen2Storage |
Depolama yapılandırması, ortamın verilerini depolamak için kullanılan müşteri depolama hesabıyla ilgili gizli olmayan bağlantı ayrıntılarını sağlar. |
Ingress |
Bir ortamda girişin durumunu temsil eden nesne. |
Ingress |
Bu dize, bir ortamdaki giriş işlemlerinin durumunu temsil eder. "Devre Dışı", "Hazır", "Çalışıyor", "Duraklatıldı" veya "Bilinmiyor" olabilir |
Property |
Özelliğin türü. |
Provisioning |
Kaynağın sağlama durumu. |
Sku |
Sku, ortam türünü (1. Nesil (S1 veya S2) veya 2. Nesil (L1) belirler. 1. Nesil ortamlarında sku ortamın kapasitesini, giriş oranını ve faturalama oranını belirler. |
Sku |
Bu SKU'nun adı. |
Storage |
Ortamın kapasitesi aşıldığında Time Series Insights hizmetinin alması gereken davranış. "PauseIngress" belirtilirse, olay kaynağından yeni olaylar okunmayacak. "PurgeOldData" belirtilirse, yeni olaylar okunmaya devam eder ve eski olaylar ortamdan silinir. Varsayılan davranış PurgeOldData'dır. |
Time |
Bir zaman serisi kimliğinin sahip olabileceği özelliğin yapısı. Bir ortam, bu tür birden çok özelliğe sahip olabilir. |
Warm |
Bir ortamdaki sıcak depolama durumunu temsil eden nesne. |
Warm |
Bu dize, sıcak depolama özellikleri kullanımının durumunu temsil eder. "Tamam", "Hata", "Bilinmiyor" olabilir. |
Warm |
Sıcak depo yapılandırması, ortamın daha hızlı sorgulanabilen verilerinin bir kopyasını saklayacak bir sıcak depo önbelleği oluşturma ayrıntılarını sağlar. |
CloudError
API hatası hakkında bilgi içerir.
Name | Tür | Description |
---|---|---|
error |
Hata kodu ve ileti içeren belirli bir API hatası açıklanır. |
CloudErrorBody
Hata kodu ve ileti içeren belirli bir API hatası açıklanır.
Name | Tür | Description |
---|---|---|
code |
string |
Http durum kodundan daha kesin bir şekilde hata koşulunu açıklayan bir hata kodu. Belirli hata durumlarını program aracılığıyla işlemek için kullanılabilir. |
details |
Bu hatayla ilgili iç içe hatalar içerir. |
|
message |
string |
Hatayı ayrıntılı olarak açıklayan ve hata ayıklama bilgileri sağlayan bir ileti. |
target |
string |
Belirli bir hatanın hedefi (örneğin, hatadaki özelliğin adı). |
EnvironmentStateDetails
Bir ortamın durumuyla ilgili ayrıntıları içeren bir nesne.
Name | Tür | Description |
---|---|---|
code |
string |
Bir ortamın belirli bir durumda olmasının nedenini temsil eden kodu içerir. Belirli durumları program aracılığıyla işlemek için kullanılabilir. |
message |
string |
Durumu ayrıntılı olarak açıklayan bir ileti. |
EnvironmentStatus
Ortamın durumunu ve Time Series Insights hizmetindeki iç durumunu temsil eden bir nesne.
Name | Tür | Description |
---|---|---|
ingress |
Bir ortamda girişin durumunu temsil eden nesne. |
|
warmStorage |
Bir ortamdaki sıcak depolama durumunu temsil eden nesne. |
Gen1EnvironmentResource
Ortam, sorgu için kullanılabilen bir zaman serisi verileri kümesidir ve kaynak Azure Time Series Insights en üst düzeydir. 1. Nesil ortamlarının veri saklama sınırları vardır.
Name | Tür | Description |
---|---|---|
creationTime |
string |
Kaynağın oluşturulduğu saat. |
id |
string |
Kaynak Kimliği |
kind |
string:
Gen1 |
Ortamın türü. |
location |
string |
Kaynak konumu |
name |
string |
Kaynak adı |
properties.dataAccessFqdn |
string |
Ortam verilerine erişmek için kullanılan tam etki alanı adı; örneğin, ortamın olaylarını sorgulamak veya ortam için başvuru verilerini karşıya yüklemek. |
properties.dataAccessId |
string |
Ortam verilerine erişmek için kullanılan kimlik; örneğin, ortamın olaylarını sorgulamak veya ortam için başvuru verilerini karşıya yüklemek. |
properties.dataRetentionTime |
string |
ISO8601 zaman aralığı, ortam olaylarının sorgu için en az kaç gün kullanılabilir olacağını belirtir. |
properties.partitionKeyProperties |
Ortamdaki verileri bölümlendirmek için kullanılacak olay özelliklerinin listesi. Şu anda yalnızca tek bir bölüm anahtarı özelliği desteklenmektedir. |
|
properties.status |
Ortamın durumunu ve Time Series Insights hizmetindeki iç durumunu temsil eden bir nesne. |
|
properties.storageLimitExceededBehavior |
Ortamın kapasitesi aşıldığında Time Series Insights hizmetinin alması gereken davranış. "PauseIngress" belirtilirse, olay kaynağından yeni olaylar okunmayacak. "PurgeOldData" belirtilirse, yeni olaylar okunmaya devam eder ve eski olaylar ortamdan silinir. Varsayılan davranış PurgeOldData'dır. |
|
provisioningState |
Kaynağın sağlama durumu. |
|
sku |
Sku, ortam türünü (1. Nesil (S1 veya S2) veya 2. Nesil (L1) belirler. 1. Nesil ortamlarında sku ortamın kapasitesini, giriş oranını ve faturalama oranını belirler. |
|
tags |
object |
Kaynak etiketleri |
type |
string |
Kaynak türü |
Gen1EnvironmentUpdateParameters
1. Nesil ortamını güncelleştirmek için Ortamı Güncelleştir işlemine sağlanan parametreler.
Name | Tür | Description |
---|---|---|
kind |
string:
Gen1 |
Ortamın türü. |
properties.dataRetentionTime |
string |
ISO8601 zaman aralığı, ortam olaylarının sorgu için en az kaç gün kullanılabilir olacağını belirtir. |
properties.storageLimitExceededBehavior |
Ortamın kapasitesi aşıldığında Time Series Insights hizmetinin alması gereken davranış. "PauseIngress" belirtilirse, olay kaynağından yeni olaylar okunmayacak. "PurgeOldData" belirtilirse, yeni olaylar okunmaya devam eder ve eski olaylar ortamdan silinir. Varsayılan davranış PurgeOldData'dır. |
|
sku |
Ortamın sku'su. |
|
tags |
object |
Ortam için ek özelliklerin anahtar-değer çiftleri. |
Gen2EnvironmentResource
Ortam, sorgu için kullanılabilen bir zaman serisi verileri kümesidir ve kaynak Azure Time Series Insights en üst düzeydir. 2. Nesil ortamlarında veri saklama sınırları ayarlanmaz.
Name | Tür | Description |
---|---|---|
creationTime |
string |
Kaynağın oluşturulduğu saat. |
id |
string |
Kaynak Kimliği |
kind |
string:
Gen2 |
Ortamın türü. |
location |
string |
Kaynak konumu |
name |
string |
Kaynak adı |
properties.dataAccessFqdn |
string |
Ortam verilerine erişmek için kullanılan tam etki alanı adı; örneğin, ortamın olaylarını sorgulamak veya ortam için başvuru verilerini karşıya yüklemek. |
properties.dataAccessId |
string |
Ortam verilerine erişmek için kullanılan kimlik; örneğin, ortamın olaylarını sorgulamak veya ortam için başvuru verilerini karşıya yüklemek. |
properties.status |
Ortamın durumunu ve Time Series Insights hizmetindeki iç durumunu temsil eden bir nesne. |
|
properties.storageConfiguration |
Depolama yapılandırması, Time Series Insights hizmetinin ortamın verilerini depolamak için kullanılan müşteri depolama hesabına bağlanmasını sağlayan bağlantı ayrıntılarını sağlar. |
|
properties.timeSeriesIdProperties |
Ortamın zaman serisi kimliğini tanımlamak için kullanılacak olay özelliklerinin listesi. |
|
properties.warmStoreConfiguration |
Sıcak depo yapılandırması, ortamın daha hızlı sorgulanabilen verilerinin bir kopyasını saklayacak bir sıcak depo önbelleği oluşturma ayrıntılarını sağlar. |
|
provisioningState |
Kaynağın sağlama durumu. |
|
sku |
Sku, ortam türünü (1. Nesil (S1 veya S2) veya 2. Nesil (L1) belirler. 1. Nesil ortamlarında sku ortamın kapasitesini, giriş oranını ve faturalama oranını belirler. |
|
tags |
object |
Kaynak etiketleri |
type |
string |
Kaynak türü |
Gen2EnvironmentUpdateParameters
2. Nesil ortamını güncelleştirmek için Ortamı Güncelleştir işlemine sağlanan parametreler.
Name | Tür | Description |
---|---|---|
kind |
string:
Gen2 |
Ortamın türü. |
properties.storageConfiguration |
Depolama yapılandırması, Time Series Insights hizmetinin ortamın verilerini depolamak için kullanılan müşteri depolama hesabına bağlanmasını sağlayan bağlantı ayrıntılarını sağlar. |
|
properties.warmStoreConfiguration |
Sıcak depo yapılandırması, ortamın daha hızlı sorgulanabilen verilerinin bir kopyasını saklayacak bir sıcak depo önbelleği oluşturma ayrıntılarını sağlar. |
|
tags |
object |
Ortam için ek özelliklerin anahtar-değer çiftleri. |
Gen2StorageConfigurationMutableProperties
Depolama yapılandırması, Time Series Insights hizmetinin ortamın verilerini depolamak için kullanılan müşteri depolama hesabına bağlanmasını sağlayan bağlantı ayrıntılarını sağlar.
Name | Tür | Description |
---|---|---|
managementKey |
string |
Time Series Insights hizmetine depolama hesabına yazma erişimi veren yönetim anahtarının değeri. Bu özellik ortam yanıtlarında gösterilmez. |
Gen2StorageConfigurationOutput
Depolama yapılandırması, ortamın verilerini depolamak için kullanılan müşteri depolama hesabıyla ilgili gizli olmayan bağlantı ayrıntılarını sağlar.
Name | Tür | Description |
---|---|---|
accountName |
string |
Ortamın 2. Nesil verilerini barındıracak depolama hesabının adı. |
IngressEnvironmentStatus
Bir ortamda girişin durumunu temsil eden nesne.
Name | Tür | Description |
---|---|---|
state |
Bu dize, bir ortamdaki giriş işlemlerinin durumunu temsil eder. "Devre Dışı", "Hazır", "Çalışıyor", "Duraklatıldı" veya "Bilinmiyor" olabilir |
|
stateDetails |
Bir ortamın durumuyla ilgili ayrıntıları içeren nesne. |
IngressState
Bu dize, bir ortamdaki giriş işlemlerinin durumunu temsil eder. "Devre Dışı", "Hazır", "Çalışıyor", "Duraklatıldı" veya "Bilinmiyor" olabilir
Name | Tür | Description |
---|---|---|
Disabled |
string |
|
Paused |
string |
|
Ready |
string |
|
Running |
string |
|
Unknown |
string |
PropertyType
Özelliğin türü.
Name | Tür | Description |
---|---|---|
String |
string |
ProvisioningState
Kaynağın sağlama durumu.
Name | Tür | Description |
---|---|---|
Accepted |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
Sku
Sku, ortam türünü (1. Nesil (S1 veya S2) veya 2. Nesil (L1) belirler. 1. Nesil ortamlarında sku ortamın kapasitesini, giriş oranını ve faturalama oranını belirler.
Name | Tür | Description |
---|---|---|
capacity |
integer |
Sku'nun kapasitesi. 1. Nesil ortamlarında, bu değer oluşturulduktan sonra ortamların ölçeğini genişletmeyi destekleyecek şekilde değiştirilebilir. |
name |
Bu SKU'nun adı. |
SkuName
Bu SKU'nun adı.
Name | Tür | Description |
---|---|---|
L1 |
string |
|
P1 |
string |
|
S1 |
string |
|
S2 |
string |
StorageLimitExceededBehavior
Ortamın kapasitesi aşıldığında Time Series Insights hizmetinin alması gereken davranış. "PauseIngress" belirtilirse, olay kaynağından yeni olaylar okunmayacak. "PurgeOldData" belirtilirse, yeni olaylar okunmaya devam eder ve eski olaylar ortamdan silinir. Varsayılan davranış PurgeOldData'dır.
Name | Tür | Description |
---|---|---|
PauseIngress |
string |
|
PurgeOldData |
string |
TimeSeriesIdProperty
Bir zaman serisi kimliğinin sahip olabileceği özelliğin yapısı. Bir ortam, bu tür birden çok özelliğe sahip olabilir.
Name | Tür | Description |
---|---|---|
name |
string |
Özelliğin adı. |
type |
Özelliğin türü. |
WarmStorageEnvironmentStatus
Bir ortamdaki sıcak depolama durumunu temsil eden nesne.
Name | Tür | Description |
---|---|---|
propertiesUsage.state |
Bu dize, sıcak depolama özellikleri kullanımının durumunu temsil eder. "Tamam", "Hata", "Bilinmiyor" olabilir. |
|
propertiesUsage.stateDetails.currentCount |
integer |
S1/S2 SKU için ortam tarafından kullanılan özelliklerin sayısını ve PAYG SKU'su için Warm Store tarafından kullanılan özelliklerin sayısını gösteren değer |
propertiesUsage.stateDetails.maxCount |
integer |
Ortam tarafından S1/S2 SKU için izin verilen en fazla özellik sayısını ve PAYG SKU'su için Warm Store tarafından izin verilen maksimum özellik sayısını temsil eden bir değer. |
WarmStoragePropertiesState
Bu dize, sıcak depolama özellikleri kullanımının durumunu temsil eder. "Tamam", "Hata", "Bilinmiyor" olabilir.
Name | Tür | Description |
---|---|---|
Error |
string |
|
Ok |
string |
|
Unknown |
string |
WarmStoreConfigurationProperties
Sıcak depo yapılandırması, ortamın daha hızlı sorgulanabilen verilerinin bir kopyasını saklayacak bir sıcak depo önbelleği oluşturma ayrıntılarını sağlar.
Name | Tür | Description |
---|---|---|
dataRetention |
string |
ortam olaylarının sıcak depodan sorgu için kaç gün süreyle kullanılabilir olacağını belirten ISO8601 zaman aralığı. |