Compartir a través de

Entornos de Microsoft.TimeSeriesInsights 2020-05-15

  • Artículo

Definición de recursos de Bicep

El tipo de recurso environments se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.TimeSeriesInsights/environments, agregue el siguiente bicep a la plantilla.

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

objetos environments

Establezca la propiedad kind para especificar el tipo de objeto.

Para Gen1, use:

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

Para Gen2, use:

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

Valores de propiedad

environments

Nombre Descripción Value
name El nombre del recurso string (obligatorio)

Límite de caracteres: 1-90

Caracteres válidos:
No puede usar:
'<>%&:\?/# ni caracteres de control
ubicación Ubicación del recurso. string (obligatorio)
etiquetas Pares clave-valor de propiedades adicionales para el recurso. Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
sku La SKU determina el tipo de entorno, ya sea Gen1 (S1 o S2) o Gen2 (L1). En el caso de los entornos de Gen1, la SKU determina la capacidad del entorno, la tasa de entrada y la tasa de facturación. SKU (obligatorio)
kind Establecimiento del tipo de objeto Gen1
Gen2 (obligatorio)

Gen1EnvironmentCreateOrUpdateParametersOrGen1Environ...

Nombre Descripción Valor
kind El tipo de entorno. 'Gen1' (obligatorio)
properties Propiedades usadas para crear un entorno de Gen1. Gen1EnvironmentCreationPropertiesOrGen1EnvironmentRe... (obligatorio)

Gen1EnvironmentCreationPropertiesOrGen1EnvironmentRe...

Nombre Descripción Valor
dataRetentionTime Intervalo de tiempo ISO8601 que especifica el número mínimo de días que los eventos del entorno estarán disponibles para la consulta. string (obligatorio)
partitionKeyProperties Lista de propiedades de evento que se usarán para crear particiones de datos en el entorno. Actualmente, solo se admite una sola propiedad de clave de partición. TimeSeriesIdProperty[]
storageLimitExceededBehavior El comportamiento que el servicio Time Series Insights debe tomar cuando se ha superado la capacidad del entorno. Si se especifica "PauseIngress", los nuevos eventos no se leerán desde el origen del evento. Si se especifica "PurgeOldData", los nuevos eventos seguirán leyendo y los eventos antiguos se eliminarán del entorno. El comportamiento predeterminado es PurgeOldData. 'PauseIngress'
'PurgeOldData'

TimeSeriesIdProperty

Nombre Descripción Value
name El nombre de la propiedad. string
type Tipo de la propiedad. 'String'

Gen2EnvironmentCreateOrUpdateParametersOrGen2Environ...

Nombre Descripción Valor
kind El tipo de entorno. 'Gen2' (obligatorio)
properties Propiedades usadas para crear un entorno de Gen2. Gen2EnvironmentCreationPropertiesOrGen2EnvironmentRe... (obligatorio)

Gen2EnvironmentCreationPropertiesOrGen2EnvironmentRe...

Nombre Descripción Valor
storageConfiguration La configuración de almacenamiento proporciona los detalles de conexión que permiten al servicio Time Series Insights conectarse a la cuenta de almacenamiento del cliente que se usa para almacenar los datos del entorno. Gen2StorageConfigurationInputOrGen2StorageConfigurat... (obligatorio)
timeSeriesIdProperties Lista de propiedades de evento que se usarán para definir el identificador de serie temporal del entorno. TimeSeriesIdProperty[] (obligatorio)
warmStoreConfiguration La configuración del almacenamiento intermedio proporciona los detalles para crear una memoria caché de almacenamiento intermedio que conservará una copia de los datos del entorno disponibles para una consulta más rápida. WarmStoreConfigurationProperties

Gen2StorageConfigurationInputOrGen2StorageConfigurat...

Nombre Descripción Valor
accountName Nombre de la cuenta de almacenamiento que contendrá los datos gen2 del entorno. string (obligatorio)
managementKey Valor de la clave de administración que concede al servicio Time Series Insights acceso de escritura a la cuenta de almacenamiento. Esta propiedad no se muestra en las respuestas del entorno. string (obligatorio)

WarmStoreConfigurationProperties

Nombre Descripción Valor
dataRetention Intervalo de tiempo ISO8601 que especifica el número de días que los eventos del entorno estarán disponibles para la consulta desde el almacén intermedio. string (obligatorio)

SKU

Nombre Descripción Valor
capacity Capacidad de la SKU. En el caso de los entornos gen1, este valor se puede cambiar para admitir la escalabilidad horizontal de los entornos una vez creados. int (obligatorio)
name Nombre de esta SKU. 'L1'
'P1'
'S1'
'S2' (obligatorio)

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Crear un entorno de pago por uso (PAYG) con un IoT Hub

Implementación en Azure		 Esta plantilla le permite implementar un entorno de Time Series Insights de pago por uso (PAYG) que esté configurado para consumir eventos de una IoT Hub.
Creación de un entorno con un origen de eventos del centro de eventos

Implementación en Azure		 Esta plantilla permite implementar un entorno de Time Series Insights configurado para consumir eventos de un centro de eventos.

Definición de recursos de plantilla de ARM

El tipo de recurso environments se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.TimeSeriesInsights/environments, agregue el siguiente JSON a la plantilla.

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

objetos environments

Establezca la propiedad kind para especificar el tipo de objeto.

Para Gen1, use:

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

Para Gen2, use:

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

Valores de propiedad

environments

Nombre Descripción Value
type Tipo de recurso "Microsoft.TimeSeriesInsights/environments"
apiVersion La versión de la API de recursos '2020-05-15'
name El nombre del recurso string (obligatorio)

Límite de caracteres: 1-90

Caracteres válidos:
No puede usar:
'<>%&:\?/# ni caracteres de control
ubicación Ubicación del recurso. string (obligatorio)
etiquetas Pares clave-valor de propiedades adicionales para el recurso. Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
sku La SKU determina el tipo de entorno, ya sea Gen1 (S1 o S2) o Gen2 (L1). En el caso de los entornos de Gen1, la SKU determina la capacidad del entorno, la tasa de entrada y la tasa de facturación. SKU (obligatorio)
kind Establecimiento del tipo de objeto Gen1
Gen2 (obligatorio)

Gen1EnvironmentCreateOrUpdateParametersOrGen1Environ...

Nombre Descripción Valor
kind El tipo de entorno. 'Gen1' (obligatorio)
properties Propiedades usadas para crear un entorno de Gen1. Gen1EnvironmentCreationPropertiesOrGen1EnvironmentRe... (obligatorio)

Gen1EnvironmentCreationPropertiesOrGen1EnvironmentRe...

Nombre Descripción Valor
dataRetentionTime Intervalo de tiempo ISO8601 que especifica el número mínimo de días que los eventos del entorno estarán disponibles para la consulta. string (obligatorio)
partitionKeyProperties Lista de propiedades de evento que se usarán para crear particiones de datos en el entorno. Actualmente, solo se admite una sola propiedad de clave de partición. TimeSeriesIdProperty[]
storageLimitExceededBehavior El comportamiento que el servicio Time Series Insights debe tomar cuando se ha superado la capacidad del entorno. Si se especifica "PauseIngress", los nuevos eventos no se leerán desde el origen del evento. Si se especifica "PurgeOldData", los nuevos eventos seguirán leyendo y los eventos antiguos se eliminarán del entorno. El comportamiento predeterminado es PurgeOldData. 'PauseIngress'
'PurgeOldData'

TimeSeriesIdProperty

Nombre Descripción Value
name El nombre de la propiedad. string
type Tipo de la propiedad. 'String'

Gen2EnvironmentCreateOrUpdateParametersOrGen2Environ...

Nombre Descripción Valor
kind El tipo de entorno. 'Gen2' (obligatorio)
properties Propiedades usadas para crear un entorno de Gen2. Gen2EnvironmentCreationPropertiesOrGen2EnvironmentRe... (obligatorio)

Gen2EnvironmentCreationPropertiesOrGen2EnvironmentRe...

Nombre Descripción Valor
storageConfiguration La configuración de almacenamiento proporciona los detalles de conexión que permiten al servicio Time Series Insights conectarse a la cuenta de almacenamiento del cliente que se usa para almacenar los datos del entorno. Gen2StorageConfigurationInputOrGen2StorageConfigurat... (obligatorio)
timeSeriesIdProperties Lista de propiedades de evento que se usarán para definir el identificador de serie temporal del entorno. TimeSeriesIdProperty[] (obligatorio)
warmStoreConfiguration La configuración del almacenamiento intermedio proporciona los detalles para crear una caché de almacenamiento intermedio que conservará una copia de los datos del entorno disponibles para una consulta más rápida. WarmStoreConfigurationProperties

Gen2StorageConfigurationInputOrGen2StorageConfigurat...

Nombre Descripción Valor
accountName Nombre de la cuenta de almacenamiento que contendrá los datos gen2 del entorno. string (obligatorio)
managementKey Valor de la clave de administración que concede al servicio Time Series Insights acceso de escritura a la cuenta de almacenamiento. Esta propiedad no se muestra en las respuestas del entorno. string (obligatorio)

WarmStoreConfigurationProperties

Nombre Descripción Valor
dataRetention Intervalo de tiempo ISO8601 que especifica el número de días en que los eventos del entorno estarán disponibles para la consulta desde el almacén intermedio. string (obligatorio)

SKU

Nombre Descripción Valor
capacity Capacidad de la SKU. En el caso de los entornos de Gen1, este valor se puede cambiar para admitir la escalabilidad horizontal de los entornos una vez creados. int (obligatorio)
name Nombre de esta SKU. 'L1'
'P1'
'S1'
'S2' (obligatorio)

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Crear un entorno de pago por uso (PAYG) con una IoT Hub

Implementación en Azure		 Esta plantilla le permite implementar un entorno de Time Series Insights de pago por uso (PAYG) configurado para consumir eventos de una IoT Hub.
Creación de un entorno con un origen de eventos del centro de eventos

Implementación en Azure		 Esta plantilla le permite implementar un entorno de Time Series Insights configurado para consumir eventos de un centro de eventos.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso environments se puede implementar con operaciones que tienen como destino:

  • Grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.TimeSeriesInsights/environments, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.TimeSeriesInsights/environments@2020-05-15"
  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"
  })
}

objetos environments

Establezca la propiedad kind para especificar el tipo de objeto.

Para Gen1, use:

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

Para Gen2, use:

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

Valores de propiedad

environments

Nombre Descripción Value
type Tipo de recurso "Microsoft.TimeSeriesInsights/environments@2020-05-15"
name El nombre del recurso string (obligatorio)

Límite de caracteres: 1-90

Caracteres válidos:
No puede usar:
'<>%&:\?/# ni caracteres de control
ubicación Ubicación del recurso. string (obligatorio)
parent_id Para realizar la implementación en un grupo de recursos, use el identificador de ese grupo de recursos. string (obligatorio)
etiquetas Pares clave-valor de propiedades adicionales para el recurso. Diccionario de nombres y valores de etiqueta.
sku La SKU determina el tipo de entorno, ya sea Gen1 (S1 o S2) o Gen2 (L1). En el caso de los entornos de Gen1, la SKU determina la capacidad del entorno, la tasa de entrada y la tasa de facturación. SKU (obligatorio)
kind Establecimiento del tipo de objeto Gen1
Gen2 (obligatorio)

Gen1EnvironmentCreateOrUpdateParametersOrGen1Environ...

Nombre Descripción Valor
kind El tipo de entorno. "Gen1" (obligatorio)
properties Propiedades usadas para crear un entorno de Gen1. Gen1EnvironmentCreationPropertiesOrGen1EnvironmentRe... (obligatorio)

Gen1EnvironmentCreationPropertiesOrGen1EnvironmentRe...

Nombre Descripción Valor
dataRetentionTime Intervalo de tiempo ISO8601 que especifica el número mínimo de días que los eventos del entorno estarán disponibles para la consulta. string (obligatorio)
partitionKeyProperties Lista de propiedades de evento que se usarán para crear particiones de datos en el entorno. Actualmente, solo se admite una sola propiedad de clave de partición. TimeSeriesIdProperty[]
storageLimitExceededBehavior El comportamiento que el servicio Time Series Insights debe tomar cuando se ha superado la capacidad del entorno. Si se especifica "PauseIngress", los nuevos eventos no se leerán desde el origen del evento. Si se especifica "PurgeOldData", los nuevos eventos seguirán leyendo y los eventos antiguos se eliminarán del entorno. El comportamiento predeterminado es PurgeOldData. "PauseIngress"
"PurgeOldData"

TimeSeriesIdProperty

Nombre Descripción Value
name El nombre de la propiedad. string
type Tipo de la propiedad. "String"

Gen2EnvironmentCreateOrUpdateParametersOrGen2Environ...

Nombre Descripción Valor
kind El tipo de entorno. "Gen2" (obligatorio)
properties Propiedades usadas para crear un entorno de Gen2. Gen2EnvironmentCreationPropertiesOrGen2EnvironmentRe... (obligatorio)

Gen2EnvironmentCreationPropertiesOrGen2EnvironmentRe...

Nombre Descripción Valor
storageConfiguration La configuración de almacenamiento proporciona los detalles de conexión que permiten al servicio Time Series Insights conectarse a la cuenta de almacenamiento del cliente que se usa para almacenar los datos del entorno. Gen2StorageConfigurationInputOrGen2StorageConfigurat... (obligatorio)
timeSeriesIdProperties Lista de propiedades de evento que se usarán para definir el identificador de serie temporal del entorno. TimeSeriesIdProperty[] (obligatorio)
warmStoreConfiguration La configuración del almacenamiento intermedio proporciona los detalles para crear una caché de almacenamiento intermedio que conservará una copia de los datos del entorno disponibles para una consulta más rápida. WarmStoreConfigurationProperties

Gen2StorageConfigurationInputOrGen2StorageConfigurat...

Nombre Descripción Valor
accountName Nombre de la cuenta de almacenamiento que contendrá los datos gen2 del entorno. string (obligatorio)
managementKey Valor de la clave de administración que concede al servicio Time Series Insights acceso de escritura a la cuenta de almacenamiento. Esta propiedad no se muestra en las respuestas del entorno. string (obligatorio)

WarmStoreConfigurationProperties

Nombre Descripción Valor
dataRetention Intervalo de tiempo ISO8601 que especifica el número de días en que los eventos del entorno estarán disponibles para la consulta desde el almacén intermedio. string (obligatorio)

SKU

Nombre Descripción Valor
capacity Capacidad de la SKU. En el caso de los entornos de Gen1, este valor se puede cambiar para admitir la escalabilidad horizontal de los entornos una vez creados. int (obligatorio)
name Nombre de esta SKU. "L1"
"P1"
"S1"
"S2" (obligatorio)