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
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á.
CreateForecastExportJob
Exporta uma previsão criada pela operação CreateForecast para seu bucket do Amazon Simple Storage Service (Amazon S3). O nome do arquivo de previsão corresponderá às seguintes convenções:
<ForecastExportJobName>_<ExportTimestamp>_<PartNumber>
onde o componente < ExportTimestamp > está em Java SimpleDateFormat (aaaa-MM-dd -mm-sszTHH).
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
Você deve especificar um DataDestination objeto que inclua uma função AWS Identity and Access Management (IAM) que o Amazon Forecast possa assumir para acessar o bucket do Amazon S3. Para obter mais informações, consulte Configurar permissões para o Amazon Forecast.
Para obter mais informações, consulte Geração de previsões.
Para obter uma lista de todos os trabalhos de exportação de previsão, use a operação ListForecastExportJobs.
nota
O Status do trabalho de exportação de previsã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 DescribeForecastExportJob.
Sintaxe da Solicitação
{
"Destination": {
"S3Config": {
"KMSKeyArn": "string",
"Path": "string",
"RoleArn": "string"
}
},
"ForecastArn": "string",
"ForecastExportJobName": "string",
"Format": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}Parâmetros da solicitação
A solicitação aceita os seguintes dados no JSON formato.
- Destination
-
O local em que você deseja salvar a previsão e uma função AWS Identity and Access Management (IAM) que o Amazon Forecast pode assumir para acessar o local. A previsão deve ser exportada para um bucket do Amazon S3.
Se a criptografia for usada,
Destinationdeverá incluir uma chave AWS Key Management Service (KMS). A IAM função deve permitir que o Amazon Forecast acesse a chave.Tipo: objeto DataDestination
Obrigatório: Sim
- ForecastArn
-
O nome do recurso da Amazon (ARN) da previsão que você deseja exportar.
Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
Padrão:
arn:([a-z\d-]+):forecast:.*:.*:.+Exigido: Sim
- ForecastExportJobName
-
O nome do trabalho de exportação da previsão.
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
- Format
-
O formato dos dados exportados CSV ouPARQUET. O valor padrão éCSV.
Tipo: string
Restrições de Tamanho: O tamanho máximo é 7.
Padrão:
^CSV|PARQUET$Obrigatório: Não
- Tags
-
Os metadados opcionais que você aplica ao trabalho de exportação de previsão para categorizá-los e organizá-los. Cada tag consiste em uma chave e um valor opcional, ambos definidos por você.
As restrições básicas a seguir se aplicam a tags:
-
Número máximo de tags por recurso: 50.
-
Em todos os recursos, cada chave de tag deve ser exclusiva e possuir apenas um valor.
-
Tamanho máximo da chave - 128 caracteres Unicode em UTF -8.
-
Tamanho máximo do valor - 256 caracteres Unicode em UTF -8.
-
Caso seu esquema de marcação seja usado em vários serviços e recursos , lembre-se de que outros serviços podem possuir restrições em caracteres permitidos. Os caracteres geralmente permitidos são: letras, números e espaços representáveis em UTF -8 e os seguintes caracteres: + - =. _:/@.
-
As chaves e valores das tags diferenciam maiúsculas de minúsculas.
-
Não use
aws:AWS:, ou qualquer combinação de maiúsculas ou minúsculas, como um prefixo para teclas, pois está reservado para uso. AWS Você não pode editar nem excluir chaves de tag com esse prefixo. Os valores podem ter esse prefixo. Se um valor de tag tiverawscomo 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 chaveawsnão são contabilizadas entre suas tags por limite de recurso.
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
{
"ForecastExportJobArn": "string"
}Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP de 200.
Os dados a seguir são retornados em JSON formato pelo serviço.
- ForecastExportJobArn
-
O nome do recurso da Amazon (ARN) do trabalho de exportação.
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.
HTTPCódigo de status: 400
- LimitExceededException
-
O limite do número de recursos por conta foi excedido.
HTTPCódigo de status: 400
- ResourceAlreadyExistsException
-
Já existe um recurso com esse nome. Tente novamente com outro nome.
HTTPCódigo de status: 400
- ResourceInUseException
-
O recurso especificado está em uso.
HTTPCódigo de status: 400
- ResourceNotFoundException
-
Não conseguimos encontrar um recurso com esse nome de recurso da Amazon (ARN). Verifique ARN e tente novamente.
HTTPCódigo de status: 400
Consulte também
Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte:
