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:
ouAWS:
. Os valores podem ter esse prefixo. Se um valor de tag tiveraws
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 chaveaws
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: