

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

# Antrean tugas
<a name="job_queues"></a>

Tugas dikirim ke antrean tugas yang menjadi tempatnya berada sampai tugas dapat dijadwalkan untuk berjalan di lingkungan komputasi. AWS Akun dapat memiliki beberapa antrian pekerjaan. Misalnya, Anda dapat membuat antrean yang menggunakan instans Sesuai Permintaan Amazon EC2 untuk tugas prioritas tinggi dan antrean lain yang menggunakan Instans Spot Amazon EC2 untuk tugas prioritas rendah. Antrean tugas memiliki prioritas yang digunakan oleh penjadwal untuk menentukan tugas mana di antrean mana yang harus dievaluasi untuk eksekusi terlebih dahulu.

**Topics**
+ [Membuat antrean tugas](create-job-queue.md)
+ [Lihat antrian pekerjaan di AWS Batch](job_queue_viewing_status.md)
+ [Hapus antrian pekerjaan di AWS Batch](delete-job-queue.md)
+ [Kebijakan penjadwalan saham adil](job_scheduling.md)
+ [Penjadwalan sadar sumber daya](resource-aware-scheduling.md)
+ [Manajemen kuota](quota-management.md)

# Membuat antrean tugas
<a name="create-job-queue"></a>

Sebelum Anda dapat mengirimkan pekerjaan AWS Batch, Anda harus membuat antrian pekerjaan. Saat membuat antrean pekerjaan, Anda mengaitkan satu atau beberapa lingkungan komputasi ke antrian dan menetapkan urutan preferensi.

Anda juga menetapkan prioritas ke antrean pekerjaan yang menentukan urutan yang ditempatkan oleh penjadwal AWS Batch. Ini berarti bahwa, jika lingkungan komputasi dikaitkan dengan lebih dari satu antrian pekerjaan, antrian pekerjaan dengan prioritas lebih tinggi diberikan preferensi.

**Topics**
+ [Buat antrian EC2 pekerjaan Amazon](create-job-queue-ec2.md)
+ [Buat antrian pekerjaan Fargate](create-job-queue-fargate.md)
+ [Buat antrian pekerjaan Amazon EKS](create-job-queue-eks.md)
+ [Buat antrian pekerjaan SageMaker Pelatihan di AWS Batch](create-sagemaker-job-queue.md)
+ [Templat antrean tugas](job-queue-template.md)

# Buat antrian EC2 pekerjaan Amazon
<a name="create-job-queue-ec2"></a>

Selesaikan langkah-langkah berikut untuk membuat antrean pekerjaan untuk Amazon Elastic Compute Cloud (Amazon EC2).

**Untuk membuat antrian EC2 pekerjaan Amazon**

1. Buka AWS Batch konsol di [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).

1. Dari bilah navigasi, pilih yang Wilayah AWS akan digunakan.

1. Di panel navigasi, pilih **Antrian pekerjaan**.

1. Pilih **Buat**.

1. Untuk **jenis Orkestrasi**, pilih Amazon **Elastic Compute Cloud (Amazon**). EC2

1. Untuk **Nama**, masukkan nama unik untuk antrian pekerjaan Anda. Namanya bisa mencapai 128 karakter, dan dapat berisi huruf besar dan kecil, angka, dan garis bawah (\$1).

1. Untuk **Prioritas**, masukkan nilai bilangan bulat untuk prioritas antrian pekerjaan. Antrian pekerjaan dengan prioritas lebih tinggi dijalankan sebelum antrian pekerjaan prioritas rendah yang terkait dengan lingkungan komputasi yang sama. Prioritas ditentukan dalam urutan menurun. Misalnya, antrean tugas dengan nilai prioritas 10 diberikan preferensi penjadwalan di atas antrean tugas dengan nilai prioritas 1.

1. (Opsional) Untuk **kebijakan Penjadwalan Nama Sumber Daya Amazon (ARN**), pilih kebijakan penjadwalan yang ada.

1. Untuk **lingkungan komputasi Terhubung**, pilih satu atau beberapa lingkungan komputasi dari daftar yang akan dikaitkan dengan antrian pekerjaan. Pilih lingkungan komputasi dalam urutan yang Anda inginkan antrian untuk mencoba penempatan antrian pekerjaan. Penjadwal pekerjaan menggunakan urutan tempat Anda memilih lingkungan komputasi untuk menentukan lingkungan komputasi mana yang memulai pekerjaan tertentu. Sebelum Anda dapat mengaitkannya dengan antrian pekerjaan, lingkungan komputasi harus dalam status. `VALID` Anda dapat mengaitkan hingga tiga lingkungan komputasi dengan antrean tugas. Jika Anda tidak memiliki lingkungan komputasi yang ada, pilih **Buat lingkungan komputasi**
**catatan**  
Semua lingkungan komputasi yang terkait dengan antrian pekerjaan harus berbagi model penyediaan yang sama. AWS Batch tidak mendukung pencampuran model penyediaan dalam satu antrian pekerjaan.

1. Untuk **urutan lingkungan Compute**, pilih panah atas dan bawah untuk mengonfigurasi urutan yang Anda inginkan.

1. Pilih **Buat antrian pekerjaan** untuk menyelesaikan dan membuat antrian pekerjaan Anda.

# Buat antrian pekerjaan Fargate
<a name="create-job-queue-fargate"></a>

Selesaikan langkah-langkah berikut untuk membuat antrean pekerjaan AWS Fargate.

**Untuk membuat antrian pekerjaan Fargate**

1. Buka AWS Batch konsol di [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).

1. Dari bilah navigasi, pilih yang Wilayah AWS akan digunakan.

1. Di panel navigasi, pilih **Antrian pekerjaan**.

1. Pilih **Buat**.

1. **Untuk **tipe Orkestrasi, pilih Fargate**.**

1. Untuk **Nama**, masukkan nama unik untuk antrian pekerjaan Anda. Namanya bisa mencapai 128 karakter, dan dapat berisi huruf besar dan kecil, angka, dan garis bawah (\$1).

1. Untuk **Prioritas**, masukkan nilai bilangan bulat untuk prioritas antrian pekerjaan. Antrian pekerjaan dengan prioritas lebih tinggi dijalankan sebelum antrian pekerjaan prioritas rendah yang terkait dengan lingkungan komputasi yang sama. Prioritas ditentukan dalam urutan menurun. Misalnya, antrean tugas dengan nilai prioritas 10 diberikan preferensi penjadwalan di atas antrean tugas dengan nilai prioritas 1.

1. (Opsional) Untuk **kebijakan Penjadwalan Nama Sumber Daya Amazon (ARN**), pilih kebijakan penjadwalan yang ada.

1. Untuk **lingkungan komputasi Terhubung**, pilih satu atau beberapa lingkungan komputasi dari daftar yang akan dikaitkan dengan antrian pekerjaan. Pilih lingkungan komputasi dalam urutan yang Anda inginkan antrean untuk mencoba penempatan antrian pekerjaan. Penjadwal pekerjaan menggunakan urutan tempat Anda memilih lingkungan komputasi untuk menentukan lingkungan komputasi mana yang memulai pekerjaan tertentu. Sebelum Anda dapat mengaitkannya dengan antrian pekerjaan, lingkungan komputasi harus dalam status. `VALID` Anda dapat mengaitkan hingga tiga lingkungan komputasi dengan antrean tugas.
**catatan**  
Semua lingkungan komputasi yang terkait dengan antrian pekerjaan harus berbagi model penyediaan yang sama. AWS Batch tidak mendukung pencampuran model penyediaan dalam satu antrian pekerjaan.

1. Untuk **urutan lingkungan Compute**, pilih panah atas dan bawah untuk mengonfigurasi urutan yang Anda inginkan.

1. Pilih **Buat antrean pekerjaan** untuk menyelesaikan dan membuat antrian pekerjaan Anda.

# Buat antrian pekerjaan Amazon EKS
<a name="create-job-queue-eks"></a>

Selesaikan langkah-langkah berikut untuk membuat antrean pekerjaan untuk Amazon Elastic Kubernetes Service (Amazon EKS).

**Untuk membuat antrian pekerjaan Amazon EKS**

1. Buka AWS Batch konsol di [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).

1. Dari bilah navigasi, pilih yang Wilayah AWS akan digunakan.

1. Di panel navigasi, pilih **Antrian pekerjaan**.

1. Pilih **Buat**.

1. Untuk **jenis Orkestrasi**, pilih **Amazon Elastic Kubernetes Service (Amazon** EKS).

1. Untuk **Nama**, masukkan nama unik untuk antrian pekerjaan Anda. Namanya bisa mencapai 128 karakter, dan dapat berisi huruf besar dan kecil, angka, dan garis bawah (\$1).

1. Untuk **Priority** (Prioritas), masukkan nilai integer untuk prioritas antrean tugas. Antrian pekerjaan dengan prioritas lebih tinggi dijalankan sebelum antrian pekerjaan prioritas rendah yang terkait dengan lingkungan komputasi yang sama. Prioritas ditentukan dalam urutan menurun. Misalnya, antrean tugas dengan nilai prioritas 10 diberikan preferensi penjadwalan di atas antrean tugas dengan nilai prioritas 1.

1. (Opsional) Untuk **kebijakan Penjadwalan Nama Sumber Daya Amazon (ARN**), pilih kebijakan penjadwalan yang ada.

1. Untuk **lingkungan komputasi Terhubung**, pilih satu atau beberapa lingkungan komputasi dari daftar yang akan dikaitkan dengan antrian pekerjaan. Pilih lingkungan komputasi dalam urutan yang Anda inginkan antrian untuk mencoba penempatan antrian pekerjaan. Penjadwal pekerjaan menggunakan urutan tempat Anda memilih lingkungan komputasi untuk menentukan lingkungan komputasi mana yang memulai pekerjaan tertentu. Sebelum Anda dapat mengaitkannya dengan antrian pekerjaan, lingkungan komputasi harus dalam status. `VALID` Anda dapat mengaitkan hingga tiga lingkungan komputasi dengan antrean tugas.
**catatan**  
Semua lingkungan komputasi yang terkait dengan antrian pekerjaan harus berbagi model penyediaan yang sama. AWS Batch tidak mendukung pencampuran model penyediaan dalam satu antrian pekerjaan.
**catatan**  
Semua lingkungan komputasi yang terkait dengan antrian pekerjaan harus berbagi arsitektur yang sama. AWS Batch tidak mendukung pencampuran tipe arsitektur lingkungan komputasi dalam satu antrian pekerjaan.

1. Untuk **urutan lingkungan Compute**, pilih panah atas dan bawah untuk mengonfigurasi urutan yang Anda inginkan.

1. Pilih **Buat antrian pekerjaan** untuk menyelesaikan dan membuat antrian pekerjaan Anda.

# Buat antrian pekerjaan SageMaker Pelatihan di AWS Batch
<a name="create-sagemaker-job-queue"></a>

SageMaker Antrian pekerjaan pelatihan terintegrasi langsung dengan layanan SageMaker AI untuk menyediakan penjadwalan pekerjaan tanpa server tanpa mengharuskan Anda mengelola infrastruktur komputasi yang mendasarinya.

## Prasyarat
<a name="sagemaker-job-queue-prerequisites"></a>

Sebelum membuat antrian pekerjaan SageMaker Pelatihan, pastikan Anda memiliki:
+ **Lingkungan layanan** — Lingkungan layanan yang mendefinisikan batas kapasitas. Untuk informasi selengkapnya, lihat [Menciptakan lingkungan layanan di AWS Batch](create-service-environments.md).
+ **Izin IAM** — Izin untuk membuat dan mengelola antrian AWS Batch pekerjaan dan lingkungan layanan. Untuk informasi selengkapnya, lihat [AWS Batch Kebijakan, peran, dan izin IAM](IAM_policies.md).

------
#### [ Create a SageMaker Training job queue (AWS Batch console) ]

1. Buka AWS Batch konsol di [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).

1. **Di panel navigasi, pilih **Antrian pekerjaan dan Buat.****

1. **Untuk **jenis Orkestrasi**, pilih Pelatihan. SageMaker **

1. Untuk **konfigurasi antrian Job**:

   1. Untuk **Nama**, masukkan nama antrian Job.

   1. untuk **Prioritas**, masukkan nilai antara 0 dan 1000. Antrian Job dengan prioritas lebih tinggi diberikan preferensi untuk lingkungan layanan.

   1. (Opsional) Untuk **kebijakan Penjadwalan Nama Sumber Daya Amazon (ARN**), pilih kebijakan penjadwalan yang ada.

   1. Untuk **lingkungan layanan Terhubung**, pilih lingkungan layanan dari daftar untuk dikaitkan dengan antrian pekerjaan. 

1. (Opsional) Untuk **batas status Job**:

   1. Untuk **Misconfiguration**, pilih `SERVICE_ENVIRONMENT_MAX_RESOURCE` dan masukkan **Maksimum runnable time (**detik).

   1. Untuk **Kapasitas**, pilih `INSUFFICIENT_INSTANCE_CAPACITY` dan masukkan **Waktu runnable maksimum (detik)**.

1. Pilih **Buat antrian pekerjaan**

------
#### [ Create a SageMaker Training job queue (AWS CLI) ]

Gunakan `create-job-queue` perintah untuk membuat antrean pekerjaan SageMaker Pelatihan.

Contoh berikut membuat antrian pekerjaan SageMaker Pelatihan dasar yang menggunakan lingkungan layanan:

```
aws batch create-job-queue \
  --job-queue-name my-sm-training-fifo-jq \
  --job-queue-type SAGEMAKER_TRAINING \
  --priority 1 \
  --service-environment-order order=1,serviceEnvironment=ExampleServiceEnvironment
```

Ganti *ExampleServiceEnvironment* dengan nama lingkungan layanan Anda.

Perintah tersebut mengembalikan output serupa dengan berikut ini:

```
{
  "jobQueueName": "my-sm-training-fifo-jq",
  "jobQueueArn": "arn:aws:batch:region:account:job-queue/my-sm-training-fifo-jq"
}
```

Setelah membuat antrian pekerjaan Anda, verifikasi bahwa itu berhasil dibuat dan dalam keadaan valid.

Gunakan `describe-job-queues` perintah untuk melihat detail tentang antrian pekerjaan Anda:

```
aws batch describe-job-queues --job-queues my-sm-training-fifo-jq
```

Perintah tersebut mengembalikan output serupa dengan berikut ini:

```
{
  "jobQueues": [
    {
      "jobQueueName": "my-sm-training-fifo-jq",
      "jobQueueArn": "arn:aws:batch:region:account:job-queue/my-sm-training-fifo-jq",
      "state": "ENABLED",
      "status": "VALID",
      "statusReason": "JobQueue Healthy",
      "priority": 1,
      "computeEnvironmentOrder": [],
      "serviceEnvironmentOrder": [
        {
          "order": 1,
          "serviceEnvironment": "arn:aws:batch:region:account:service-environment/ExampleServiceEnvironment"
        }
      ],
      "jobQueueType": "SAGEMAKER_TRAINING",
      "tags": {},
      "jobStateTimeLimitActions": []
    }
  ]
}
```

Pastikan bahwa:
+ `state`adalah `ENABLED`
+ `status`adalah `VALID`
+ `statusReason`adalah `JobQueue Healthy`
+ `jobQueueType`adalah `SAGEMAKER_TRAINING`
+ `serviceEnvironmentOrder`Referensi lingkungan layanan Anda

------

# Templat antrean tugas
<a name="job-queue-template"></a>

Berikut ini adalah template antrian pekerjaan kosong. Anda dapat menggunakan template ini untuk membuat antrian pekerjaan Anda. Anda kemudian dapat menyimpan antrian pekerjaan ini ke file dan menggunakannya dengan AWS CLI `--cli-input-json` opsi. Untuk informasi selengkapnya tentang parameter ini, lihat [CreateJobQueue](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateJobQueue.html)di *Referensi AWS Batch API*.

**catatan**  
Anda dapat membuat template antrian pekerjaan dengan AWS CLI perintah berikut.  

```
$ aws batch create-job-queue --generate-cli-skeleton
```

```
{
   "computeEnvironmentOrder": [ 
      { 
         "computeEnvironment": "",
         "order": 0
      }
   ],
   "jobQueueName": "",
   "jobStateTimeLimitActions": [ 
      { 
         "state": "RUNNABLE",
         "action": "CANCEL",
		 "maxTimeSeconds": 0,
         "reason": ""

      }
   ],
   "priority": 0,
   "schedulingPolicyArn": "",
   "state": "ENABLED",
   "tags": { 
      "KeyName": ""
   }
}
```

# Lihat antrian pekerjaan di AWS Batch
<a name="job_queue_viewing_status"></a>

Setelah Anda membuat antrian pekerjaan dan mengirimkan pekerjaan, penting untuk dapat memantau kemajuannya. Anda dapat menggunakan halaman **Detail pekerjaan** untuk meninjau, mengelola, dan memantau antrian pekerjaan Anda.

## Lihat informasi antrian pekerjaan
<a name="view-job-queue-info"></a>

Dari AWS Batch konsol, pilih **Antrian pekerjaan di panel navigasi dan pilih antrian** pekerjaan yang Anda inginkan untuk melihat detailnya. Di halaman ini, Anda dapat meninjau dan mengelola antrean pekerjaan Anda dan melihat informasi tambahan tentang operasi antrian, seperti snapshot antrian pekerjaan, batas status pekerjaan, urutan lingkungan, tag, dan kode JSON antrian pekerjaan.

### Detail antrian pekerjaan
<a name="job-queue-info-details"></a>

Bagian ini memberikan ikhtisar dan opsi pemeliharaan untuk antrian pekerjaan. Penting untuk dicatat bahwa Anda dapat menemukan Nama Sumber Daya Amazon (ARN) di bagian ini.

Untuk menemukan informasi ini melalui AWS Command Line Interface, gunakan [https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobQueues.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobQueues.html)operasi bersama dengan nama antrian pekerjaan, atau ARN yang sesuai.

### Saham aktif
<a name="top-active-shares"></a>

Untuk antrian pekerjaan menggunakan penjadwalan berbagi adil, AWS Batch berikan visibilitas tentang bagaimana pengidentifikasi berbagi yang berbeda mengkonsumsi kapasitas. Informasi ini membantu Anda memahami distribusi sumber daya dan mengidentifikasi saham yang mungkin perlu disesuaikan.

**catatan**  
Tab **berbagi Aktif** hanya ada saat **algoritme Penjadwalan** antrian pekerjaan adalah Fair-share.

Bagian 20 saham aktif teratas menunjukkan pengidentifikasi saham yang dijadwalkan, memulai, dan menjalankan pekerjaannya. Tampilan ini meliputi:
+ **Bagikan nama pengenal** - Pengidentifikasi unik untuk berbagi.

  Pengidentifikasi berbagi adalah label yang mengelompokkan pekerjaan untuk penjadwalan berbagi adil. Saat Anda mengirimkan pekerjaan dengan pengenal saham yang sama, perlakukan pekerjaan AWS Batch tersebut sebagai bagian dari beban kerja yang sama untuk tujuan alokasi sumber daya. Pengidentifikasi berbagi membantu memastikan distribusi kapasitas komputasi yang merata di berbagai tim, proyek, atau jenis beban kerja. Untuk informasi selengkapnya, lihat [Gunakan pengidentifikasi berbagi untuk mengidentifikasi beban kerja](share-identifiers.md).
+ **Pemanfaatan kapasitas** - Jumlah sumber daya yang dikonfigurasi untuk digunakan. Ini diukur dalam`instances`,`cpu`, atau `vCPU` tergantung pada lingkungan.
+ **Lihat aksi pekerjaan** - Tautan untuk melihat semua pekerjaan untuk bagian itu.

Anda dapat melihat informasi ini dalam format daftar dan bagan:
+ **Tampilan daftar - Tampilan** tabel dengan nomor kapasitas yang tepat
+ **Tampilan bagan** - Bagan batang visual yang menunjukkan pemanfaatan relatif

### Cuplikan antrian Job
<a name="job-queue-info-snapshot"></a>

Bagian ini menyediakan daftar statis dari 100 `RUNNABLE` pekerjaan pertama yang berada dalam antrian. Anda dapat menggunakan bidang pencarian untuk mempersempit daftar dengan mencari informasi dari kolom mana pun di bagian hasil. Pekerjaan di area hasil snapshot diurutkan sesuai dengan strategi lari antrian pekerjaan. Untuk antrian pekerjaan first-in-first-out (FIFO), pemesanan pekerjaan didasarkan pada waktu pengiriman. Untuk antrian pekerjaan [penjadwalan yang adil, pemesanan pekerjaan didasarkan pada prioritas pekerjaan dan penggunaan berbagi](fair-share-scheduling.md). Bidang **Kapasitas yang diperlukan** menunjukkan jumlah sumber daya yang dikonfigurasi untuk digunakan.

Karena hasilnya adalah snapshot dari antrian pekerjaan, daftar hasil tidak diperbarui secara otomatis. Untuk memperbarui daftar, pilih penyegaran di bagian atas bagian. Pilih hyperlink nama pekerjaan untuk menavigasi ke **rincian Job** dan melihat status pekerjaan dan informasi terkait lainnya.

Untuk menemukan informasi ini melalui AWS CLI, gunakan [https://docs.aws.amazon.com/batch/latest/APIReference/API_GetJobQueueSnapshot.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_GetJobQueueSnapshot.html)operasi bersama dengan nama antrian pekerjaan atau ARN yang sesuai.

```
aws batch get-job-queue-snapshot --job-queue my-sm-training-fifo-jq
```

### Batas status Job
<a name="job-queue-info-state-limits"></a>

Gunakan tab ini untuk meninjau informasi konfigurasi tentang jumlah waktu pekerjaan dapat tetap dalam `RUNNABLE` status sebelum dibatalkan.

Untuk menemukan informasi ini melalui AWS CLI, gunakan [https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobQueues.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobQueues.html)operasi bersama dengan nama antrian pekerjaan atau ARN yang sesuai.

### Tatanan lingkungan
<a name="job-queue-info-env-order"></a>

Jika antrian pekerjaan Anda berjalan di beberapa lingkungan, tab ini menyediakan urutan dan ikhtisar mereka. 

Untuk menemukan informasi ini melalui AWS CLI, gunakan [https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobQueues.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobQueues.html)operasi bersama dengan nama antrian pekerjaan atau ARN yang sesuai.

### Tanda
<a name="job-queue-info-tags"></a>

Gunakan tab ini untuk meninjau dan mengelola tag yang terkait dengan antrian pekerjaan ini.

### JSON
<a name="job-queue-info-json"></a>

Gunakan tab ini untuk menyalin kode JSON yang terkait dengan antrian pekerjaan ini. Anda kemudian dapat menggunakan kembali JSON untuk AWS CloudFormation template dan AWS CLI skrip.

# Hapus antrian pekerjaan di AWS Batch
<a name="delete-job-queue"></a>

Ketika Anda tidak lagi membutuhkan antrian pekerjaan Anda, Anda dapat menonaktifkan dan menghapus antrian pekerjaan.

------
#### [ Delete a job queue (AWS Batch console) ]

1. Buka AWS Batch konsol di [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).

1. Di panel navigasi, pilih **Antrian pekerjaan dan kemudian pilih antrian** pekerjaan.

1. Pilih **Tindakan** dan kemudian **Nonaktifkan**.

1. Setelah status antrian pekerjaan **Dinonaktifkan**, pilih **Tindakan** lalu **Hapus**.

1. Di jendela modal pilih **Hapus antrian pekerjaan**.

------
#### [ Delete a job queue (AWS CLI) ]

1. Nonaktifkan antrian pekerjaan untuk mencegah pengiriman pekerjaan baru:

   ```
   aws batch update-job-queue \
     --job-queue my-sm-training-fifo-jq \
     --state DISABLED
   ```

1. Tunggu hingga pekerjaan yang sedang berjalan selesai, lalu hapus antrian pekerjaan:

   ```
   aws batch delete-job-queue \
     --job-queue my-sm-training-fifo-jq
   ```

------

# Kebijakan penjadwalan saham adil
<a name="job_scheduling"></a>

 AWS Batch Penjadwal mengevaluasi kapan, di mana, dan bagaimana menjalankan pekerjaan yang dikirimkan ke antrian pekerjaan. Jika Anda tidak menentukan kebijakan penjadwalan saat membuat antrean pekerjaan, penjadwal AWS Batch pekerjaan secara default akan menggunakan strategi first-in, first-out (FIFO). Strategi FIFO dapat menyebabkan pekerjaan penting “terjebak” di belakang pekerjaan yang diajukan sebelumnya. Dengan menentukan kebijakan penjadwalan yang berbeda, Anda dapat mengalokasikan sumber daya komputasi sesuai dengan kebutuhan spesifik Anda. 

**catatan**  
Jika Anda ingin menjadwalkan urutan spesifik tempat pekerjaan dijalankan, gunakan `[dependsOn](https://docs.aws.amazon.com/batch/latest/APIReference/API_SubmitJob.html#Batch-SubmitJob-request-dependsOn)` parameter [SubmitJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_SubmitJob.html)untuk menentukan dependensi untuk setiap pekerjaan.

Jika Anda membuat kebijakan penjadwalan dan melampirkannya ke antrian pekerjaan, penjadwalan pembagian adil diaktifkan. Jika antrean pekerjaan memiliki kebijakan penjadwalan, kebijakan penjadwalan menentukan urutan pekerjaan yang dijalankan. Untuk informasi selengkapnya, lihat [Gunakan kebijakan penjadwalan berbagi adil untuk menetapkan pengenal berbagi](scheduling-policies.md).

**Topics**
+ [Gunakan pengidentifikasi berbagi untuk mengidentifikasi beban kerja](share-identifiers.md)
+ [Gunakan kebijakan penjadwalan berbagi adil untuk menetapkan pengenal berbagi](scheduling-policies.md)
+ [Gunakan penjadwalan berbagi adil untuk membantu menjadwalkan pekerjaan](fair-share-scheduling.md)
+ [Tutorial: Buat kebijakan penjadwalan berbagi adil](create-scheduling-policy.md)
+ [Referensi: Templat kebijakan penjadwalan berbagi adil](scheduling-policy-template.md)

# Gunakan pengidentifikasi berbagi untuk mengidentifikasi beban kerja
<a name="share-identifiers"></a>

Anda dapat menggunakan pengidentifikasi berbagi untuk menandai pekerjaan dan membedakan antara pengguna dan beban kerja. AWS Batch Penjadwal melacak penggunaan untuk setiap pengidentifikasi berbagi dengan menggunakan `(T * weightFactor)` rumus, di mana *`T`*penggunaan vCPU dari waktu ke waktu. Penjadwal memilih pekerjaan dengan penggunaan terendah dari pengidentifikasi saham. Anda dapat menggunakan pengenal berbagi tanpa mengesampingkannya.

**catatan**  
Pengidentifikasi berbagi unik dalam antrian pekerjaan dan tidak digabungkan di seluruh antrian pekerjaan. 

Anda dapat menetapkan prioritas penjadwalan berbagi adil untuk mengonfigurasi urutan pekerjaan yang dijalankan pada pengenal berbagi. Pekerjaan dengan prioritas penjadwalan yang lebih tinggi dijadwalkan terlebih dahulu. Jika Anda tidak menentukan kebijakan penjadwalan pembagian adil, semua pekerjaan yang dikirimkan ke antrian pekerjaan dijadwalkan dalam urutan FIFO. Saat mengirimkan pekerjaan, Anda tidak dapat menentukan pengenal berbagi atau prioritas penjadwalan berbagi adil.

**catatan**  
Sumber daya komputasi terlampir dialokasikan secara merata di antara semua pengidentifikasi saham kecuali secara eksplisit diganti.

# Gunakan kebijakan penjadwalan berbagi adil untuk menetapkan pengenal berbagi
<a name="scheduling-policies"></a>

Anda dapat menggunakan kebijakan penjadwalan berbagi adil untuk mengonfigurasi cara sumber daya komputasi dalam antrean pekerjaan dialokasikan antara pengguna atau beban kerja. Dengan menggunakan kebijakan penjadwalan berbagi adil, Anda dapat menetapkan pengidentifikasi berbagi yang berbeda ke beban kerja atau pengguna. AWS Batch memberikan setiap pengidentifikasi saham persentase dari total sumber daya yang tersedia selama periode waktu tertentu. 

Persentase pembagian adil dihitung menggunakan nilai `shareDecaySeconds` dan`shareDistribution`. Anda dapat menambahkan waktu ke analisis pembagian adil dengan menetapkan waktu peluruhan saham ke kebijakan. Menambahkan waktu memberi lebih banyak bobot pada waktu dan lebih sedikit pada bobot yang ditentukan. Anda dapat menyimpan sumber daya komputasi sebagai cadangan untuk pengidentifikasi saham yang tidak aktif dengan menentukan reservasi komputasi. Lihat informasi yang lebih lengkap di [SchedulingPolicyDetail](https://docs.aws.amazon.com/batch/latest/APIReference/API_SchedulingPolicyDetail.html).

# Gunakan penjadwalan berbagi adil untuk membantu menjadwalkan pekerjaan
<a name="fair-share-scheduling"></a>

Penjadwalan Fair-share menyediakan serangkaian kontrol untuk membantu menjadwalkan pekerjaan. Untuk informasi selengkapnya tentang parameter kebijakan penjadwalan, lihat [SchedulingPolicyDetail](https://docs.aws.amazon.com/batch/latest/APIReference/API_SchedulingPolicyDetail.html). 
+ **Share decay seconds —** Periode waktu (dalam detik) yang digunakan AWS Batch penjadwal untuk menghitung persentase pembagian adil untuk setiap pengidentifikasi saham. Nilai nol menunjukkan bahwa hanya penggunaan saat ini yang diukur. Waktu pembusukan yang lebih lama memberi lebih banyak bobot waktu.
**catatan**  
Periode waktu pembusukan dihitung sebagai: *`shareDecaySeconds + OrderMinutes`*di *`OrderMinutes `*mana waktu dalam urutan dalam menit.
+ **Komputasi reservasi —** Mencegah pekerjaan dalam satu pengidentifikasi saham menggunakan semua sumber daya yang dilampirkan ke antrian pekerjaan. Rasio cadangan `ActiveFairShares` adalah `(computeReservation/100)^ActiveFairShares` di mana jumlah pengidentifikasi saham aktif.
**catatan**  
Jika pengidentifikasi saham memiliki pekerjaan di`SUBMITTED`,,, `PENDING` `RUNNABLE``STARTING`, atau `RUNNING` negara bagian, itu dianggap sebagai pengidentifikasi saham aktif. Setelah periode waktu pembusukan berakhir, pengidentifikasi saham dianggap tidak aktif.
+ **Faktor berat -** Faktor berat untuk pengidentifikasi saham. Nilai default adalah 1. Nilai yang lebih rendah memungkinkan pekerjaan dari pengidentifikasi berbagi berjalan atau memberikan runtime tambahan ke pengidentifikasi berbagi. Misalnya, pekerjaan yang menggunakan pengidentifikasi saham dengan faktor bobot 0,125 (1/8) ditugaskan delapan kali sumber daya komputasi pekerjaan yang menggunakan pengidentifikasi saham dengan faktor bobot 1.
**catatan**  
Anda hanya perlu mendefinisikan atribut ini ketika Anda perlu memperbarui faktor bobot default 1.

Saat antrian pekerjaan aktif dan memproses pekerjaan, Anda dapat meninjau daftar 100 `RUNNABLE` pekerjaan pertama melalui snapshot antrian Job. Lihat informasi yang lebih lengkap di [Lihat antrian pekerjaan di AWS Batch](job_queue_viewing_status.md). 

# Tutorial: Buat kebijakan penjadwalan berbagi adil
<a name="create-scheduling-policy"></a>

Sebelum Anda dapat membuat antrian pekerjaan dengan kebijakan penjadwalan, Anda harus membuat kebijakan penjadwalan. Saat membuat kebijakan penjadwalan pembagian adil, Anda mengaitkan satu atau beberapa pengidentifikasi saham atau awalan pengenal berbagi dengan bobot untuk antrian dan secara opsional menetapkan periode peluruhan dan menghitung reservasi ke kebijakan tersebut.

**Untuk membuat kebijakan penjadwalan pembagian yang adil**

1. Buka AWS Batch konsol di [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).

1. Dari bilah navigasi, pilih Wilayah untuk digunakan.

1. **Di panel navigasi, pilih **Kebijakan penjadwalan, Buat**.**

1. Untuk **Nama**, masukkan nama unik untuk kebijakan penjadwalan Anda. Hingga 128 huruf (huruf besar dan huruf kecil), angka, tanda hubung, dan garis bawah diperbolehkan.

1. (Opsional) Untuk **detik peluruhan Bagikan**, masukkan nilai integer untuk waktu peluruhan saham kebijakan penjadwalan saham adil. Waktu peluruhan saham yang lebih lama akan menggunakan penggunaan sumber daya komputasi yang jauh lebih banyak dalam waktu yang lebih lama saat menjadwalkan pekerjaan. Ini dapat memungkinkan pekerjaan yang menggunakan pengidentifikasi berbagi untuk sementara menggunakan lebih banyak sumber daya komputasi daripada bobot yang diizinkan oleh pengidentifikasi berbagi itu jika pengidentifikasi berbagi itu baru-baru ini tidak menggunakan sumber daya komputasi.

1. (Opsional) Untuk **reservasi Compute**, masukkan nilai integer untuk reservasi komputasi kebijakan penjadwalan saham adil. Reservasi komputasi akan menyimpan beberapa v CPUs sebagai cadangan untuk digunakan untuk pengidentifikasi saham yang saat ini tidak aktif.

   Rasio cadangan *ActiveFairShares*adalah `(computeReservation/100)^ActiveFairShares` di mana jumlah pengidentifikasi saham aktif.

   Misalnya, `computeReservation` nilai 50 menunjukkan bahwa AWS Batch harus mencadangkan 50% dari VCPU maksimum yang tersedia jika hanya ada satu pengidentifikasi saham, 25% jika ada dua pengidentifikasi saham, dan 12,5% jika ada tiga pengidentifikasi saham. `computeReservation`Nilai 25 menunjukkan bahwa AWS Batch harus mencadangkan 25% dari VCPU maksimum yang tersedia jika hanya ada satu pengidentifikasi saham, 6,25% jika ada dua pengidentifikasi saham, dan 1,56% jika ada tiga pengidentifikasi saham.

1. Di bagian **Bagikan atribut**, Anda dapat menentukan pengenal berbagi dan bobot untuk setiap pengenal saham untuk dikaitkan dengan kebijakan penjadwalan pembagian adil.

   1. Pilih **Tambahkan pengenal berbagi**.

   1. Untuk **pengenal Bagikan**, tentukan pengenal berbagi. Jika string diakhiri dengan '\$1', ini menjadi awalan pengidentifikasi berbagi yang digunakan untuk mencocokkan pengidentifikasi berbagi untuk pekerjaan. Semua pengidentifikasi berbagi dan awalan pengenal berbagi dalam kebijakan penjadwalan harus unik dan tidak dapat tumpang tindih. Misalnya, Anda tidak dapat memiliki awalan pengenal berbagi 'userA\$1' dan pengidentifikasi berbagi 'userA1' dalam kebijakan penjadwalan berbagi adil yang sama.

   1. Untuk **faktor Berat**, tentukan bobot relatif untuk pengidentifikasi saham. Nilai defaultnya adalah 1.0. Nilai yang lebih rendah memiliki prioritas yang lebih tinggi untuk sumber daya komputasi. Jika awalan pengenal berbagi digunakan, pekerjaan dengan pengidentifikasi berbagi yang dimulai dengan awalan akan berbagi faktor bobot. Ini secara efektif meningkatkan faktor bobot untuk pekerjaan tersebut, menurunkan prioritas individu mereka tetapi mempertahankan faktor bobot yang sama untuk awalan pengidentifikasi saham.

1. (Opsional) Di **tag** bagian, Anda dapat menentukan kunci dan nilai untuk setiap tag untuk dikaitkan dengan kebijakan penjadwalan. Untuk informasi selengkapnya, lihat [Tandai AWS Batch sumber daya Anda](using-tags.md).

1. Pilih **Kirim** untuk menyelesaikan dan membuat kebijakan penjadwalan Anda.

# Referensi: Templat kebijakan penjadwalan berbagi adil
<a name="scheduling-policy-template"></a>

Templat kebijakan penjadwalan berbagi adil kosong ditunjukkan di bawah ini. Anda dapat menggunakan template ini untuk membuat kebijakan penjadwalan Anda yang kemudian dapat disimpan ke file dan digunakan dengan AWS CLI `--cli-input-json` opsi. Untuk informasi selengkapnya tentang parameter ini, lihat [CreateSchedulingPolicy](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateSchedulingPolicy.html)di *Referensi AWS Batch API*.

**catatan**  
Anda dapat membuat template antrian pekerjaan dengan AWS CLI perintah berikut.  

```
$ aws batch create-scheduling-policy --generate-cli-skeleton
```

```
{
    "name": "",
    "fairsharePolicy": {
        "shareDecaySeconds": 0,
        "computeReservation": 0,
        "shareDistribution": [
            {
                "shareIdentifier": "",
                "weightFactor": 0.0
            }
        ]
    },
    "tags": {
        "KeyName": ""
    }
}
```

# Penjadwalan sadar sumber daya
<a name="resource-aware-scheduling"></a>

AWS Batch menjadwalkan pekerjaan berdasarkan vCPU, GPU, dan ketersediaan memori di Compute Environment (CE) yang terkait dengan Job Queue (JQ). Tetapi kadang-kadang, hanya ketersediaan sumber daya CE ini tidak menjamin bahwa pekerjaan akan berjalan dengan sukses karena mungkin tergantung pada sumber daya lain yang diperlukan, sehingga pekerjaan ini dibatalkan atau dihentikan. Hal ini mengakibatkan penggunaan sumber daya komputasi yang tidak efisien. Untuk mengatasi masalah ini, penjadwalan yang sadar sumber daya dapat memeriksa ketersediaan sumber daya non-CE yang bergantung sebelum menjadwalkan pekerjaan untuk dijalankan pada CE.

AWS Batch penjadwalan yang sadar sumber daya memungkinkan Anda menjadwalkan pekerjaan berdasarkan sumber daya habis pakai yang diperlukan untuk menjalankan pekerjaan Anda— token lisensi pihak ketiga, bandwidth akses basis data, kebutuhan untuk membatasi panggilan ke API pihak ketiga, dan sebagainya. Anda menentukan sumber daya habis pakai yang diperlukan untuk menjalankan pekerjaan, dan Batch memperhitungkan dependensi sumber daya ini saat menjadwalkan pekerjaan. Anda dapat menghindari melakukan intervensi manual untuk menghilangkan kegagalan pekerjaan dan menunggu lama yang disebabkan oleh kekurangan sumber daya habis pakai. Anda dapat mengurangi pemanfaatan sumber daya komputasi yang kurang dengan mengalokasikan hanya pekerjaan yang memiliki semua sumber daya yang diperlukan tersedia.

Penjadwalan sadar sumber daya tersedia untuk kebijakan penjadwalan FIFO dan Fair-share dan dapat digunakan dengan semua platform komputasi yang didukung oleh Batch termasuk EKS, ECS, dan Fargate. Ini dapat digunakan dengan pekerjaan Array, pekerjaan Multi-node parallel (MNP), dan dengan pekerjaan Batch reguler.

Untuk mengonfigurasi penjadwalan sadar sumber daya, pertama-tama Anda menentukan semua sumber daya habis pakai yang diperlukan untuk menjalankan pekerjaan Anda, bersama dengan jumlah total yang tersedia untuk setiap sumber daya. Kemudian, untuk setiap pekerjaan yang membutuhkan sumber daya habis pakai, Anda menentukan nama dan jumlah yang diperlukan dari setiap sumber daya yang dibutuhkan. Batch melacak berapa banyak sumber daya habis pakai yang tersedia untuk pekerjaan dalam antrian pekerjaan Anda dan memastikan bahwa pekerjaan dijadwalkan untuk berjalan hanya ketika semua sumber daya habis pakai yang diperlukan tersedia agar pekerjaan dapat berjalan dengan sukses. 

**Topics**
+ [Buat sumber daya habis pakai](resource-aware-scheduling-how-to-create.md)
+ [Tentukan sumber daya yang dibutuhkan untuk menjalankan pekerjaan](resource-aware-scheduling-how-to-for-jobs.md)
+ [Periksa berapa banyak sumber daya yang digunakan dan tersedia](resource-aware-scheduling-how-to-check-resources-check-resources.md)
+ [Perbarui jumlah sumber daya saat sedang digunakan oleh pekerjaan](resource-aware-scheduling-how-to-update-quantity.md)
+ [Temukan pekerjaan yang membutuhkan sumber daya konsumsi tertentu](resource-aware-scheduling-how-to-find-jobs.md)
+ [Hapus sumber daya habis pakai](resource-aware-scheduling-how-to-delete.md)

# Buat sumber daya habis pakai
<a name="resource-aware-scheduling-how-to-create"></a>

Anda harus terlebih dahulu membuat sumber daya habis pakai yang mewakili sumber daya non-CE yang dikonsumsi saat pekerjaan sedang berjalan dan hanya tersedia dalam jumlah terbatas. Setiap sumber daya habis pakai memiliki: 
+ nama sumber daya (`consumableResourceName`) yang harus unik di tingkat akun.
+ (opsional) tipe sumber daya (`resourceType`) yang menunjukkan apakah sumber daya tersedia untuk digunakan kembali setelah pekerjaan selesai. Ini bisa menjadi salah satu dari:
  + `REPLENISHABLE` (default)
  + `NON_REPLENISHABLE`
+ jumlah total (`totalQuantity`) yang menentukan jumlah total sumber daya habis pakai yang tersedia.

Jumlah maksimum sumber daya habis pakai per akun adalah 50k.

**Konsol:**

1. Di panel navigasi kiri [AWS Batch konsol](https://console.aws.amazon.com/batch), pilih **Sumber daya yang dapat dikonsumsi**.

1. Pilih **Buat sumber daya habis pakai**.

1. **Masukkan **nama Resource** yang unik, **Jumlah sumber daya total**, dan pilih apakah **Jenis sumber daya** dapat diisi ulang atau **tidak dapat diisi ulang**.**

1. Pilih **Buat sumber daya habis pakai**.

**API:**

Gunakan [`CreateConsumableResource`API](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateConsumableResource.html) untuk menentukan sumber daya yang Anda inginkan.

# Tentukan sumber daya yang dibutuhkan untuk menjalankan pekerjaan
<a name="resource-aware-scheduling-how-to-for-jobs"></a>

Ketika Anda mendaftarkan pekerjaan, Anda dapat menentukan nama satu atau lebih sumber daya yang Anda buat (`consumableResource`) dan jumlah sumber daya yang dibutuhkan setiap instance pekerjaan (`quantity`).

Batch melacak unit yang tersedia dari setiap sumber daya pada saat tertentu. Untuk setiap pekerjaan dalam antrean pekerjaan, penjadwal Batch memastikan bahwa pekerjaan Anda berjalan hanya ketika dependensi sumber daya yang ditentukan tersedia.

Jika sumber daya habis pakai untuk pekerjaan tidak tersedia ketika pekerjaan mencapai kepala antrian, pekerjaan akan menunggu di `RUNNABLE` negara bagian sampai semua sumber daya yang diperlukan tersedia atau batas waktu status pekerjaan tercapai (lihat[Lihat antrian pekerjaan di AWS Batch](job_queue_viewing_status.md)). Setelah Batch memvalidasi bahwa semua sumber daya tersedia, pekerjaan beralih ke `STARTING` status dan kemudian ke. `RUNNING` Sumber daya dikunci setelah pekerjaan pindah ke `STARTING` dan kemudian dibuka ketika pekerjaan pindah ke `SUCCEEDED` atau`FAILED`.

Anda juga dapat memperbarui jumlah sumber daya yang dibutuhkan untuk pekerjaan tertentu ketika Anda mengirimkan pekerjaan.

**Konsol:**

**Untuk menentukan sumber daya dan jumlah yang dibutuhkan saat Anda menentukan pekerjaan:**

1. Tentukan pekerjaan menggunakan wizard definisi pekerjaan dari [AWS Batch konsol](https://console.aws.amazon.com/batch) (**Definisi Job** -> **Create**).

1. Di panduan Langkah 4: **Konfigurasikan kontainer**, di bawah **Sumber daya habis pakai**, pilih **Nama** sumber daya yang diperlukan dari daftar. Di bidang **Nilai yang diminta**, masukkan kuantitas sumber daya ini yang dibutuhkan oleh instance pekerjaan ini, lalu pilih **Tambahkan sumber daya habis pakai**.

1. Ulangi langkah sebelumnya untuk semua sumber daya habis pakai yang dibutuhkan oleh pekerjaan. Anda dapat menentukan hingga 5 sumber daya untuk setiap pekerjaan yang Anda tentukan.

1. Anda akan melihat daftar sumber daya habis pakai yang telah Anda buat setelah menyelesaikan panduan definisi pekerjaan tetapi sebelum Anda memilih **Buat definisi pekerjaan**.

**Untuk memperbarui jumlah sumber daya yang dibutuhkan saat Anda mengirimkan pekerjaan:**

1. Di panel navigasi kiri [AWS Batch konsol](https://console.aws.amazon.com/batch), pilih **Pekerjaan**, lalu pilih **Kirim pekerjaan baru**.

1. Di langkah 2 wizard: **Mengonfigurasi penggantian**, di bawah **penggantian sumber daya habis pakai**, masukkan **nilai Diminta** baru untuk sumber daya habis pakai yang kuantitasnya dibutuhkan yang ingin Anda timpa untuk pekerjaan tersebut.

1. Setelah Anda menyelesaikan semua penggantian yang ingin Anda lakukan untuk pekerjaan ini, pilih **Berikutnya** untuk melanjutkan **Meninjau dan mengirimkan**.

**API:**

Saat Anda mendaftarkan pekerjaan dengan [`RegisterJobDefinition`API](https://docs.aws.amazon.com/batch/latest/APIReference/API_RegisterJobDefinition.html), gunakan `consumableResourceProperties` bagian `consumableResourceList` dalam permintaan untuk menentukan sumber daya habis pakai yang diperlukan untuk menjalankan instance pekerjaan, dan kuantitas masing-masing.

Saat Anda mengirimkan pekerjaan dengan [`SubmitJob`API](https://docs.aws.amazon.com/batch/latest/APIReference/API_SubmitJob.html), Anda dapat mengganti daftar sumber daya habis pakai dan kuantitas masing-masing menggunakan `consumableResourcePropertiesOverride` bagian permintaan. Perhatikan bahwa ini hanya mengesampingkan jumlah sumber daya yang dibutuhkan oleh setiap instance pekerjaan, bukan jumlah total yang tersedia.

# Periksa berapa banyak sumber daya yang digunakan dan tersedia
<a name="resource-aware-scheduling-how-to-check-resources-check-resources"></a>

Batch memungkinkan Anda menanyakan jumlah sumber daya yang tersedia (`availableQuantity`), jumlah sumber daya yang digunakan (`inUseQuantity`), dan total sumber daya (`totalQuantity`) pada saat tertentu.

Setelah pekerjaan masuk ke `STARTING` negara bagian, sumber daya yang dikonsumsi akan dikurangi dari jumlah sumber daya yang tersedia. Jika sumber daya tersebut`REPLENISHABLE`, jumlah sumber daya yang dikonsumsi akan ditambahkan kembali ke kuantitas yang tersedia segera setelah pekerjaan dipindahkan ke status SUKSES atau GAGAL, dan jumlah totalnya akan tetap sama. Jika sumber daya adalah`NON_REPLENISHABLE`, jumlah sumber daya yang dikonsumsi dikurangi dari jumlah total dan yang tersedia dan tidak akan ditambahkan kembali apakah pekerjaan pindah ke negara bagian `SUCCEEDED` atau`FAILED`.

**catatan**  
Informasi ini dapat tertinggal hingga 30 detik.

**Konsol:**

1. Di panel navigasi kiri [AWS Batch konsol](https://console.aws.amazon.com/batch), pilih **Sumber daya yang dapat dikonsumsi**.

1. Pilih tab **Replenishable** atau **Non-Replenishable** untuk melihat sumber daya dari jenis yang telah Anda buat.

1. Untuk setiap sumber daya yang **dapat diisi ulang**, konsol menampilkan **Nama**, **Jumlah total** sumber daya, jumlah yang saat ini **Digunakan dan** berapa banyak yang masih **Tersedia**, bersama dengan perhitungan **Pemanfaatan** (jumlah sumber daya yang digunakan dibagi dengan jumlah total sumber daya itu).

   **Untuk setiap sumber daya yang **tidak dapat diisi ulang**, konsol menampilkan **Nama**, nomor yang sedang **digunakan**, dan berapa banyak yang masih Tersedia.**

Anda juga dapat melihat informasi terkini tentang sumber daya habis pakai dari halaman detail pekerjaan di konsol.

1. Di panel navigasi kiri [AWS Batch konsol](https://console.aws.amazon.com/batch), pilih **Pekerjaan**, lalu pilih nama pekerjaan untuk membuka halaman detail untuk pekerjaan itu.

1. Informasi tentang sumber daya yang **dapat diisi ulang dan sumber daya** yang **tidak dapat diisi ulang** tersedia untuk melihat apakah pekerjaan itu membutuhkannya. Untuk kedua jenis, konsol menampilkan **Nama** sumber daya, kuantitas yang **diminta** untuk pekerjaan, berapa banyak yang masih **Tersedia**, jumlah yang saat **ini digunakan**, **jumlah total** sumber daya, bersama dengan perhitungan **pemanfaatan Saat Ini** (jumlah sumber daya yang digunakan oleh pekerjaan dibagi dengan jumlah total sumber daya itu).

**API:**

Gunakan [`DescribeConsumableResource`API](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeConsumableResource.html) yang mengembalikan informasi berikut:

```
{
   "availableQuantity": number,
   "consumableResourceArn": "string",
   "consumableResourceName": "string",
   "createdAt": number,
   "inUseQuantity": number,
   "resourceType": "string",
   "tags": { 
      "string" : "string" 
   },
   "totalQuantity": number
}
```

[`ListConsumableResources`API](https://docs.aws.amazon.com/batch/latest/APIReference/API_ListConsumableResources.html) juga melaporkan jumlah sumber daya yang digunakan (`inUseQuantity`) dan jumlah total sumber daya yang saat ini tersedia (`totalQuantity`) sebagai bagian dari daftar semua sumber daya habis pakai yang telah Anda buat di akun Anda. API ini juga memungkinkan Anda memfilter kueri daftar sumber daya habis pakai berdasarkan nama sumber daya habis pakai.

# Perbarui jumlah sumber daya saat sedang digunakan oleh pekerjaan
<a name="resource-aware-scheduling-how-to-update-quantity"></a>

Anda dapat mengatur ulang jumlah total sumber daya ke nilai baru, menambah jumlah total atau mengurangi dari itu.

Jika jumlah total baru yang Anda tentukan lebih besar dari sebelumnya, Batch menjadwalkan lebih banyak pekerjaan yang sesuai. Jika jumlah total baru kurang dari sebelumnya dan tidak ada unit sumber daya ini yang digunakan, Batch hanya mengurangi jumlah total (atau tersedia). Jika ada unit yang digunakan, Batch segera mengurangi jumlah yang tersedia dan, saat pekerjaan selesai, Batch mengurangi jumlah total (tersedia) sehingga akhirnya tiba di nomor baru. 

**Konsol:**

1. Di panel navigasi kiri [AWS Batch konsol](https://console.aws.amazon.com/batch), pilih **Sumber daya yang dapat dikonsumsi**.

1. Pilih tab **Replenishable** atau **Non-Replenishable** untuk melihat sumber daya dari jenis yang telah Anda buat.

1. Untuk sumber daya yang **dapat diisi ulang**:

   1. Pilih sumber daya yang ingin Anda perbarui, lalu pilih **Tindakan** dan pilih **Setel sumber daya**, **Tambahkan sumber daya**, atau **Hapus sumber daya**.

   1. Jendela pop-up muncul di mana Anda dapat **Mengatur nilai total**, **Menambahkan sumber daya**, atau **Hapus sumber daya** tergantung pada tindakan yang Anda pilih pada langkah sebelumnya. Masukkan kuantitas yang ingin Anda tetapkan sebagai nilai total baru, Anda ingin menambahkan jumlah total atau yang ingin Anda kurangi dari jumlah total, lalu pilih **Ok**.

   Untuk sumber daya **yang tidak dapat diisi ulang:**

   1. Pilih sumber daya yang ingin Anda perbarui, lalu pilih **Tindakan** dan pilih **Setel sumber daya**, **Tambahkan sumber daya**, atau **Hapus sumber daya**.

   1. Jendela pop-up muncul di mana Anda dapat **Mengatur nilai yang tersedia**, **Tambah sumber daya**, atau **Hapus sumber daya** tergantung pada tindakan yang Anda pilih pada langkah sebelumnya. Masukkan kuantitas yang ingin Anda tetapkan sebagai nilai baru yang tersedia, Anda ingin menambahkan ke kuantitas yang tersedia atau yang ingin Anda kurangi dari kuantitas yang tersedia, lalu pilih **Ok**.

**API:**

Gunakan [`UpdateConsumableResource`API](https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdateConsumableResource.html) untuk menetapkan jumlah total baru untuk sumber daya, atau untuk menambah atau mengurangi jumlah total.

# Temukan pekerjaan yang membutuhkan sumber daya konsumsi tertentu
<a name="resource-aware-scheduling-how-to-find-jobs"></a>

Batch memungkinkan Anda mengambil daftar pekerjaan yang memerlukan sumber daya konsumsi tertentu.

**Konsol:**

1. Di panel navigasi kiri [AWS Batch konsol](https://console.aws.amazon.com/batch), pilih **Sumber daya yang dapat dikonsumsi**.

1. Dalam daftar, pilih nama sumber daya habis pakai. Halaman detail untuk sumber daya itu terbuka.

1. Di bawah **Cari pekerjaan**, masukkan filter apa pun yang ingin Anda lamar ke daftar pekerjaan. Anda dapat memfilter berdasarkan **nama Job** ('sama', 'dimulai dengan'), **rentang Tanggal** (saat pekerjaan dibuat), dan dengan **Kriteria tambahan** ('antrian pekerjaan', 'definisi pekerjaan', 'pengidentifikasi pekerjaan bersama'). Untuk setiap jenis filter yang ingin Anda terapkan, pilih dari opsi yang tersedia di daftar drop-down dan masukkan informasi tambahan yang diminta.

   Pilih **Cari**.

1. Daftar pekerjaan (disaring) yang membutuhkan sumber daya habis pakai ditampilkan, termasuk nama pekerjaan, status, jumlah unit yang diminta dari sumber daya habis pakai, sumber daya habis pakai lainnya, dan sebagainya. Dengan menggunakan daftar ini, Anda dapat memilih satu atau beberapa pekerjaan untuk **Membatalkan** atau **Mengakhiri.** Anda juga dapat memilih nama pekerjaan untuk membuka halaman detail pekerjaan itu.

1. Di bawah **Cari pekerjaan** Anda sekarang dapat **Segarkan hasil** atau **Hapus pencarian** dan mulai dari awal.

**API:**

Anda bisa mendapatkan daftar pekerjaan yang menggunakan sumber daya konsumsi tertentu dengan [`ListJobsByConsumableResource`API](https://docs.aws.amazon.com/batch/latest/APIReference/API_ListJobsByConsumableResource.html). API ini juga memungkinkan Anda memfilter kueri daftar pekerjaan menggunakan status pekerjaan atau nama pekerjaan.

# Hapus sumber daya habis pakai
<a name="resource-aware-scheduling-how-to-delete"></a>

Anda dapat menghapus sumber daya habis pakai kapan saja, bahkan ketika pekerjaan yang membutuhkan sumber daya masih berjalan. Setelah sumber daya habis pakai dihapus, mungkin ada celah antara waktu perintah hapus diterima dan penjadwal pekerjaan menghormati penghapusan, sehingga kemungkinan pekerjaan yang menggunakan sumber daya dapat dijadwalkan tepat setelah panggilan hapus. Jika sumber daya habis pakai yang dihapus memiliki tipe sumber daya (`resourceType`)`REPLENISHABLE`, ini akan diabaikan saat pekerjaan selesai. Jika Anda menghapus sumber daya habis pakai dan membuatnya kembali dengan nama yang sama, itu dianggap sebagai sumber daya yang sama dan dapat digunakan oleh `RUNNABLE` pekerjaan.

**Konsol:**

1. Di panel navigasi kiri [AWS Batch konsol](https://console.aws.amazon.com/batch), pilih **Sumber daya yang dapat dikonsumsi**.

1. Pilih tab **Replenishable** atau **Non-Replenishable** untuk melihat sumber daya dari jenis yang telah Anda buat.

1. Pilih setiap sumber daya yang ingin Anda hapus, lalu pilih **Hapus**. Jendela pop-up **Hapus sumber daya habis pakai** muncul. **Untuk mengonfirmasi penghapusan, pilih Hapus.**

Anda juga dapat menghapus sumber daya habis pakai dari halaman detailnya di konsol.

1. Di panel navigasi kiri [AWS Batch konsol](https://console.aws.amazon.com/batch), pilih **Sumber daya yang dapat dikonsumsi**.

1. Pilih tab **Replenishable** atau **Non-Replenishable** untuk melihat sumber daya dari jenis yang telah Anda buat.

1. Pilih nama sumber daya yang ingin Anda hapus. Halaman detail sumber daya habis pakai muncul. Pilih **Hapus**. Jendela pop-up **Hapus sumber daya habis pakai** muncul. **Untuk mengonfirmasi penghapusan, pilih Hapus.**

**API:**

Gunakan [`DeleteConsumableResource`API](https://docs.aws.amazon.com/batch/latest/APIReference/API_DeleteConsumableResource.html) untuk menghapus sumber daya habis pakai.

# Manajemen kuota
<a name="quota-management"></a>

AWS Batch menjadwalkan pekerjaan berdasarkan sumber daya yang dibutuhkan pekerjaan dan kapasitas yang tersedia di Lingkungan Layanan yang terhubung (SE), memungkinkan pemanfaatan sumber daya komputasi yang tinggi. Dengan manajemen kuota, administrator juga dapat mengontrol berapa banyak sumber daya yang dapat dikonsumsi tim atau proyek melalui alokasi sumber daya yang lebih halus.

Manajemen kuota memungkinkan administrator mengalokasikan sumber daya komputasi bersama secara efisien antara tim dan proyek dengan mendefinisikan pembagian kuota terkait - AWS Batch sumber daya yang mencakup **kuota komputasi (**batas kapasitas**) dan strategi berbagi** sumber daya untuk komputasi idle. Setiap pembagian kuota beroperasi sebagai antrian virtual yang bersarang dalam antrian pekerjaan terkait. Saat menjadwalkan pekerjaan untuk antrian pekerjaan, AWS Batch akan berulang melalui semua pembagian kuota terlampir.

Administrator dapat mengaktifkan pembagian sumber daya antara pembagian kuota dengan percaya diri, karena **preemption** akan memungkinkan pembagian kuota apa pun untuk merebut kembali sumber daya yang telah dipinjamkan kepada orang lain bila diperlukan. Dalam pembagian kuota, Anda dapat memilih apakah pekerjaan yang sedang berjalan harus didahului untuk pekerjaan prioritas yang lebih tinggi atau apakah akan membiarkan pekerjaan berjalan selesai. Prioritas pekerjaan dapat ditetapkan pada saat pengajuan dan diperbarui kemudian; prioritas yang diperbarui diperhitungkan saat keputusan preemption dibuat. Pemanfaatan kapasitas dapat dipantau pada antrian, pembagian kuota dan granularitas tingkat pekerjaan.

Manajemen kuota hanya didukung untuk antrian pekerjaan yang terhubung ke lingkungan layanan. `SAGEMAKER_TRAINING`

**Topics**
+ [Saham kuota](quota-shares.md)
+ [Preemption](preemption.md)
+ [Buat sumber daya manajemen kuota](create-quota-management-resources.md)
+ [Membuat pembagian kuota](create-quota-shares.md)
+ [Mengirimkan pekerjaan ke pembagian kuota](submit-job-quota-share.md)

# Saham kuota
<a name="quota-shares"></a>

**Pembagian kuota** adalah antrian virtual yang bersarang di bawah antrian pekerjaan. Maksimal 20 dapat dilampirkan ke antrian pekerjaan apa pun. Pembagian kuota memungkinkan mengalokasikan kuota komputasi ke tim atau proyek, melalui penggunaan **batas kapasitas**; pembagian kuota memerlukan setidaknya satu batas kapasitas disediakan dan mendukung maksimum 5 batas kapasitas. Setiap batas kapasitas harus dinyatakan sebagai batas instans untuk jenis instans pekerjaan SageMaker Pelatihan yang didukung.

## Strategi berbagi sumber daya berbagi kuota
<a name="quota-share-resource-sharing"></a>

Berbagi kuota juga memiliki konfigurasi berbagi sumber daya eksplisit.
+ Jika komputasi idle pembagian kuota harus dicadangkan hanya untuk pekerjaannya, pilih. `RESERVE`
+ Jika komputasi idle pembagian kuota dapat dipinjamkan ke saham kuota lainnya, pilih. `LEND`
+ Jika komputasi idle pembagian kuota dapat dipinjamkan ke pembagian kuota lainnya, dan lowongan dari pembagian kuota harus diizinkan untuk meminjam komputasi idle, pilih dengan batas pinjaman yang dikonfigurasi. `LEND_AND_BORROW`

## Restorasi kapasitas melalui preemption
<a name="capacity-limit-restoration"></a>

AWS Batch akan melakukan **preemption cross-share** untuk mengembalikan kapasitas pinjaman kembali ke pembagian kuota ketika pekerjaan tiba. Saat memilih pekerjaan mana yang akan didahului, AWS Batch pertimbangkan jumlah dan jenis contoh pekerjaan yang dipinjam, prioritas relatif pekerjaan dan durasi pekerjaan, dan terapkan heuristik khusus.

Administrator yang menurunkan batas kapasitas pembagian kuota juga dapat membuat `SCHEDULED``STARTING`, atau `RUNNING` pekerjaan dalam pembagian kuota tersebut memenuhi syarat untuk preemption bahkan jika `LEND` atau dipilih sebagai strategi pembagian sumber daya, jika kapasitas yang sudah dikonsumsi oleh pembagian kuota tersebut `RESERVE` berada di atas batas kapasitas yang diturunkan.

# Preemption
<a name="preemption"></a>

Manajemen kuota adalah satu-satunya algoritma AWS Batch penjadwalan untuk menggabungkan **preemption**, di mana AWS Batch berhenti, `SCHEDULED``STARTING`, atau `RUNNING` pekerjaan untuk menciptakan kapasitas untuk suatu pekerjaan. `RUNNABLE`

## Preemption Cross-share
<a name="cross-share-preemption"></a>

Manajemen kuota menggunakan **preemption cross-share** untuk mengembalikan kapasitas pinjaman kembali ke pembagian kuota ketika pekerjaan tiba.

Administrator yang menurunkan batas kapasitas pembagian kuota juga dapat membuat `SCHEDULED``STARTING`, atau `RUNNING` pekerjaan dalam pembagian kuota tersebut memenuhi syarat untuk preemption, jika kapasitas yang dikonsumsi oleh pembagian kuota tersebut sekarang di atas batas kapasitas yang dikonfigurasi.

## Preemption dalam saham
<a name="in-share-preemption"></a>

Pembagian kuota dapat dikonfigurasi untuk mengaktifkan **preemption dalam saham**, yang memungkinkan pekerjaan dengan prioritas lebih tinggi memicu preemption `RUNNABLE` pekerjaan prioritas rendah dalam pembagian kuota yang sama yang telah dimasukkan,, atau. `SCHEDULED` `STARTING` `RUNNING`

## Algoritma pemilihan preemption
<a name="preemption-selection-algorithm"></a>

Saat memilih pekerjaan mana yang akan didahului, AWS Batch pertimbangkan jumlah dan jenis contoh pekerjaan yang dipinjam, prioritas relatif pekerjaan dan durasi pekerjaan, dan terapkan heuristik khusus. Anda dapat menggunakan panggilan [UpdateServiceJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdateServiceJob.html)API untuk memperbarui pekerjaan setelah pengiriman. `schedulingPriority` Ini dapat berguna untuk menurunkan prioritas `RUNNING` pekerjaan (meningkatkan kemungkinan preemption) atau meningkatkan prioritas `RUNNABLE` pekerjaan dalam pembagian kuota dengan preemption in-share diaktifkan, sehingga memungkinkan pekerjaan untuk mendahului pekerjaan yang sudah berjalan.

## Preemption mencoba lagi
<a name="preemption-retries"></a>

Defaultnya adalah untuk pekerjaan yang dipreempt untuk diantrian ulang tanpa batas. `RUNNABLE` Untuk membatasi jumlah preemption yang dialami pekerjaan, tetapkan `preemptionRetriesBeforeTermination` pada pengajuan pekerjaan. Ketika `preemptionRetriesBeforeTermination` diatur ke 0, pekerjaan pergi ke `FAILED` preemption pertama mereka.

Jendela geser dari upaya pencegahan baru-baru ini disimpan di tempat kerja, dan terlihat melalui. [DescribeServiceJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeServiceJob.html)

# Buat sumber daya manajemen kuota
<a name="create-quota-management-resources"></a>

Manajemen kuota memerlukan pengaturan khusus saat membuat kebijakan penjadwalan terkait, lingkungan layanan, dan antrian pekerjaan.

## Prasyarat
<a name="quota-management-resources-prerequisites"></a>

Sebelum membuat sumber daya manajemen kuota, pastikan Anda memiliki:
+ **Izin IAM — Izin** untuk membuat dan mengelola antrian AWS Batch pekerjaan, kebijakan penjadwalan, dan lingkungan layanan. Untuk informasi selengkapnya, lihat [AWS Batch Kebijakan, peran, dan izin IAM](IAM_policies.md).

------
#### [ Configure quota management resources (AWS Batch console) ]

 AWS Batch Konsol menyediakan alur kerja terintegrasi untuk membuat semua sumber daya yang diperlukan untuk manajemen kuota. Alur kerja pembuatan antrian pekerjaan manajemen kuota juga menciptakan kebijakan penjadwalan dan lingkungan layanan yang diaktifkan manajemen kuota.

1. Buka AWS Batch konsol di [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).

1. **Di panel navigasi, pilih **Antrian pekerjaan dan kemudian Buat**.**

1. **Untuk **jenis Orkestrasi**, pilih Pelatihan. SageMaker**

1. Untuk **konfigurasi antrian Job**:

   1. Untuk **Nama**, masukkan nama antrian pekerjaan.

   1. Untuk **Prioritas**, masukkan nilai antara 0 dan 1000. Antrian pekerjaan dengan prioritas lebih tinggi diberikan preferensi untuk lingkungan layanan.

1. Untuk **Penjadwalan**:

   1. Untuk **algoritma Penjadwalan**, pilih Manajemen **kuota**.

   1. Untuk **kebijakan Penjadwalan ARN**:
      + Jika kebijakan penjadwalan sudah ada yang menentukan manajemen kuota, pilih dari menu tarik-turun.
      + Jika tidak, pilih **Buat kebijakan penjadwalan**.

        1. Bilah sisi terbuka untuk mengonfigurasi kebijakan penjadwalan manajemen kuota.

        1. Berikan **Nama** untuk kebijakan penjadwalan.

        1. Pilih **Buat**. Bidang **ARN kebijakan Penjadwalan** sekarang diisi.

1. Untuk konfigurasi **lingkungan Layanan**, di bawah **lingkungan layanan Terhubung**:
**catatan**  
Lingkungan layanan yang diaktifkan manajemen kuota hanya dapat dihubungkan ke satu antrian pekerjaan yang diaktifkan manajemen kuota.

   1. Jika lingkungan layanan telah dibuat yang kompatibel dengan manajemen kuota dan belum terhubung ke antrian pekerjaan yang mendukung manajemen kuota, pilih dari menu tarik-turun.

   1. Jika tidak, pilih **Buat lingkungan layanan**. Sidebar terbuka untuk mengkonfigurasi lingkungan layanan.

      1. Berikan **Nama** untuk lingkungan layanan.

      1. Berikan setidaknya satu batas kapasitas (dan paling banyak 5). Untuk setiap batas kapasitas, pilih **jenis Instance** dari dropdown dan **jumlah maksimum** instance.

1. (Opsional) Untuk **batas status Job**:

   1. Untuk **Misconfiguration**, pilih salah satu `SERVICE_ENVIRONMENT_MAX_RESOURCE` dan masukkan **Maksimum runnable time (**detik).

   1. Untuk **Kapasitas**, pilih `INSUFFICIENT_INSTANCE_CAPACITY` dan masukkan **Waktu runnable maksimum (detik)**.

1. Pilih **Buat antrean pekerjaan**.

------
#### [ Configure quota management resources (AWS CLI) ]

Untuk mengonfigurasi manajemen kuota melalui AWS CLI, buat kebijakan penjadwalan, lingkungan layanan, dan antrian pekerjaan. Kebijakan penjadwalan dan lingkungan layanan harus kompatibel dengan manajemen kuota dan dibuat sebelum membuat antrian pekerjaan.

**Buat kebijakan penjadwalan**

Gunakan `create-scheduling-policy` perintah untuk membuat kebijakan penjadwalan yang kompatibel dengan manajemen kuota. Berikan kebijakan pembagian kuota selama pembuatan:

```
aws batch create-scheduling-policy \
  --name my-qm-sagemaker-scheduling-policy \
  --quota-share-policy idleResourceAssignmentStrategy="FIFO"
```

Pastikan kebijakan penjadwalan berhasil dibuat:

```
aws batch describe-scheduling-policies \
  --arns arn-for-my-qm-sagemaker-scheduling-policy
```

**Ciptakan lingkungan layanan**

Gunakan `create-service-environment` perintah untuk membuat lingkungan layanan yang diaktifkan manajemen kuota. Pastikan bahwa batas kapasitas menggunakan jenis instans yang diterima oleh pekerjaan SageMaker Pelatihan, seperti `ml.g6.xlarge` atau`ml.p4d.24xlarge`.

```
aws batch create-service-environment \
  --service-environment-name my-qm-sagemaker-service-env \
  --service-environment-type SAGEMAKER_TRAINING \
  --capacity-limits capacityUnit=instance_type,maxCapacity=instance_count
```

Verifikasi lingkungan layanan berhasil dibuat:

```
aws batch describe-service-environments \
  --service-environments my-qm-sagemaker-service-env
```

**Buat antrian pekerjaan**

Gunakan `create-job-queue` perintah untuk membuat antrean pekerjaan yang diaktifkan manajemen kuota. Kriteria berikut harus dipenuhi:
+ Lingkungan `SAGEMAKER_TRAINING` layanan tunggal harus disediakan yang saat ini tidak terhubung ke antrian pekerjaan lain.
+ Lingkungan layanan harus menyatakan batas kapasitas dalam hal jenis instance, seperti`ml.m6i.xlarge`, bukan`NUM_INSTANCES`.
+ Kebijakan penjadwalan harus terhubung yang `quotaSharePolicy` berisi.
+ `jobQueueType`Pasti`SAGEMAKER_TRAINING`.

```
aws batch create-job-queue \
  --job-queue-name my-qm-sagemaker-jq \
  --job-queue-type SAGEMAKER_TRAINING \
  --priority 1 \
  --service-environment-order order=1,serviceEnvironment=my-qm-sagemaker-service-env \
  --scheduling-policy-arn arn-for-my-qm-sagemaker-scheduling-policy
```

Verifikasi antrian pekerjaan berhasil dibuat:

```
aws batch describe-job-queues \
  --job-queues my-qm-sagemaker-jq
```

Pastikan bahwa:
+ `state`adalah `ENABLED`
+ `status`adalah `VALID`
+ `statusReason`adalah `JobQueue Healthy`

------

# Membuat pembagian kuota
<a name="create-quota-shares"></a>

Pembagian kuota berfungsi sebagai antrian virtual dalam antrian pekerjaan terkait yang diulang oleh AWS Batch penjadwal saat penjadwalan. Mereka memungkinkan administrator mengalokasikan kuota komputasi ke tim atau proyek melalui` capacity limits `, dengan konfigurasi eksplisit untuk strategi berbagi sumber daya. 

## Prasyarat
<a name="create-quota-shares-prerequisites"></a>

Sebelum membuat pembagian kuota, pastikan Anda memiliki:
+ **Kebijakan penjadwalan manajemen kuota, lingkungan layanan, dan antrian pekerjaan** — Kebijakan penjadwalan manajemen kuota, lingkungan layanan, dan antrian pekerjaan dengan manajemen kuota diaktifkan. Untuk informasi selengkapnya, lihat [Buat sumber daya manajemen kuota](create-quota-management-resources.md).
+ **Izin IAM — Izin** untuk membuat dan mengelola AWS Batch pembagian kuota. Untuk informasi selengkapnya, lihat [AWS Batch Kebijakan, peran, dan izin IAM](IAM_policies.md).

------
#### [ Configure quota shares (AWS Batch console) ]

1. Buka AWS Batch konsol di [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).

1. Di panel navigasi, pilih **Antrian pekerjaan dan pilih antrian** pekerjaan yang diaktifkan manajemen kuota dari daftar. Pilih tautan nama antrian pekerjaan.

1. Di bagian **Berbagi kuota**, pilih **Buat pembagian kuota**.

1. Berikan **Nama** untuk pembagian kuota.

1. Untuk **batas Kapasitas**, pilih **Tambahkan batas kapasitas**. Setidaknya satu batas kapasitas harus ditentukan.

   1. Pilih **jenis Instance** dari dropdown, dan atur **Instance Maksimum** yang telah dialokasikan oleh pembagian kuota ini.

   1. (Opsional) Pilih **Tambahkan batas kapasitas** dan ulangi untuk melampirkan paling banyak lima batas kapasitas.

1. Untuk **Pembagian Kapasitas**, pilih bagaimana pembagian kuota ini membagi kapasitasnya dengan pembagian kuota lainnya dalam antrian pekerjaan yang sama:
   + Pilih **Cadangan** jika pembagian kuota tidak boleh meminjamkan atau meminjam komputasi idle.
   + Pilih **Lend** jika pembagian kuota dapat meminjamkan idle compute ke saham kuota lainnya.
   + Pilih **Lend dan pinjam jika pembagian kuota dapat meminjamkan dan meminjam** komputasi idle, dengan komputasi pinjamkan direklamasi melalui preemption cross-share saat pekerjaan tiba.

1. (Opsional) Untuk **preemption In-share**, pilih apakah akan mengaktifkan atau menonaktifkan preemption in-share. Mengaktifkan preemption in-share memungkinkan pekerjaan dengan prioritas lebih tinggi untuk mendahului pekerjaan dengan prioritas lebih rendah yang sudah ada di,, atau status. `SCHEDULED` `STARTING` `RUNNING` Menonaktifkan preemption in-share berarti bahwa pekerjaan prioritas yang lebih tinggi akan menunggu kapasitas tersedia.

1. Pilih **Buat pembagian kuota**.

------
#### [ Configure quota shares (AWS CLI) ]

Gunakan `create-quota-share` perintah untuk membuat pembagian kuota. Anda harus memilih strategi berbagi sumber daya dan apakah akan mengaktifkan preemption in-share.

**Meminjamkan dan meminjam contoh**

Contoh berikut membuat pembagian kuota yang dapat meminjamkan dan meminjam kapasitas idle, dengan batas pinjaman 100% dari batas kapasitas yang dikonfigurasi. Ini juga memungkinkan preemption in-share, sehingga pekerjaan prioritas yang lebih tinggi tidak menunggu pekerjaan prioritas rendah yang telah dijadwalkan dalam SageMaker AI untuk diselesaikan.

```
aws batch create-quota-share \
  --quota-share-name lend_and_borrow_qs \
  --job-queue my-qm-sagemaker-jq \
  --capacity-limits maxCapacity=5,capacityUnit=ml.m6i.large \
  --resource-sharing-configuration strategy=LEND_AND_BORROW,borrowLimit=100 \
  --preemption-configuration inSharePreemption=ENABLED
```

**Pinjamkan hanya contoh**

Pembagian kuota dapat dikonfigurasi untuk hanya meminjamkan kapasitas idle, tetapi tidak meminjamnya sendiri. Contoh berikut berpasangan `LEND` dengan menonaktifkan preemption in-share.

```
aws batch create-quota-share \
  --quota-share-name lend_qs \
  --job-queue my-qm-sagemaker-jq \
  --capacity-limits maxCapacity=8,capacityUnit=ml.m6i.large \
  --resource-sharing-configuration strategy=LEND \
  --preemption-configuration inSharePreemption=DISABLED
```

**Contoh cadangan**

Saham kuota juga dapat dikonfigurasi untuk mencadangkan kapasitas idle. Pekerjaan yang baru diajukan ketika pembagian kuota memiliki kapasitas idle dapat dimulai lebih cepat, tetapi pemanfaatan antrian secara keseluruhan akan lebih rendah jika pembagian kuota tidak memiliki pekerjaan.

```
aws batch create-quota-share \
  --quota-share-name reserved_qs \
  --job-queue my-qm-sagemaker-jq \
  --capacity-limits maxCapacity=2,capacityUnit=ml.m6i.large \
  --resource-sharing-configuration strategy=RESERVE \
  --preemption-configuration inSharePreemption=DISABLED
```

------

# Mengirimkan pekerjaan ke pembagian kuota
<a name="submit-job-quota-share"></a>

Antrian pekerjaan manajemen kuota mengharuskan semua pekerjaan menentukan pembagian kuota pada pengajuan pekerjaan. Untuk mengirimkan pekerjaan ke pembagian kuota, tentukan `quotaShareName` di [SubmitServiceJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_SubmitServiceJob.html). A `preemptionConfiguration` secara opsional dapat diberikan untuk membatasi jumlah upaya pencegahan sebelum upaya pekerjaan masuk. `FAILED` Untuk membatasi jumlah preemption yang dialami pekerjaan, tetapkan [ServiceJobPreemptionConfiguration](https://docs.aws.amazon.com/batch/latest/APIReference/API_ServiceJobPreemptionConfiguration.html)pada `preemptionRetriesBeforeTermination` pengajuan pekerjaan.

## Kirim pekerjaan menggunakan AWS CLI
<a name="submit-job-quota-share-cli"></a>

Contoh berikut menggunakan **submit-service-job** perintah untuk mengirimkan pekerjaan ke pembagian kuota.

```
aws batch submit-service-job \
    --job-name "my-sagemaker-training-job" \
    --job-queue "my-sagemaker-job-queue" \
    --service-job-type "SAGEMAKER_TRAINING" \
    --quota-share-name "my_quota_share" \
    --timeout-config '{"attemptDurationSeconds":3600}' \
    --scheduling-priority 5 \
    --service-request-payload '{\"TrainingJobName\": \"sagemaker-training-job-example\", \"AlgorithmSpecification\": {\"TrainingImage\": \"123456789012.dkr.ecr.us-east-1.amazonaws.com/pytorch-inference:1.8.0-cpu-py3\", \"TrainingInputMode\": \"File\", \"ContainerEntrypoint\":  [\"sleep\", \"1\"]}, \"RoleArn\":\"arn:aws:iam::123456789012:role/SageMakerExecutionRole\", \"OutputDataConfig\": {\"S3OutputPath\": \"s3://example-bucket/model-output/\"}, \"ResourceConfig\": {\"InstanceType\": \"ml.m5.large\", \"InstanceCount\": 1, \"VolumeSizeInGB\": 1}}'"
```