CreateForecastExportJob - Amazon Forecast
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

CreateForecastExportJob

Mengekspor perkiraan yang dibuat oleh CreateForecast operasi ke bucket Amazon Simple Storage Service (Amazon S3). Nama file perkiraan akan cocok dengan konvensi berikut:

<ForecastExportJobName>_<ExportTimestamp>_<PartNumber>

di mana komponen < ExportTimestamp > ada di Java SimpleDateFormat (yyyy-mm-ddthh-mm-ssz).

Anda harus menentukan DataDestination objek yang menyertakan peran AWS Identity and Access Management (IAM) yang dapat diasumsikan oleh Amazon Forecast untuk mengakses bucket Amazon S3. Untuk informasi selengkapnya, lihat Mengatur Izin untuk Amazon Forecast.

Untuk informasi selengkapnya, lihat Menghasilkan Prakiraan.

Untuk mendapatkan daftar semua pekerjaan ekspor perkiraan Anda, gunakan ListForecastExportJobs operasi.

catatan

Pekerjaan ekspor perkiraan harus ACTIVE sebelum Anda dapat mengakses perkiraan di bucket Amazon S3 Anda. Status Untuk mendapatkan status, gunakan DescribeForecastExportJob operasi.

Sintaksis Permintaan

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

Parameter Permintaan

Permintaan menerima data berikut dalam format JSON.

Destination

Lokasi tempat Anda ingin menyimpan perkiraan dan peran AWS Identity and Access Management (IAM) yang dapat diasumsikan oleh Amazon Forecast untuk mengakses lokasi. Perkiraan harus diekspor ke ember Amazon S3.

Jika enkripsi digunakan, Destination harus menyertakan kunci AWS Key Management Service (KMS). Peran IAM harus mengizinkan izin Amazon Forecast untuk mengakses kunci.

Tipe: Objek DataDestination

Wajib: Ya

ForecastArn

Nama Sumber Daya Amazon (ARN) dari perkiraan yang ingin Anda ekspor.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Pola: arn:([a-z\d-]+):forecast:.*:.*:.+

Wajib: Ya

ForecastExportJobName

Nama untuk pekerjaan ekspor perkiraan.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.

Pola: ^[a-zA-Z][a-zA-Z0-9_]*

Wajib: Ya

Format

Format data yang diekspor, CSV atau PARQUET. Nilai defaultnya adalah CSV.

Jenis: String

Kendala Panjang: Panjang maksimum 7.

Pola: ^CSV|PARQUET$

Wajib: Tidak

Tags

Metadata opsional yang Anda terapkan pada pekerjaan ekspor perkiraan untuk membantu Anda mengkategorikan dan mengaturnya. Setiap tag terdiri dari kunci dan nilai opsional, yang keduanya Anda tentukan.

Batasan dasar berikut berlaku untuk tag:

  • Jumlah maksimum tag per sumber daya - 50.

  • Untuk setiap sumber daya, setiap kunci tag harus unik, dan setiap kunci tag hanya dapat memiliki satu nilai.

  • Panjang kunci maksimum - 128 karakter Unicode di UTF-8.

  • Panjang nilai maksimum - 256 karakter Unicode di UTF-8.

  • Jika skema penandaan Anda digunakan di beberapa layanan dan sumber daya, ingatlah bahwa layanan lain mungkin memiliki pembatasan pada karakter yang diizinkan. Karakter-karakter yang diizinkan secara umum adalah: huruf, angka, dan spasi yang dapat diwakili dalam UTF-8, beserta karakter-karakter berikut: + - = . _ : / @.

  • Kunci dan nilai tanda peka huruf besar-kecil.

  • Jangan gunakanaws:,AWS:, atau kombinasi huruf besar atau kecil seperti awalan untuk kunci karena dicadangkan untuk digunakan. AWS Anda tidak dapat mengedit atau menghapus kunci tag dengan awalan ini. Nilai dapat memiliki awalan ini. Jika nilai tag memiliki aws awalan tetapi kuncinya tidak, maka Forecast menganggapnya sebagai tag pengguna dan akan dihitung terhadap batas 50 tag. Tag dengan hanya key prefix dari aws tidak dihitung terhadap tag Anda per batas sumber daya.

Tipe: Array objek Tag

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.

Wajib: Tidak

Sintaksis Respons

{
   "ForecastExportJobArn": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

ForecastExportJobArn

Nama Sumber Daya Amazon (ARN) dari pekerjaan ekspor.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Pola: arn:([a-z\d-]+):forecast:.*:.*:.+

Kesalahan

InvalidInputException

Kami tidak dapat memproses permintaan karena menyertakan nilai yang tidak valid atau nilai yang melebihi rentang yang valid.

Kode Status HTTP: 400

LimitExceededException

Batas jumlah sumber daya per akun telah terlampaui.

Kode Status HTTP: 400

ResourceAlreadyExistsException

Sudah ada sumber daya dengan nama ini. Coba lagi dengan nama yang berbeda.

Kode Status HTTP: 400

ResourceInUseException

Sumber daya yang ditentukan sedang digunakan.

Kode Status HTTP: 400

ResourceNotFoundException

Kami tidak dapat menemukan sumber daya dengan Nama Sumber Daya Amazon (ARN) itu. Periksa ARN dan coba lagi.

Kode Status HTTP: 400

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: