O Amazon Forecast não está mais disponível para novos clientes. Os clientes existentes do Amazon Forecast podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # CreateAutoPredictor Cria um preditor do Amazon Forecast. **Importante** O Amazon Forecast não está mais disponível para novos clientes. Os clientes existentes do Amazon Forecast podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) O Amazon Forecast cria preditores com AutoPredictor, o que envolve a aplicação da combinação ideal de algoritmos a cada série temporal em seus conjuntos de dados. Você pode usar [CreateAutoPredictor](#API_CreateAutoPredictor) para criar novos preditores ou fazer upgrade/retreinar preditores existentes. **Criação de preditores** Os seguintes parâmetros são obrigatórios ao criar um novo preditor: + `PredictorName` - Um nome exclusivo para o preditor. + `DatasetGroupArn` - O ARN do grupo de conjuntos de dados usado para treinar o preditor. + `ForecastFrequency` - A granularidade de suas previsões (por hora, diariamente, semanalmente etc.). + `ForecastHorizon` - O número de etapas temporais que o modelo prevê. O horizonte de predição também é chamado de comprimento da predição. Ao criar um novo preditor, não especifique um valor para `ReferencePredictorArn`. **Como fazer upgrade de preditores e treiná-los novamente** Os seguintes parâmetros são obrigatórios para fazer upgrade de um preditor ou treiná-lo novamente. + `PredictorName` - Um nome exclusivo para o preditor. + `ReferencePredictorArn` - O ARN do preditor a ser submetido a upgrade ou a um novo treinamento. Ao fazer upgrade de um preditor ou treiná-lo novamente, especifique apenas valores para `ReferencePredictorArn` e `PredictorName`. ## Sintaxe da solicitação ``` { "DataConfig": { "AdditionalDatasets": [ { "Configuration": { "string" : [ "string" ] }, "Name": "string" } ], "AttributeConfigs": [ { "AttributeName": "string", "Transformations": { "string" : "string" } } ], "DatasetGroupArn": "string" }, "EncryptionConfig": { "KMSKeyArn": "string", "RoleArn": "string" }, "ExplainPredictor": boolean, "ForecastDimensions": [ "string" ], "ForecastFrequency": "string", "ForecastHorizon": number, "ForecastTypes": [ "string" ], "MonitorConfig": { "MonitorName": "string" }, "OptimizationMetric": "string", "PredictorName": "string", "ReferencePredictorArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "TimeAlignmentBoundary": { "DayOfMonth": number, "DayOfWeek": "string", "Hour": number, "Month": "string" } } ``` ## Parâmetros da solicitação A solicitação aceita os dados a seguir no formato JSON. ** [DataConfig](#API_CreateAutoPredictor_RequestSyntax) ** A configuração de dados do seu grupo de conjuntos de dados e de quaisquer conjuntos de dados adicionais. Tipo: objeto [DataConfig](API_DataConfig.md) Obrigatório: não ** [EncryptionConfig](#API_CreateAutoPredictor_RequestSyntax) ** Uma chave AWS Key Management Service (KMS) e uma função AWS Identity and Access Management (IAM) que o Amazon Forecast pode assumir para acessar a chave. Você pode especificar esse objeto opcional nas solicitações [CreateDataset](API_CreateDataset.md) e [CreatePredictor](API_CreatePredictor.md). Tipo: objeto [EncryptionConfig](API_EncryptionConfig.md) Obrigatório: não ** [ExplainPredictor](#API_CreateAutoPredictor_RequestSyntax) ** Crie um recurso de explicabilidade para o preditor. Tipo: booliano Obrigatório: não ** [ForecastDimensions](#API_CreateAutoPredictor_RequestSyntax) ** Uma matriz de nomes de dimensão (campo) que especificam como agrupar a previsão gerada. Por exemplo, se você estiver gerando previsões de vendas de itens em todas as suas lojas e seu conjunto de dados contiver um campo `store_id`, você especificaria `store_id` como uma dimensão para agrupar as previsões de vendas de cada loja. Tipo: matriz de strings Membros da matriz: número mínimo de 1 item. Número máximo de 10 itens. Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 63. Padrão: `^[a-zA-Z][a-zA-Z0-9_]*` Obrigatório: não ** [ForecastFrequency](#API_CreateAutoPredictor_RequestSyntax) ** A frequência das previsões em uma previsão. Os intervalos válidos são um número inteiro seguido de Y (ano), M (mês), W (semana), D (dia), H (hora) e min (minuto). Por exemplo, "1D" indica todos os dias e "15min" indica a cada 15 minutos. Você não pode especificar um valor que se sobreporia à próxima frequência maior. Isso significa, por exemplo, que você não pode especificar uma frequência de 60 minutos, porque isso equivale a 1 hora. Os valores válidos para cada frequência são os seguintes: + Minuto: 1 a 59 + Hora: 1 a 23 + Dia: 1 a 6 + Semana: 1 a 4 + Mês: 1 a 11 + Year (Ano): 1 Assim, se você quiser previsões a cada duas semanas, especifique "2W". Ou, se quiser previsões trimestrais, especifique "3M". A frequência deve ser maior ou igual à frequência de conjunto de dados TARGET\$1TIME\$1SERIES. Quando um conjunto de dados RELATED\$1TIME\$1SERIES é fornecido, a frequência deve ser igual à frequência de conjunto de dados RELATED\$1TIME\$1SERIES. Tipo: string Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 5. Padrão: `^Y|M|W|D|H|30min|15min|10min|5min|1min$` Obrigatório: não ** [ForecastHorizon](#API_CreateAutoPredictor_RequestSyntax) ** O número de etapas temporais que o modelo prevê. O horizonte de predição também é chamado de comprimento da predição. O horizonte máximo de previsão é o menor entre 500 etapas temporais ou 1/4 do tamanho do conjunto de dados TARGET\$1TIME\$1SERIES. Se você estiver treinando novamente um existente AutoPredictor, o horizonte máximo de previsão será o menor de 500 intervalos de tempo ou 1/3 do tamanho do conjunto de dados TARGET\$1TIME\$1SERIES. Se você estiver atualizando AutoPredictor ou retreinando um existente AutoPredictor, não poderá atualizar o parâmetro do horizonte de previsão. Você pode atender a esse requisito fornecendo séries temporais mais longas no conjunto de dados. Tipo: inteiro Obrigatório: não ** [ForecastTypes](#API_CreateAutoPredictor_RequestSyntax) ** Os tipos de previsão usados para treinar um preditor. Você pode especificar até cinco tipos de previsão. Os tipos de previsão podem ser quantis de 0,01 a 0,99, em incrementos de 0,01 ou mais. Você também pode especificar a previsão média com `mean`. Tipo: matriz de strings Membros da matriz: número mínimo de 1 item. Número máximo de 20 itens. Restrições de tamanho: o tamanho mínimo é 2. O tamanho máximo é 4. Padrão: `(^0?\.\d\d?$|^mean$)` Obrigatório: não ** [MonitorConfig](#API_CreateAutoPredictor_RequestSyntax) ** Os detalhes da configuração do monitoramento de preditores. Forneça um nome exclusivo para o recurso de monitor a fim de habilitar o monitoramento do preditor. O monitoramento de preditores permite que você veja como o desempenho do seu preditor muda ao longo do tempo. Para obter mais informações, consulte [Monitoramento de preditores](https://docs.aws.amazon.com/forecast/latest/dg/predictor-monitoring.html). Tipo: objeto [MonitorConfig](API_MonitorConfig.md) Obrigatório: não ** [OptimizationMetric](#API_CreateAutoPredictor_RequestSyntax) ** A métrica de precisão usada para otimizar o preditor. Tipo: string Valores válidos: `WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE` Obrigatório: não ** [PredictorName](#API_CreateAutoPredictor_RequestSyntax) ** Um nome exclusivo para o preditor Tipo: string Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 63. Padrão: `^[a-zA-Z][a-zA-Z0-9_]*` Obrigatório: Sim ** [ReferencePredictorArn](#API_CreateAutoPredictor_RequestSyntax) ** O ARN do preditor a ser submetido a upgrade ou a um novo treinamento. Este parâmetro só é usado quando um preditor é submetido a upgrade ou a um novo treinamento. Ao criar um novo preditor, não especifique um valor para este parâmetro. Ao fazer upgrade de um preditor ou treiná-lo novamente, especifique apenas valores para `ReferencePredictorArn` e `PredictorName`. O valor de `PredictorName` deve ser um nome de preditor exclusivo. Tipo: string Restrições de tamanho: o tamanho máximo é 256. Padrão: `arn:([a-z\d-]+):forecast:.*:.*:.+` Obrigatório: não ** [Tags](#API_CreateAutoPredictor_RequestSyntax) ** Os metadados opcionais que ajudam você a categorizar e organizar seus preditores. Cada tag consiste de uma chave e um valor opcional, que podem ser definidos. As chaves e valores das tags diferenciam maiúsculas de minúsculas. As restrições a seguir se aplicam às tags: + Em todos os recursos, cada chave de tag deve ser exclusiva e ter apenas um valor. + Número máximo de tags por recurso: 50. + Comprimento máximo da chave: 128 caracteres Unicode em UTF-8. + Comprimento máximo do valor: 256 caracteres Unicode em UTF-8. + Caracteres aceitos: todas as letras, números e espaços representáveis em UTF-8 e os símbolos \$1 - = . \$1 : / @. Se seu esquema de tags for usado em outros serviços e recursos, as restrições de caracteres desses serviços também serão aplicáveis. + Os prefixos de teclas não podem incluir nenhuma combinação de letras maiúsculas ou minúsculas de `aws:` ou `AWS:`. Os valores podem ter esse prefixo. Se um valor de tag tiver `aws` como prefixo, mas a chave não, o Forecast o considerará uma tag de usuário e o contabilizará no limite de 50 tags. As tags que têm apenas o prefixo de chave `aws` não são contabilizadas entre suas tags por limite de recurso. Você não pode editar nem excluir chaves de tag com esse prefixo. Tipo: matriz de objetos [Tag](API_Tag.md) Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens. Obrigatório: não ** [TimeAlignmentBoundary](#API_CreateAutoPredictor_RequestSyntax) ** O limite de tempo que o Forecast usa para alinhar e agregar quaisquer dados que não estejam alinhados à sua frequência de previsão. Forneça a unidade de tempo e o limite de tempo como um par chave-valor. Para obter mais informações sobre como especificar um limite de tempo, consulte [Como especificar um limite de tempo](https://docs.aws.amazon.com/forecast/latest/dg/data-aggregation.html#specifying-time-boundary). Se você não fornecer um limite de tempo, o Forecast usará um conjunto de [Limites de tempo padrão](https://docs.aws.amazon.com/forecast/latest/dg/data-aggregation.html#default-time-boundaries). Tipo: objeto [TimeAlignmentBoundary](API_TimeAlignmentBoundary.md) Obrigatório: não ## Sintaxe da resposta ``` { "PredictorArn": "string" } ``` ## Elementos de resposta Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200. Os dados a seguir são retornados no formato JSON pelo serviço. ** [PredictorArn](#API_CreateAutoPredictor_ResponseSyntax) ** O nome do recurso da Amazon (ARN) do preditor. Tipo: string Restrições de tamanho: o tamanho máximo é 256. Padrão: `arn:([a-z\d-]+):forecast:.*:.*:.+` ## Erros ** InvalidInputException ** Não podemos processar a solicitação porque ela inclui um valor inválido ou um valor que excede o intervalo válido. Código de status HTTP: 400 ** LimitExceededException ** O limite do número de recursos por conta foi excedido. Código de status HTTP: 400 ** ResourceAlreadyExistsException ** Já existe um recurso com esse nome. Tente novamente com outro nome. Código de status HTTP: 400 ** ResourceInUseException ** O recurso especificado está em uso. Código de status HTTP: 400 ** ResourceNotFoundException ** Não conseguimos encontrar um recurso com esse nome do recurso da Amazon (ARN). Verifique o ARN e tente novamente. Código de Status HTTP: 400 ## Consulte também Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateAutoPredictor) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateAutoPredictor) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateAutoPredictor) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateAutoPredictor) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateAutoPredictor) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateAutoPredictor) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateAutoPredictor) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateAutoPredictor) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateAutoPredictor) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateAutoPredictor)