Boto3 — Quickstart

boto3 adalah cara Python bicara ke AWS. Ada beberapa pola yang kalau tidak diketahui sejak awal akan menghantui: paginasi, bentuk exception, dan perbedaan client dengan resource.

Pasang dan panggil

uv add boto3
uv add --dev boto3-stubs[bedrock-runtime,s3,lambda]   # type hints, sangat layak dipasang

import boto3

s3 = boto3.client("s3")
resp = s3.list_buckets()
for b in resp["Buckets"]:
    print(b["Name"], b["CreationDate"])

Perhatikan bentuknya: nama layanan adalah string, dan hasilnya dict biasa. boto3 dibangun dari deskripsi API yang di-generate, jadi tidak ada kelas khusus per respons. Itu sebabnya boto3-stubs berharga — tanpa itu, editormu tidak tahu apa isi resp.

Client vs resource vs session

sesi = boto3.Session(profile_name="belajar", region_name="us-east-1")
bedrock = sesi.client("bedrock-runtime")

Dua client Bedrock — jangan tertukar

Paginasi — bagian yang paling sering dilewatkan

Operasi list_* mengembalikan maksimal sekian item per panggilan. Kalau kamu hanya membaca halaman pertama, kodenya terlihat berjalan sampai datanya bertambah banyak:

# SALAH — diam-diam kehilangan objek setelah halaman pertama
objek = s3.list_objects_v2(Bucket="dokumen-ku")["Contents"]

# BENAR — paginator mengurus token halaman untukmu
paginator = s3.get_paginator("list_objects_v2")
for halaman in paginator.paginate(Bucket="dokumen-ku"):
    for obj in halaman.get("Contents", []):
        print(obj["Key"])

Perhatikan juga halaman.get("Contents", []): kalau tidak ada objek sama sekali, kunci Contents tidak muncul — bukan berisi list kosong. Pola "kunci hilang saat kosong" ini berulang di banyak API AWS.

Menangani error

from botocore.exceptions import ClientError

try:
    resp = bedrock.converse(modelId=MODEL, messages=pesan)
except ClientError as e:
    kode = e.response["Error"]["Code"]
    if kode == "ThrottlingException":
        ...            # backoff lalu coba lagi
    elif kode == "AccessDeniedException":
        ...            # masalah IAM, bukan masalah kode — mengulang tidak menolong
    elif kode == "ValidationException":
        ...            # bentuk permintaanmu salah
    else:
        raise

boto3 sudah punya retry bawaan dengan exponential backoff untuk error yang bisa diulang. Kamu bisa mengaturnya, dan untuk beban kerja LLM ini layak dinaikkan:

from botocore.config import Config

cfg = Config(
    retries={"max_attempts": 5, "mode": "adaptive"},
    read_timeout=300,        # respons LLM panjang bisa lama; default terlalu pendek
    connect_timeout=10,
)
bedrock = boto3.client("bedrock-runtime", config=cfg)