CreatePredictorBacktestExportJob - Amazon Forecast

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á.

CreatePredictorBacktestExportJob

Exporta previsões de backtest e métricas de precisão geradas pelas operações CreateAutoPredictor ou CreatePredictor. Duas pastas contendo arquivos CSV ou Parquet são exportadas para o bucket do S3 especificado.

Os nomes de arquivo de exportação corresponderão às seguintes convenções:

<ExportJobName>_<ExportTimestamp>_<PartNumber>.csv

O componente < ExportTimestamp > está no SimpleDate formato Java (YYYY-MM-DDTHH-MM-ssz).

Você deve especificar um DataDestination objeto que inclua um bucket do Amazon S3 e uma função AWS Identity and Access Management (IAM) que o Amazon Forecast possa assumir para acessar o bucket do Amazon S3. Para ter mais informações, consulte Configurar permissões para o Amazon Forecast.

nota

O Status do trabalho de exportação deve ser ACTIVE para que você possa acessar a exportação no bucket do Amazon S3. Para obter o status, use a operação DescribePredictorBacktestExportJob.

Sintaxe da Solicitação

{ "Destination": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "Format": "string", "PredictorArn": "string", "PredictorBacktestExportJobName": "string", "Tags": [ { "Key": "string", "Value": "string" } ] }

Parâmetros da solicitação

A solicitação aceita os dados a seguir no formato JSON.

Destination

O destino de um trabalho de exportação. Forneça um caminho do S3, uma função AWS Identity and Access Management (IAM) que permite que o Amazon Forecast acesse o local e uma chave AWS Key Management Service (KMS) (opcional).

Tipo: objeto DataDestination

Obrigatório: Sim

Format

O formato dos dados exportados: CSV ou PARQUET. O valor padrão é CSV.

Tipo: string

Restrições de Tamanho: O tamanho máximo é 7.

Padrão: ^CSV|PARQUET$

Obrigatório: não

PredictorArn

O nome do recurso da Amazon (ARN) do preditor que você deseja exportar.

Tipo: string

Restrições de tamanho: o tamanho máximo é 256.

Padrão: arn:([a-z\d-]+):forecast:.*:.*:.+

Exigido: Sim

PredictorBacktestExportJobName

O nome do trabalho de exportação de backtest.

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_]*

Exigido: Sim

Tags

Metadados opcionais que ajudam você a categorizar e organizar seus backtests. Cada tag consiste em uma chave e um valor opcional, ambos definidos por você. 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 + - = . _ : / @. 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

Membros da Matriz: número mínimo de 0 itens. Número máximo de 200 itens.

Obrigatório: Não

Sintaxe da Resposta

{ "PredictorBacktestExportJobArn": "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.

PredictorBacktestExportJobArn

O nome do recurso da Amazon (ARN) do trabalho de exportação de backtest de preditor que você deseja exportar.

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 um dos AWS SDKs específicos da linguagem, consulte o seguinte: