Condividi tramite

Ambienti Microsoft.TimeSeriesInsights

  • Articolo

Definizione di risorsa Bicep

Il tipo di risorsa degli ambienti può essere distribuito con operazioni destinate:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.TimeSeriesInsights/environment, aggiungere il codice Bicep seguente al modello.

resource symbolicname 'Microsoft.TimeSeriesInsights/environments@2021-06-30-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    name: 'string'
  }
  kind: 'string'
  // For remaining properties, see environments objects
}

oggetti ambienti

Impostare la proprietà kind per specificare il tipo di oggetto.

Per Gen1 usare:

  kind: 'Gen1'
  properties: {
    dataRetentionTime: 'string'
    partitionKeyProperties: [
      {
        name: 'string'
        type: 'String'
      }
    ]
    storageLimitExceededBehavior: 'string'
  }

Per Gen2, usare:

  kind: 'Gen2'
  properties: {
    storageConfiguration: {
      accountName: 'string'
      managementKey: 'string'
    }
    timeSeriesIdProperties: [
      {
        name: 'string'
        type: 'String'
      }
    ]
    warmStoreConfiguration: {
      dataRetention: 'string'
    }
  }

Valori delle proprietà

environments

Nome Descrizione valore
name Nome della risorsa stringa (obbligatoria)

Limite di caratteri: 1-90

Caratteri validi:
Non è possibile usare:
'<>%&:\?/# o caratteri di controllo
posizione Il percorso della risorsa. stringa (obbligatoria)
tags Coppie chiave-valore di proprietà aggiuntive per la risorsa. Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
sku Lo sku determina il tipo di ambiente, Gen1 (S1 o S2) o Gen2 (L1). Per gli ambienti Gen1, lo sku determina la capacità dell'ambiente, la velocità di ingresso e la tariffa di fatturazione. Sku (obbligatorio)
kind Impostare il tipo di oggetto Prima generazione
Gen2 (obbligatorio)

Gen1EnvironmentCreateOrUpdateParametersOrGen1Environ...

Nome Descrizione Valore
kind Tipo di ambiente. 'Gen1' (obbligatorio)
properties Proprietà usate per creare un ambiente Gen1. Gen1EnvironmentCreationPropertiesOrGen1EnvironmentRe... (obbligatorio)

Gen1EnvironmentCreationPropertiesOrGen1EnvironmentRe...

Nome Descrizione Valore
dataRetentionTime ISO8601 timepan che specifica il numero minimo di giorni in cui gli eventi dell'ambiente saranno disponibili per la query. stringa (obbligatoria)
partitionKeyProperties Elenco delle proprietà dell'evento che verranno usate per partizionare i dati nell'ambiente. Attualmente è supportata solo una singola proprietà della chiave di partizione. TimeSeriesIdProperty[]
storageLimitExceededBehavior Il comportamento del servizio Time Series Insights deve essere eseguito quando la capacità dell'ambiente è stata superata. Se viene specificato "PauseIngress", i nuovi eventi non verranno letti dall'origine evento. Se viene specificato "PurgeOldData", i nuovi eventi continueranno a essere letti e gli eventi precedenti verranno eliminati dall'ambiente. Il comportamento predefinito è PurgeOldData. 'PauseIngress'
'PurgeOldData'

TimeSeriesIdProperty

Nome Descrizione valore
name Nome della proprietà. string
type Tipo della proprietà. 'String'

Gen2EnvironmentCreateOrUpdateParametersOrGen2Environ...

Nome Descrizione Valore
kind Tipo di ambiente. 'Gen2' (obbligatorio)
properties Proprietà usate per creare un ambiente Gen2. Gen2EnvironmentCreationPropertiesOrGen2EnvironmentRe... (obbligatorio)

Gen2EnvironmentCreationPropertiesOrGen2EnvironmentRe...

Nome Descrizione Valore
storageConfiguration La configurazione di archiviazione fornisce i dettagli di connessione che consentono al servizio Time Series Insights di connettersi all'account di archiviazione cliente usato per archiviare i dati dell'ambiente. Gen2StorageConfigurationInputOrGen2StorageConfigurat... (obbligatorio)
timeSeriesIdProperties Elenco delle proprietà dell'evento che verranno usate per definire l'ID serie temporale dell'ambiente. TimeSeriesIdProperty[] (obbligatorio)
warmStoreConfiguration La configurazione dell'archivio ad accesso frequente fornisce i dettagli per creare una cache dell'archivio ad accesso frequente che manterrà una copia dei dati dell'ambiente disponibili per una query più veloce. WarmStoreConfigurationProperties

Gen2StorageConfigurationInputOrGen2StorageConfigurat...

Nome Descrizione Valore
accountName Nome dell'account di archiviazione che conterrà i dati gen2 dell'ambiente. stringa (obbligatoria)
managementKey Valore della chiave di gestione che concede al servizio Time Series Insights l'accesso in scrittura all'account di archiviazione. Questa proprietà non viene visualizzata nelle risposte dell'ambiente. stringa (obbligatoria)

WarmStoreConfigurationProperties

Nome Descrizione Valore
dataRetention ISO8601 timepan che specifica il numero di giorni in cui gli eventi dell'ambiente saranno disponibili per la query dall'archivio ad accesso frequente. stringa (obbligatoria)

Sku

Nome Descrizione Valore
capacità Capacità dello sku. Per gli ambienti Gen1, questo valore può essere modificato per supportare la scalabilità orizzontale degli ambienti dopo la creazione. int (obbligatorio)
name Nome di questo SKU. 'L1'
'P1'
'S1'
'S2' (obbligatorio)

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello Descrizione
Creare un ambiente con pagamento in base al consumo (PAYG) con un hub IoT

Distribuisci in Azure		 Questo modello consente di distribuire un ambiente Time Series Insights con pagamento in base al consumo (PayG) configurato per l'utilizzo di eventi da un hub IoT.
Creare un ambiente con un'origine evento dell'hub eventi

Distribuisci in Azure		 Questo modello consente di distribuire un ambiente Time Series Insights configurato per l'utilizzo di eventi da un hub eventi.

Definizione della risorsa modello di Resource Manager

Il tipo di risorsa degli ambienti può essere distribuito con operazioni destinate:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.TimeSeriesInsights/environment, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.TimeSeriesInsights/environments",
  "apiVersion": "2021-06-30-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "name": "string"
  },
  "kind": "string",
  // For remaining properties, see environments objects
}

oggetti ambienti

Impostare la proprietà kind per specificare il tipo di oggetto.

Per Gen1 usare:

  "kind": "Gen1",
  "properties": {
    "dataRetentionTime": "string",
    "partitionKeyProperties": [
      {
        "name": "string",
        "type": "String"
      }
    ],
    "storageLimitExceededBehavior": "string"
  }

Per Gen2, usare:

  "kind": "Gen2",
  "properties": {
    "storageConfiguration": {
      "accountName": "string",
      "managementKey": "string"
    },
    "timeSeriesIdProperties": [
      {
        "name": "string",
        "type": "String"
      }
    ],
    "warmStoreConfiguration": {
      "dataRetention": "string"
    }
  }

Valori delle proprietà

environments

Nome Descrizione Valore
tipo Tipo di risorsa 'Microsoft.TimeSeriesInsights/environment'
apiVersion Versione dell'API risorsa '2021-06-30-preview'
name Nome della risorsa stringa (obbligatoria)

Limite di caratteri: 1-90

Caratteri validi:
Non è possibile usare:
'<>%&:\?/# o caratteri di controllo
posizione Il percorso della risorsa. stringa (obbligatoria)
tags Coppie chiave-valore di proprietà aggiuntive per la risorsa. Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
sku Lo sku determina il tipo di ambiente, Gen1 (S1 o S2) o Gen2 (L1). Per gli ambienti Gen1, lo sku determina la capacità dell'ambiente, la velocità di ingresso e la tariffa di fatturazione. Sku (obbligatorio)
kind Impostare il tipo di oggetto Prima generazione
Gen2 (obbligatorio)

Gen1EnvironmentCreateOrUpdateParametersOrGen1Environ...

Nome Descrizione Valore
kind Tipo di ambiente. 'Gen1' (obbligatorio)
properties Proprietà usate per creare un ambiente Gen1. Gen1EnvironmentCreationPropertiesOrGen1EnvironmentRe... (obbligatorio)

Gen1EnvironmentCreationPropertiesOrGen1EnvironmentRe...

Nome Descrizione Valore
dataRetentionTime ISO8601 timepan che specifica il numero minimo di giorni in cui gli eventi dell'ambiente saranno disponibili per la query. stringa (obbligatoria)
partitionKeyProperties Elenco delle proprietà dell'evento che verranno usate per partizionare i dati nell'ambiente. Attualmente è supportata solo una singola proprietà della chiave di partizione. TimeSeriesIdProperty[]
storageLimitExceededBehavior Il comportamento del servizio Time Series Insights deve essere eseguito quando la capacità dell'ambiente è stata superata. Se viene specificato "PauseIngress", i nuovi eventi non verranno letti dall'origine evento. Se viene specificato "PurgeOldData", i nuovi eventi continueranno a essere letti e gli eventi precedenti verranno eliminati dall'ambiente. Il comportamento predefinito è PurgeOldData. 'PauseIngress'
'PurgeOldData'

TimeSeriesIdProperty

Nome Descrizione valore
name Nome della proprietà. string
type Tipo della proprietà. 'String'

Gen2EnvironmentCreateOrUpdateParametersOrGen2Environ...

Nome Descrizione Valore
kind Tipo di ambiente. 'Gen2' (obbligatorio)
properties Proprietà usate per creare un ambiente Gen2. Gen2EnvironmentCreationPropertiesOrGen2EnvironmentRe... (obbligatorio)

Gen2EnvironmentCreationPropertiesOrGen2EnvironmentRe...

Nome Descrizione Valore
storageConfiguration La configurazione di archiviazione fornisce i dettagli di connessione che consentono al servizio Time Series Insights di connettersi all'account di archiviazione cliente usato per archiviare i dati dell'ambiente. Gen2StorageConfigurationInputOrGen2StorageConfigurat... (obbligatorio)
timeSeriesIdProperties Elenco delle proprietà dell'evento che verranno usate per definire l'ID serie temporale dell'ambiente. TimeSeriesIdProperty[] (obbligatorio)
warmStoreConfiguration La configurazione dell'archivio ad accesso frequente fornisce i dettagli per creare una cache dell'archivio ad accesso frequente che manterrà una copia dei dati dell'ambiente disponibili per una query più veloce. WarmStoreConfigurationProperties

Gen2StorageConfigurationInputOrGen2StorageConfigurat...

Nome Descrizione Valore
accountName Nome dell'account di archiviazione che conterrà i dati gen2 dell'ambiente. stringa (obbligatoria)
managementKey Valore della chiave di gestione che concede al servizio Time Series Insights l'accesso in scrittura all'account di archiviazione. Questa proprietà non viene visualizzata nelle risposte dell'ambiente. stringa (obbligatoria)

WarmStoreConfigurationProperties

Nome Descrizione Valore
dataRetention ISO8601 timepan che specifica il numero di giorni in cui gli eventi dell'ambiente saranno disponibili per la query dall'archivio ad accesso frequente. stringa (obbligatoria)

Sku

Nome Descrizione Valore
capacità Capacità dello sku. Per gli ambienti Gen1, questo valore può essere modificato per supportare la scalabilità orizzontale degli ambienti dopo la creazione. int (obbligatorio)
name Nome di questo SKU. 'L1'
'P1'
'S1'
'S2' (obbligatorio)

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello Descrizione
Creare un ambiente con pagamento in base al consumo (PAYG) con un hub IoT

Distribuisci in Azure		 Questo modello consente di distribuire un ambiente Time Series Insights con pagamento in base al consumo (PayG) configurato per l'utilizzo di eventi da un hub IoT.
Creare un ambiente con un'origine evento dell'hub eventi

Distribuisci in Azure		 Questo modello consente di distribuire un ambiente Time Series Insights configurato per l'utilizzo di eventi da un hub eventi.

Definizione della risorsa Terraform (provider AzAPI)

Il tipo di risorsa degli ambienti può essere distribuito con operazioni destinate:

  • Gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.TimeSeriesInsights/environments, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.TimeSeriesInsights/environments@2021-06-30-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  // For remaining properties, see environments objects
  body = jsonencode({
    sku = {
      capacity = int
      name = "string"
    }
    kind = "string"
  })
}

oggetti ambienti

Impostare la proprietà kind per specificare il tipo di oggetto.

Per Gen1, usare:

  kind = "Gen1"
  properties = {
    dataRetentionTime = "string"
    partitionKeyProperties = [
      {
        name = "string"
        type = "String"
      }
    ]
    storageLimitExceededBehavior = "string"
  }

Per Gen2, usare:

  kind = "Gen2"
  properties = {
    storageConfiguration = {
      accountName = "string"
      managementKey = "string"
    }
    timeSeriesIdProperties = [
      {
        name = "string"
        type = "String"
      }
    ]
    warmStoreConfiguration = {
      dataRetention = "string"
    }
  }

Valori delle proprietà

environments

Nome Descrizione Valore
tipo Tipo di risorsa "Microsoft.TimeSeriesInsights/environments@2021-06-30-preview"
name Nome della risorsa stringa (obbligatorio)

Limite di caratteri: 1-90

Caratteri validi:
Non è possibile usare:
'<>%&:\?/# o caratteri di controllo
posizione Il percorso della risorsa. stringa (obbligatorio)
parent_id Per eseguire la distribuzione in un gruppo di risorse, usare l'ID del gruppo di risorse. stringa (obbligatorio)
tags Coppie chiave-valore di proprietà aggiuntive per la risorsa. Dizionario di nomi e valori di tag.
sku Lo SKU determina il tipo di ambiente, ovvero Gen1 (S1 o S2) o Gen2 (L1). Per gli ambienti Gen1, lo SKU determina la capacità dell'ambiente, la tariffa in ingresso e la tariffa di fatturazione. Sku (obbligatorio)
kind Impostare il tipo di oggetto Prima generazione
Gen2 (obbligatorio)

Gen1EnvironmentCreateOrUpdateParametersOrGen1Environ...

Nome Descrizione Valore
kind Tipo di ambiente. "Gen1" (obbligatorio)
properties Proprietà usate per creare un ambiente Gen1. Gen1EnvironmentCreationPropertiesOrGen1EnvironmentRe... (obbligatorio)

Gen1EnvironmentCreationPropertiesOrGen1EnvironmentRe...

Nome Descrizione Valore
dataRetentionTime Intervallo di tempo ISO8601 che specifica il numero minimo di giorni in cui gli eventi dell'ambiente saranno disponibili per la query. stringa (obbligatorio)
partitionKeyProperties Elenco di proprietà dell'evento che verranno utilizzate per partizionare i dati nell'ambiente. Attualmente è supportata solo una singola proprietà della chiave di partizione. TimeSeriesIdProperty[]
storageLimitExceededBehavior Il comportamento che il servizio Time Series Insights deve assumere quando è stata superata la capacità dell'ambiente. Se viene specificato "PauseIngress", i nuovi eventi non verranno letti dall'origine evento. Se si specifica "PurgeOldData", i nuovi eventi continueranno a essere letti e gli eventi precedenti verranno eliminati dall'ambiente. Il comportamento predefinito è PurgeOldData. "PauseIngress"
"PurgeOldData"

TimeSeriesIdProperty

Nome Descrizione valore
name Nome della proprietà. string
type Tipo della proprietà. "String"

Gen2EnvironmentCreateOrUpdateParametersOrGen2Environ...

Nome Descrizione Valore
kind Tipo di ambiente. "Gen2" (obbligatorio)
properties Proprietà usate per creare un ambiente Gen2. Gen2EnvironmentCreationPropertiesOrGen2EnvironmentRe... (obbligatorio)

Gen2EnvironmentCreationPropertiesOrGen2EnvironmentRe...

Nome Descrizione Valore
storageConfiguration La configurazione di archiviazione fornisce i dettagli di connessione che consentono al servizio Time Series Insights di connettersi all'account di archiviazione del cliente usato per archiviare i dati dell'ambiente. Gen2StorageConfigurationInputOrGen2StorageConfigurat... (obbligatorio)
timeSeriesIdProperties Elenco di proprietà dell'evento che verranno usate per definire l'ID serie temporale dell'ambiente. TimeSeriesIdProperty[] (obbligatorio)
warmStoreConfiguration La configurazione dell'archivio ad accesso frequente fornisce i dettagli per creare una cache dell'archivio ad accesso frequente che manterrà una copia dei dati dell'ambiente disponibili per una query più veloce. WarmStoreConfigurationProperties

Gen2StorageConfigurationInputOrGen2StorageConfigurat...

Nome Descrizione Valore
accountName Nome dell'account di archiviazione che conterrà i dati gen2 dell'ambiente. stringa (obbligatorio)
managementKey Valore della chiave di gestione che concede al servizio Time Series Insights l'accesso in scrittura all'account di archiviazione. Questa proprietà non viene visualizzata nelle risposte dell'ambiente. stringa (obbligatorio)

WarmStoreConfigurationProperties

Nome Descrizione Valore
dataRetention Intervallo di tempo ISO8601 che specifica il numero di giorni in cui gli eventi dell'ambiente saranno disponibili per la query dall'archivio ad accesso frequente. stringa (obbligatorio)

Sku

Nome Descrizione Valore
capacità Capacità dello SKU. Per gli ambienti Gen1, questo valore può essere modificato per supportare la scalabilità orizzontale degli ambienti dopo la creazione. int (obbligatorio)
name Nome di questo SKU. "L1"
"P1"
"S1"
"S2" (obbligatorio)