Para obtener capacidades similares a las de Amazon Timestream, considere Amazon Timestream LiveAnalytics para InfluxDB. Ofrece una ingesta de datos simplificada y tiempos de respuesta a las consultas en milisegundos de un solo dígito para realizar análisis en tiempo real. Obtenga más información [aquí](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# CreateScheduledQuery
<a name="API_query_CreateScheduledQuery"></a>

 Crear una consulta programada que se ejecutará en su nombre según la programación configurada. Timestream asume la función de ejecución proporcionada como parte del parámetro `ScheduledQueryExecutionRoleArn` para ejecutar la consulta. Puede usar el parámetro `NotificationConfiguration` para configurar la notificación de las operaciones de consulta programadas.

## Sintaxis de la solicitud
<a name="API_query_CreateScheduledQuery_RequestSyntax"></a>

```
{
   "ClientToken": "string",
   "ErrorReportConfiguration": { 
      "S3Configuration": { 
         "BucketName": "string",
         "EncryptionOption": "string",
         "ObjectKeyPrefix": "string"
      }
   },
   "KmsKeyId": "string",
   "Name": "string",
   "NotificationConfiguration": { 
      "SnsConfiguration": { 
         "TopicArn": "string"
      }
   },
   "QueryString": "string",
   "ScheduleConfiguration": { 
      "ScheduleExpression": "string"
   },
   "ScheduledQueryExecutionRoleArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TargetConfiguration": { 
      "TimestreamConfiguration": { 
         "DatabaseName": "string",
         "DimensionMappings": [ 
            { 
               "DimensionValueType": "string",
               "Name": "string"
            }
         ],
         "MeasureNameColumn": "string",
         "MixedMeasureMappings": [ 
            { 
               "MeasureName": "string",
               "MeasureValueType": "string",
               "MultiMeasureAttributeMappings": [ 
                  { 
                     "MeasureValueType": "string",
                     "SourceColumn": "string",
                     "TargetMultiMeasureAttributeName": "string"
                  }
               ],
               "SourceColumn": "string",
               "TargetMeasureName": "string"
            }
         ],
         "MultiMeasureMappings": { 
            "MultiMeasureAttributeMappings": [ 
               { 
                  "MeasureValueType": "string",
                  "SourceColumn": "string",
                  "TargetMultiMeasureAttributeName": "string"
               }
            ],
            "TargetMultiMeasureName": "string"
         },
         "TableName": "string",
         "TimeColumn": "string"
      }
   }
}
```

## Parámetros de la solicitud
<a name="API_query_CreateScheduledQuery_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ClientToken](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ClientToken"></a>
El uso de a ClientToken hace que la llamada sea CreateScheduledQuery idempotente, en otras palabras, hacer la misma solicitud repetidamente producirá el mismo resultado. Hacer varias CreateScheduledQuery solicitudes idénticas tiene el mismo efecto que hacer una sola solicitud.   
+  Si CreateScheduledQuery se llama sin una`ClientToken`, el SDK de consultas genera una `ClientToken` en tu nombre.
+  Después de 8 horas, cualquier solicitud con el mismo `ClientToken` es tratada como una nueva solicitud. 
Tipo: cadena  
Restricciones de longitud: longitud mínima de 32. Longitud máxima de 128.  
Obligatorio: no

 ** [ErrorReportConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ErrorReportConfiguration"></a>
Configuración para el informe de errores. Se generarán informes de errores cuando se encuentre un problema al escribir los resultados de la consulta.   
Tipo: objeto [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md)  
Obligatorio: sí

 ** [KmsKeyId](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-KmsKeyId"></a>
La clave de Amazon KMS usada para cifrar el recurso de consulta programada, en reposo. Si no se especifica la clave de Amazon KMS, el recurso de consulta programada se cifrará con una clave de Amazon KMS propiedad de Timestream. Para especificar una clave KMS, utilice el ID de la clave, ARN de la clave, el nombre de alias o el ARN del alias. Cuando utilice un nombre del alias, anteponga el nombre con *alias/*   
Si `SSE_KMS` se ErrorReportConfiguration utiliza como tipo de cifrado, KmsKeyId se utiliza lo mismo para cifrar el informe de errores en reposo.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: no

 ** [Name](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-Name"></a>
Nombre de la consulta programada.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `[a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+`   
Obligatorio: sí

 ** [NotificationConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-NotificationConfiguration"></a>
Configuración de notificaciones para la consulta programada. Timestream envía una notificación cuando finaliza la ejecución de una consulta, cuando se actualiza el estado o cuando se elimina.   
Tipo: objeto [NotificationConfiguration](API_query_NotificationConfiguration.md)  
Obligatorio: sí

 ** [QueryString](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-QueryString"></a>
La cadena de consulta que se ejecutará. Los nombres de los parámetros se pueden especificar en la cadena de consulta `@` seguida de un identificador. El parámetro denominado `@scheduled_runtime` está reservado y se puede usar en la consulta para obtener la hora a la que está programada la ejecución de la consulta.  
La marca de tiempo calculada en función del ScheduleConfiguration parámetro será el valor del `@scheduled_runtime` parámetro para cada consulta que se ejecute. Por ejemplo, considere una instancia de una consulta programada que se ejecuta el 01-12-2021 00:00:00. Para esta instancia, el parámetro `@scheduled_runtime` se inicializa en la marca de tiempo 01-12-2021 00:00:00 al invocar la consulta.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 262144 caracteres.  
Obligatorio: sí

 ** [ScheduleConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ScheduleConfiguration"></a>
La configuración programada para la consulta.  
Tipo: objeto [ScheduleConfiguration](API_query_ScheduleConfiguration.md)  
Obligatorio: sí

 ** [ScheduledQueryExecutionRoleArn](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-ScheduledQueryExecutionRoleArn"></a>
El ARN para el rol de IAM que Timestream asumirá al ejecutar la consulta programada.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Obligatorio: sí

 ** [Tags](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-Tags"></a>
Lista de pares clave-valor para etiquetar la consulta programada.  
Tipo: matriz de objetos [Tag](API_query_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

 ** [TargetConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) **   <a name="timestream-query_CreateScheduledQuery-request-TargetConfiguration"></a>
Configuración que se utiliza para escribir el resultado de una consulta.  
Tipo: objeto [TargetConfiguration](API_query_TargetConfiguration.md)  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_query_CreateScheduledQuery_ResponseSyntax"></a>

```
{
   "Arn": "string"
}
```

## Elementos de respuesta
<a name="API_query_CreateScheduledQuery_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [Arn](#API_query_CreateScheduledQuery_ResponseSyntax) **   <a name="timestream-query_CreateScheduledQuery-response-Arn"></a>
ARN para la consulta programada que se creó.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.

## Errores
<a name="API_query_CreateScheduledQuery_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No cuenta con los permisos necesarios para acceder a la configuración de la cuenta.  
Código de estado HTTP: 400

 ** ConflictException **   
 No se pudo sondear los resultados de una consulta cancelada.   
Código de estado HTTP: 400

 ** InternalServerException **   
Se produjo un error de servidor interno al procesar la solicitud.  
Código de estado HTTP: 400

 ** InvalidEndpointException **   
El punto de conexión solicitado no es válido.  
Código de estado HTTP: 400

 ** ServiceQuotaExceededException **   
Superó la cuota de servicio.  
Código de estado HTTP: 400

 ** ThrottlingException **   
La solicitud se retrasó debido a una cantidad excesiva de solicitudes.  
Código de estado HTTP: 400

 ** ValidationException **   
 Solicitud no válida o con formato incorrecto.   
Código de estado HTTP: 400

## Véase también
<a name="API_query_CreateScheduledQuery_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CreateScheduledQuery) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CreateScheduledQuery)