Environments - Create Or Update
Belirtilen abonelik ve kaynak grubunda bir ortam oluşturun veya güncelleştirin.
PUT 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 |
Ortamın adı Regex pattern: |
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ı için Ortam Oluştur veya Güncelleştir işlemine sağlanan parametreler. |
Gen2Environment |
2. Nesil ortamı için Ortam Oluştur veya Güncelleştir işlemine sağlanan parametreler. |
Gen1EnvironmentCreateOrUpdateParameters
1. Nesil ortamı için Ortam Oluştur veya Güncelleştir işlemine sağlanan parametreler.
Name | Gerekli | Tür | Description |
---|---|---|---|
kind | True |
string:
Gen1 |
Ortamın türü. |
location | True |
string |
Kaynağın konumu. |
properties.dataRetentionTime | True |
string |
ISO8601 zaman aralığı, ortamın olaylarının sorgu için en az kaç gün süreyle kullanılabilir olacağını belirtir. |
sku | True |
Sku, ortam türünü (1. Nesil (S1 veya S2) veya 2. Nesil (L1) belirler. 1. Nesil ortamları için sku ortamın kapasitesini, giriş oranını ve faturalama oranını belirler. |
|
properties.partitionKeyProperties |
Ortamdaki verileri bölümlemede kullanılacak olay özelliklerinin listesi. Şu anda yalnızca tek bir bölüm anahtarı özelliği desteklenmektedir. |
||
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. |
||
tags |
object |
Kaynak için ek özelliklerin anahtar-değer çiftleri. |
Gen2EnvironmentCreateOrUpdateParameters
2. Nesil ortamı için Ortam Oluştur veya Güncelleştir işlemine sağlanan parametreler.
Name | Gerekli | Tür | Description |
---|---|---|---|
kind | True |
string:
Gen2 |
Ortamın türü. |
location | True |
string |
Kaynağın konumu. |
properties.storageConfiguration | True |
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 | True |
Ortamın zaman serisi kimliğini tanımlamak için kullanılacak olay özelliklerinin listesi. |
|
sku | True |
Sku, ortam türünü (1. Nesil (S1 veya S2) veya 2. Nesil (L1) belirler. 1. Nesil ortamları için sku ortamın kapasitesini, giriş oranını ve faturalama oranını belirler. |
|
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 |
Kaynak için ek özelliklerin anahtar-değer çiftleri. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK | EnvironmentResource: |
Mevcut ortam tanımı başarıyla güncelleştirildi. |
201 Created | EnvironmentResource: |
Ortam oluşturma isteği kabul edildi. Ortam sağlama zaman uyumsuz bir işlemdir. Ortam tanımınızı düzenli aralıklarla alabilir ve provisioningState özelliği aracılığıyla ilerleme durumunu izleyebilirsiniz. |
404 Not Found |
Abonelik veya kaynak grubu bulunamadı. |
|
Other Status Codes |
HTTP 400 (Hatalı İstek): Verilen ortam isteği gövdesi geçersiz; Ayrıntılar için yanıttaki hata koduna ve iletiye bakın. |
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
EnvironmentsCreate
Sample Request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.TimeSeriesInsights/environments/env1?api-version=2020-05-15
{
"location": "West US",
"kind": "Gen1",
"sku": {
"name": "S1",
"capacity": 1
},
"properties": {
"dataRetentionTime": "P31D",
"partitionKeyProperties": [
{
"name": "DeviceId1",
"type": "String"
}
]
}
}
Sample Response
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.TimeSeriesInsights/Environments/env1",
"location": "West US",
"name": "env1",
"type": "Microsoft.TimeSeriesInsights/Environments",
"kind": "Gen1",
"tags": {},
"properties": {
"dataRetentionTime": "P31D",
"provisioningState": "Creating",
"creationTime": "2017-04-18T19:20:33.2288820Z"
},
"sku": {
"name": "S1",
"capacity": 1
}
}
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.TimeSeriesInsights/Environments/env1",
"location": "West US",
"name": "env1",
"type": "Microsoft.TimeSeriesInsights/Environments",
"kind": "Gen1",
"tags": {},
"properties": {
"dataRetentionTime": "P31D",
"provisioningState": "Succeeded",
"creationTime": "2017-04-18T19:20:33.2288820Z"
},
"sku": {
"name": "S1",
"capacity": 1
}
}
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 |
1. Nesil ortamı için Ortam Oluştur veya Güncelleştir işlemine sağlanan parametreler. |
Gen1Environment |
Ortam, sorgu için kullanılabilen bir zaman serisi veri kümesidir ve en üst düzey Azure Time Series Insights kaynaktır. 1. Nesil ortamlarının veri saklama sınırları vardır. |
Gen2Environment |
2. Nesil ortamı için Ortam Oluştur veya Güncelleştir işlemine sağlanan parametreler. |
Gen2Environment |
Ortam, sorgu için kullanılabilen bir zaman serisi veri kümesidir ve en üst düzey Azure Time Series Insights kaynaktır. 2. Nesil ortamlarında veri saklama sınırları ayarlanmadı. |
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. "Disabled", "Ready", "Running", "Paused" veya "Unknown" 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ı için 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, yeni olaylar olay kaynağından 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ın bu tür birden çok özelliği 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. |
Gen1EnvironmentCreateOrUpdateParameters
1. Nesil ortamı için Ortam Oluştur veya Güncelleştir işlemine sağlanan parametreler.
Name | Tür | Description |
---|---|---|
kind |
string:
Gen1 |
Ortamın türü. |
location |
string |
Kaynağın konumu. |
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.partitionKeyProperties |
Ortamdaki verileri bölümlemede kullanılacak olay özelliklerinin listesi. Şu anda yalnızca tek bir bölüm anahtarı özelliği desteklenmektedir. |
|
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 |
Sku, ortam türünü (1. Nesil (S1 veya S2) veya 2. Nesil (L1) belirler. 1. Nesil ortamları için sku ortamın kapasitesini, giriş oranını ve faturalama oranını belirler. |
|
tags |
object |
Kaynak için ek özelliklerin anahtar-değer çiftleri. |
Gen1EnvironmentResource
Ortam, sorgu için kullanılabilen bir zaman serisi veri kümesidir ve en üst düzey Azure Time Series Insights kaynaktır. 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, örneğin ortamın olaylarını sorgulamak veya ortam için başvuru verilerini karşıya yüklemek için kullanılan tam etki alanı adı. |
properties.dataAccessId |
string |
Ortam verilerine erişmek, örneğin ortamın olaylarını sorgulamak veya ortam için başvuru verilerini karşıya yüklemek için kullanılan bir kimlik. |
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.partitionKeyProperties |
Ortamdaki verileri bölümlemede 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, yeni olaylar olay kaynağından 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ı için sku ortamın kapasitesini, giriş oranını ve faturalama oranını belirler. |
|
tags |
object |
Kaynak etiketleri |
type |
string |
Kaynak türü |
Gen2EnvironmentCreateOrUpdateParameters
2. Nesil ortamı için Ortam Oluştur veya Güncelleştir işlemine sağlanan parametreler.
Name | Tür | Description |
---|---|---|
kind |
string:
Gen2 |
Ortamın türü. |
location |
string |
Kaynağın konumu. |
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. |
|
sku |
Sku, ortam türünü (1. Nesil (S1 veya S2) veya 2. Nesil (L1) belirler. 1. Nesil ortamları için sku ortamın kapasitesini, giriş oranını ve faturalama oranını belirler. |
|
tags |
object |
Kaynak için ek özelliklerin anahtar-değer çiftleri. |
Gen2EnvironmentResource
Ortam, sorgu için kullanılabilen bir zaman serisi veri kümesidir ve en üst düzey Azure Time Series Insights kaynaktır. 2. Nesil ortamlarında veri saklama sınırları ayarlanmadı.
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, örneğin ortamın olaylarını sorgulamak veya ortam için başvuru verilerini karşıya yüklemek için kullanılan tam etki alanı adı. |
properties.dataAccessId |
string |
Ortam verilerine erişmek, örneğin ortamın olaylarını sorgulamak veya ortam için başvuru verilerini karşıya yüklemek için kullanılan bir kimlik. |
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ı için sku ortamın kapasitesini, giriş oranını ve faturalama oranını belirler. |
|
tags |
object |
Kaynak etiketleri |
type |
string |
Kaynak türü |
Gen2StorageConfigurationInput
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 |
---|---|---|
accountName |
string |
Ortamın 2. Nesil verilerini barındıracak depolama hesabının adı. |
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. "Disabled", "Ready", "Running", "Paused" veya "Unknown" olabilir |
|
stateDetails |
Bir ortamın durumuyla ilgili ayrıntıları içeren bir nesne. |
IngressState
Bu dize, bir ortamdaki giriş işlemlerinin durumunu temsil eder. "Disabled", "Ready", "Running", "Paused" veya "Unknown" 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ı için sku ortamın kapasitesini, giriş oranını ve faturalama oranını belirler.
Name | Tür | Description |
---|---|---|
capacity |
integer |
Sku'nun kapasitesi. 1. Nesil ortamları için 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, yeni olaylar olay kaynağından 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ın bu tür birden çok özelliği 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 |
Ortam tarafından S1/S2 SKU için 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 için Warm Store tarafından izin verilen en fazla ö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 |
ISO8601 zaman aralığı, ortamın etkinliklerinin sıcak depodan sorgu için kaç gün süreyle kullanılabilir olacağını belirtir. |