ListForecasts - Amazon Forecast
Sintaxis de la solicitudParámetros de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

Amazon Forecast ya no está disponible para nuevos clientes. Los clientes actuales de Amazon Forecast pueden seguir utilizando el servicio con normalidad. Más información

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.

ListForecasts

Devuelve una lista de las previsiones creadas mediante la operación CreateForecast. Para cada previsión, esta operación devuelve un resumen de sus propiedades, incluido su nombre de recurso de Amazon (ARN). Para recuperar el conjunto completo de propiedades, especifique las propiedades ARN junto con la DescribeForecast operación. Puede filtrar la lista mediante una matriz de objetos Filter.

importante

Amazon Forecast ya no está disponible para nuevos clientes. Los clientes actuales de Amazon Forecast pueden seguir utilizando el servicio con normalidad. Más información

Sintaxis de la solicitud

{
   "Filters": [ 
      { 
         "Condition": "string",
         "Key": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}

Parámetros de la solicitud

La solicitud acepta los siguientes datos en JSON formato.

Filters

Matriz de filtros. Para cada filtro, proporcione una condición y una declaración de coincidencia. La condición es IS o IS_NOT, que especifica si se deben incluir o excluir de la lista las previsiones que coincidan con la declaración, respectivamente. La declaración de coincidencia consta de una clave y un valor.

Propiedades del filtro

  • Condition: la condición que se debe aplicar. Los valores válidos son IS y IS_NOT. Para incluir las previsiones que coincidan con la declaración, especifique IS. Para excluir las previsiones coincidentes, especifique IS_NOT.

  • Key: el nombre del parámetro con el que se va a filtrar. Los valores válidos son DatasetGroupArn, PredictorArn y Status.

  • Value: el valor que debe coincidir.

Por ejemplo, para enumerar todas las previsiones cuyo estado no lo seaACTIVE, debe especificar:

"Filters": [ { "Condition": "IS_NOT", "Key": "Status", "Value": "ACTIVE" } ]

Tipo: matriz de objetos Filter

Obligatorio: no

MaxResults

El número de artículos que se devuelve en la respuesta.

Tipo: entero

Rango válido: valor mínimo de 1. Valor máximo de 100.

Obligatorio: no

NextToken

Si el resultado de la solicitud anterior se truncó, la respuesta incluye un NextToken. Para recuperar el siguiente conjunto de resultados, utilice el token en la siguiente solicitud. Los tokens caducan tras 24 horas.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 3000.

Patrón: .+

Obligatorio: no

Sintaxis de la respuesta

{
   "Forecasts": [ 
      { 
         "CreatedUsingAutoPredictor": boolean,
         "CreationTime": number,
         "DatasetGroupArn": "string",
         "ForecastArn": "string",
         "ForecastName": "string",
         "LastModificationTime": number,
         "Message": "string",
         "PredictorArn": "string",
         "Status": "string"
      }
   ],
   "NextToken": "string"
}

Elementos de respuesta

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

El servicio devuelve los siguientes datos en JSON formato.

Forecasts

Una matriz de objetos que resumen las propiedades de cada previsión.

Tipo: matriz de objetos ForecastSummary

NextToken

Si la respuesta está truncada, Amazon Forecast devuelve este token. Para recuperar el siguiente conjunto de resultados, utilice el token en la siguiente solicitud.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 3000.

Patrón: .+

Errores

InvalidInputException

No podemos procesar la solicitud porque incluye un valor no válido o un valor que supera el rango válido.

HTTPCódigo de estado: 400

InvalidNextTokenException

El token no es válido. Los tokens caducan tras 24 horas.

HTTPCódigo de estado: 400

Véase también

Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente: