CreateForecastExportJob - Amazon Forecast
Sintaxe da SolicitaçãoParâmetros da solicitaçãoSintaxe da RespostaElementos de RespostaErrosConsulte também

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 (YYYY-MM-DDTHH-MM-ssz).

Você deve especificar um objeto DataDestination que inclua um perfil do 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.

Para ter 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 dados a seguir no formato JSON.

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, Destination deverá incluir uma chave AWS Key Management Service (KMS). O perfil do IAM 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 excluir.

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

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 pode ter apenas um valor.

  • Comprimento máximo da chave: 128 caracteres Unicode em UTF-8.

  • Comprimento 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. Em geral, os caracteres 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 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.

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

Os dados a seguir são retornados no formato JSON 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.

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: