Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Bekerja dengan reservasi
Reservasi memberi Anda akses eksklusif ke perangkat kuantum pilihan Anda. Anda dapat menjadwalkan reservasi sesuai keinginan Anda, sehingga Anda tahu persis kapan beban kerja Anda dimulai dan berakhir eksekusi. Pemesanan tersedia dalam kenaikan 1 jam untuk semua perangkat Braket dan dapat dibatalkan hingga 48 jam sebelumnya, tanpa biaya tambahan. Kami merekomendasikan antrian tugas kuantum dan pekerjaan hibrida untuk reservasi yang akan datang sebelumnya, menggunakan ARN Reservasi Langsung Braket Anda, atau mengirimkan beban kerja selama reservasi Anda.
Biaya akses perangkat khusus didasarkan pada durasi reservasi Anda, terlepas dari berapa banyak tugas kuantum dan pekerjaan hibrida yang Anda jalankan di unit pemrosesan kuantum (QPU). Daftar terbaru komputer kuantum yang tersedia untuk pemesanan dapat ditemukan di [halaman harga](https://aws.amazon.com/braket/pricing/) kami atau melalui konsol manajemen [Amazon Braket](https://us-east-1.console.aws.amazon.com/braket/home?region=us-east-1#/devices).
**catatan**
Dalam reservasi, tidak ada batas [gateshot](braket-terms.md#gateshot-limit-term). Selain itu, untuk IonQ perangkat, jumlah tembakan minimum untuk tugas [mitigasi Kesalahan](https://docs.aws.amazon.com/braket/latest/developerguide/braket-error-mitigation.html) dikurangi menjadi 500 (vs. 2500 untuk on-demand).
**Kapan menggunakan reservasi**
Memanfaatkan akses reservasi memberi Anda kenyamanan dan prediktabilitas untuk mengetahui dengan tepat kapan beban kerja kuantum Anda dimulai dan berakhir eksekusi. Dibandingkan dengan mengirimkan tugas dan pekerjaan hibrida sesuai permintaan, Anda tidak perlu menunggu dalam antrian dengan tugas pelanggan lainnya. Karena Anda memiliki akses eksklusif ke perangkat selama reservasi, hanya beban kerja Anda yang berjalan di perangkat untuk keseluruhan reservasi.
Sebaiknya gunakan akses sesuai permintaan untuk fase desain dan pembuatan prototipe penelitian Anda, memungkinkan iterasi algoritme Anda yang cepat dan hemat biaya. Setelah Anda siap untuk menghasilkan hasil percobaan akhir, pertimbangkan untuk menjadwalkan reservasi perangkat sesuai keinginan Anda untuk memastikan bahwa Anda dapat memenuhi tenggat waktu proyek atau publikasi. Kami juga merekomendasikan penggunaan reservasi saat Anda menginginkan eksekusi tugas selama waktu tertentu, seperti saat Anda menjalankan demo langsung atau lokakarya di komputer kuantum.
**Topics**
+ [Cara membuat reservasi](braket-create-a-reservation.md)
+ [Menjalankan tugas kuantum selama reservasi](braket-run-quantum-task-with-reservation.md)
+ [Menjalankan pekerjaan hybrid selama reservasi](braket-run-hybrid-jobs-with-reservation.md)
+ [Apa yang terjadi di akhir reservasi Anda](braket-end-of-reservation.md)
+ [Membatalkan atau menjadwal ulang reservasi yang sudah ada](braket-cancel-reservation.md)
# Cara membuat reservasi
Untuk membuat reservasi, hubungi tim Braket dengan mengikuti langkah-langkah berikut:
1. Buka konsol Amazon Braket.
1. **Pilih **Braket Direct** di panel kiri, lalu di bagian **Reservasi**, pilih Perangkat cadangan.**
1. Pilih **Perangkat** yang ingin Anda pesan.
1. Berikan informasi kontak Anda termasuk **Nama** dan **Email**. Pastikan untuk memberikan alamat email yang valid yang Anda periksa secara teratur.
1. Di bawah **Beri tahu kami tentang beban kerja Anda**, berikan detail apa pun tentang beban kerja yang harus dijalankan menggunakan reservasi Anda. Misalnya, panjang reservasi yang diinginkan, kendala yang relevan, atau jadwal yang diinginkan.
Setelah Anda mengirimkan formulir, Anda menerima email dari tim Braket dengan langkah selanjutnya. Setelah reservasi Anda dikonfirmasi, Anda akan menerima ARN reservasi melalui email Anda. Anda akan perlu untuk menggunakan ARN reservasi untuk membuat tugas reservasi. Tugas yang dibuat tanpa reservasi ARN akan diserahkan ke antrian sesuai permintaan reguler dan TIDAK akan berjalan selama reservasi Anda.
**catatan**
Reservasi Anda hanya dikonfirmasi setelah Anda menerima ARN reservasi.
Reservasi tersedia dalam kenaikan minimal 1 jam dan perangkat tertentu mungkin memiliki batasan lama reservasi tambahan (termasuk durasi reservasi minimum dan maksimum). Tim Braket membagikan informasi yang relevan dengan Anda sebelum mengonfirmasi reservasi.
Tim Braket akan menghubungi Anda melalui email Anda untuk mengatur sesi 30 menit dengan ahli Braket.
# Menjalankan tugas kuantum selama reservasi
Setelah mendapatkan ARN reservasi yang valid dari [Buat reservasi](https://docs.aws.amazon.com/braket/latest/developerguide/braket-reservations.html#braket-create-a-reservation), Anda dapat membuat tugas kuantum untuk dijalankan selama reservasi. Tugas kuantum dan pekerjaan hybrid yang dikirimkan dengan reservasi ARN tidak akan muncul dalam antrian perangkat. Tugas yang diajukan sebelum waktu mulai reservasi akan tetap berada di `QUEUED` negara bagian sampai reservasi Anda dimulai.
**catatan**
Reservasi bersifat khusus untuk AWS akun dan perangkat. Hanya AWS akun yang membuat reservasi yang dapat menggunakan ARN reservasi Anda.
Selama reservasi, reservasi dan tugas reguler dapat dibuat. Untuk memverifikasi bahwa tugas kuantum Braket yang dibuat dikaitkan dengan reservasi, periksa bidang “ARN Reservasi” pada halaman tugas kuantum di konsol Braket, atau kueri bidang yang sama di metadata tugas menggunakan SDK. Sisa halaman ini menjelaskan cara menentukan tugas mana yang terkait dengan reseravasi.
Anda dapat membuat tugas kuantum menggunakan Python SDKs seperti [Braket](https://docs.aws.amazon.com/braket/latest/developerguide/braket-references.html),,, [https://github.com/NVIDIA/cuda-quantum](https://github.com/NVIDIA/cuda-quantum), [https://github.com/amazon-braket/amazon-braket-pennylane-plugin-python](https://github.com/amazon-braket/amazon-braket-pennylane-plugin-python), atau langsung dengan boto3 ([Bekerja dengan](https://docs.aws.amazon.com/braket/latest/developerguide/braket-using-boto3.html) Boto3). [Untuk menggunakan reservasi, Anda harus memiliki versi [v1.79.0](https://github.com/amazon-braket/amazon-braket-sdk-python/releases/tag/v1.79.0) atau lebih tinggi dari Amazon Braket. Python SDK](https://github.com/amazon-braket/amazon-braket-sdk-python) Anda dapat memperbarui ke Braket SDK terbaru, Qiskit penyedia dan PennyLane plugin dengan kode berikut.
```
pip install --upgrade amazon-braket-sdk amazon-braket-pennylane-plugin qiskit-braket-provider
```
**Jalankan tugas dengan manajer `DirectReservation` konteks**
Cara yang disarankan untuk menjalankan tugas dalam reservasi terjadwal Anda adalah dengan menggunakan pengelola `DirectReservation` konteks. Dengan menentukan perangkat target dan ARN reservasi Anda, manajer konteks memastikan bahwa semua tugas yang dibuat dalam pernyataan `with` Python dijalankan dengan akses eksklusif ke perangkat.
Pertama, tentukan sirkuit kuantum dan perangkat. Kemudian gunakan konteks reservasi dan jalankan tugas. **Pastikan seluruh beban kerja Anda dijalankan di dalam `with` blok; apa pun yang berjalan di luar cakupan `with` blok tidak akan dikaitkan dengan reservasi Anda\$1**
```
from braket.aws import AwsDevice, DirectReservation
from braket.circuits import Circuit
from braket.devices import Devices
bell = Circuit().h(0).cnot(0, 1)
device = AwsDevice(Devices.IonQ.ForteEnterprise1)
# run the circuit in a reservation
with DirectReservation(device, reservation_arn=""):
task = device.run(bell, shots=100)
```
Anda dapat membuat tugas kuantum dalam reservasi menggunakan CUDA-QPennyLane,, dan Qiskit plugin, selama `DirectReservation` konteksnya aktif saat membuat tugas kuantum. Misalnya, dengan Qiskit-Braket penyedia, Anda dapat menjalankan tugas sebagai berikut.
```
from braket.devices import Devices
from braket.aws import DirectReservation
from qiskit import QuantumCircuit
from qiskit_braket_provider import BraketProvider
qc = QuantumCircuit(2)
qc.h(0)
qc.cx(0, 1)
qpu = BraketProvider().get_backend("Forte Enterprise 1")
# run the circuit in a reservation
with DirectReservation(Devices.IonQ.ForteEnterprise1, reservation_arn=""):
qpu_task = qpu.run(qc, shots=10)
```
Demikian pula, kode berikut menjalankan sirkuit selama reservasi menggunakan Braket-PennyLane plugin.
```
from braket.devices import Devices
from braket.aws import DirectReservation
import pennylane as qml
dev = qml.device("braket.aws.qubit", device_arn=Devices.IonQ.ForteEnterprise1.value, wires=2, shots=10)
@qml.qnode(dev)
def bell_state():
qml.Hadamard(wires=0)
qml.CNOT(wires=[0, 1])
return qml.probs(wires=[0, 1])
# run the circuit in a reservation
with DirectReservation(Devices.IonQ.ForteEnterprise1, reservation_arn=""):
probs = bell_state()
```
**Mengatur konteks reservasi secara manual**
Atau, Anda dapat mengatur konteks reservasi secara manual dengan kode berikut.
```
# set reservation context
reservation_context = DirectReservation(device, reservation_arn="").start()
# run circuit during reservation
task = device.run(bell, shots=100)
```
Ini sangat ideal untuk notebook Jupyter di mana konteksnya dapat dijalankan di sel pertama dan semua tugas berikutnya akan berjalan di reservasi.
**catatan**
Sel yang berisi `.start()` panggilan *hanya boleh dijalankan sekali*.
Untuk beralih kembali ke mode sesuai permintaan: Mulai ulang notebook Jupyter, atau hubungi yang berikut ini untuk mengubah konteks kembali ke mode sesuai permintaan.
```
reservation_context.stop() # unset reservation context
```
**catatan**
Reservasi memiliki waktu mulai dan berakhir yang telah ditentukan sebelumnya (lihat [Membuat reservasi](https://docs.aws.amazon.com/braket/latest/developerguide/braket-reservations.html#braket-create-a-reservation)). Metode `reservation_context.start()` dan `reservation_context.stop()` metode **tidak memulai atau mengakhiri reservasi**. Sebaliknya, saat konteksnya aktif, tugas kuantum apa pun yang Anda buat akan dikaitkan dengan reservasi Anda, dan hanya akan berjalan selama reservasi terjadwal Anda. Konteks reservasi tidak berpengaruh pada waktu reservasi yang dijadwalkan.
**Secara eksplisit lulus ARN reservasi saat membuat tugas**
Cara lain untuk membuat tugas selama reservasi adalah dengan secara eksplisit melewati ARN reservasi saat menelepon. `device.run()`
```
task = device.run(bell, shots=100, reservation_arn="")
```
Metode ini secara langsung mengaitkan tugas kuantum dengan ARN reservasi, memastikannya berjalan selama periode cadangan. Untuk opsi ini, tambahkan ARN reservasi ke setiap tugas yang Anda rencanakan untuk dijalankan selama reservasi. Namun, perhatikan bahwa saat menggunakan pustaka pihak ketiga seperti Qiskit atauPennyLane, mungkin sulit untuk memastikan bahwa tugas yang dikirimkan menggunakan ARN reservasi yang benar. Untuk alasan ini, disarankan menggunakan manajer DirectReservation konteks.
Saat langsung menggunakan boto3, lewati ARN reservasi sebagai asosiasi saat membuat tugas.
```
import boto3
braket_client = boto3.client("braket")
kwargs["associations"] = [
{
"arn": "",
"type": "RESERVATION_TIME_WINDOW_ARN",
}
]
response = braket_client.create_quantum_task(**kwargs)
```
# Menjalankan pekerjaan hybrid selama reservasi
Setelah Anda memiliki fungsi Python untuk dijalankan sebagai pekerjaan hybrid, Anda dapat menjalankan pekerjaan hybrid dalam reservasi dengan meneruskan argumen `reservation_arn` kata kunci. Semua tugas dalam pekerjaan hybrid menggunakan ARN reservasi. Yang penting, pekerjaan hybrid dengan `reservation_arn` *hanya memutar komputasi klasik setelah reservasi Anda dimulai*.
**catatan**
Pekerjaan hybrid yang berjalan selama reservasi *hanya berhasil menjalankan* tugas kuantum pada perangkat yang dipesan. Mencoba menggunakan perangkat Braket sesuai permintaan yang berbeda akan menghasilkan kesalahan. Jika Anda perlu menjalankan tugas pada simulator sesuai permintaan dan perangkat yang dipesan dalam pekerjaan hibrida yang sama, gunakan `DirectReservation` sebagai gantinya.
Kode berikut menunjukkan cara menjalankan pekerjaan hybrid selama reservasi.
```
from braket.aws import AwsDevice
from braket.devices import Devices
from braket.jobs import get_job_device_arn, hybrid_job
@hybrid_job(device=Devices.IonQ.ForteEnterprise1, reservation_arn="")
def example_hybrid_job():
# declare AwsDevice within the hybrid job
device = AwsDevice(get_job_device_arn())
bell = Circuit().h(0).cnot(0, 1)
task = device.run(bell, shots=10)
```
Untuk pekerjaan hybrid yang menggunakan skrip Python (lihat bagian tentang [Membuat Job Hybrid pertama Anda](https://docs.aws.amazon.com/braket/latest/developerguide/braket-jobs-first.html) di panduan pengembang), Anda dapat menjalankannya dalam reservasi dengan meneruskan argumen `reservation_arn` kata kunci saat membuat pekerjaan.
```
from braket.aws import AwsQuantumJob
from braket.devices import Devices
job = AwsQuantumJob.create(
Devices.IonQ.ForteEnterprise1,
source_module="algorithm_script.py",
entry_point="algorithm_script:start_here",
reservation_arn=""
)
```
# Apa yang terjadi di akhir reservasi Anda
Setelah reservasi berakhir, Anda tidak lagi memiliki akses khusus ke perangkat. Beban kerja yang tersisa yang diantri dengan reservasi ini akan dibatalkan secara otomatis.
**catatan**
Pekerjaan apa pun yang `RUNNING` berstatus saat reservasi berakhir dibatalkan. Kami merekomendasikan menggunakan [pos pemeriksaan untuk menyimpan dan memulai kembali](https://docs.aws.amazon.com/braket/latest/developerguide/braket-jobs-checkpoints.html) pekerjaan sesuai keinginan Anda.
Reservasi yang sedang berlangsung, seperti setelah reservasi dimulai dan sebelum reservasi berakhir, tidak dapat diperpanjang karena setiap reservasi mewakili akses perangkat khusus mandiri. Misalnya, dua back-to-back reservasi dianggap terpisah dan tugas yang tertunda dari reservasi pertama dibatalkan secara otomatis. Mereka tidak melanjutkan di reservasi kedua.
**catatan**
Reservasi mewakili akses perangkat khusus untuk AWS akun Anda. Bahkan jika perangkat tetap menganggur, tidak ada pelanggan lain yang dapat menggunakannya. Oleh karena itu, Anda dikenakan biaya untuk jangka waktu yang dipesan, terlepas dari waktu yang digunakan.
# Membatalkan atau menjadwal ulang reservasi yang sudah ada
Anda dapat membatalkan reservasi Anda tidak kurang dari 48 jam sebelum waktu mulai reservasi yang dijadwalkan. Untuk membatalkan, tanggapi email konfirmasi reservasi yang Anda terima dengan permintaan pembatalan Anda.
Untuk menjadwal ulang, Anda harus membatalkan reservasi yang ada, dan kemudian membuat yang baru.