View a markdown version of this page

Dapatkan bundel konfigurasi - Batuan Dasar Amazon AgentCore
Metadata bundel vs konten versiSampel KodePermintaan parameterResponsKesalahan

Dapatkan bundel konfigurasi

Ambil bundel konfigurasi untuk memeriksa metadatanya atau membaca konten konfigurasi lengkap dari versi tertentu. Dua operasi tersedia:

  • GetConfigurationBundle— Mengembalikan versi terbaru dari sebuah bundel. Jika branchName ditentukan, mengembalikan versi terbaru di cabang itu. Jika dihilangkan, mengembalikan versi terbaru di semua cabang. Gunakan ini untuk membaca konfigurasi aktif saat ini.

  • GetConfigurationBundleVersion— Mengembalikan versi historis tertentu berdasarkan ID versi. Gunakan ini untuk memeriksa konfigurasi sebelumnya atau membandingkan versi.

Metadata bundel vs konten versi

GetConfigurationBundlemengembalikan kedua metadata tingkat bundel (nama, deskripsi, ARN) dan konten versi lengkap (komponen dengan pasangan kunci-nilai konfigurasi mereka). Jika Anda hanya perlu mengetahui versi mana yang ada tanpa mengambil konten lengkapnya, gunakan ListConfigurationBundleVersions sebagai gantinya.

GetConfigurationBundleVersionmengembalikan bidang plus yang samaversionCreatedAt, yang memberi tahu Anda kapan tepatnya versi tertentu itu dibuat (sebagai lawan daricreatedAt, yaitu saat bundel itu sendiri pertama kali dibuat).

Sampel Kode

contoh
AgentCore CLI

Lihat riwayat versi untuk bundel:

agentcore config-bundle versions --name myAgentConfig

Bandingkan dua versi berdampingan:

agentcore config-bundle diff --name myAgentConfig \
  --from <version-1> \
  --to <version-2>
catatan

Tidak ada perintah CLI “dapatkan konten bundel” langsung — config-bundle subperintahnya adalahversions,, diff dan. create-branch Untuk menghitung versi dan menangkap ID mereka, gunakan agentcore config-bundle versions --name myAgentConfig --json (opsional dengan,, atau--created-by <name>) --branch <name>--latest-per-branch, lalu masukkan ID versi ke dalam. config-bundle diff Untuk mengambil konten konfigurasi lengkap dari versi bundel, gunakan SDK/REST GetConfigurationBundleVersion operasi yang ditunjukkan di bawah ini.

AWS SDK (boto3)

Dapatkan metadata bundel dan konten versi terbaru:

import boto3

client = boto3.client("bedrock-agentcore-control", region_name="us-west-2")

response = client.get_configuration_bundle(
    bundleId="myAgentConfig-a1b2c3d4e5"
)

print(f"Bundle: {response['bundleName']}")
print(f"Version: {response['versionId']}")
print(f"Branch: {response.get('lineageMetadata', {}).get('branchName', 'N/A')}")
print(f"Components: {response['components']}")

Dapatkan versi historis tertentu:

response = client.get_configuration_bundle_version(
    bundleId="myAgentConfig-a1b2c3d4e5",
    versionId="12345678-1234-1234-1234-123456789012"
)

print(f"Version: {response['versionId']}")
print(f"Version created at: {response['versionCreatedAt']}")
print(f"Commit message: {response.get('lineageMetadata', {}).get('commitMessage', '')}")
print(f"Components: {response['components']}")

Permintaan parameter

GetConfigurationBundle

Parameter Tipe Diperlukan Deskripsi

bundleId

Tali

Ya

ID dari bundel konfigurasi. Lulus sebagai parameter jalur.

branchName

String

Tidak

Nama cabang untuk mendapatkan versi terbaru dari. Jika dihilangkan, mengembalikan versi terbaru di semua cabang.

GetConfigurationBundleVersion

Parameter Tipe Diperlukan Deskripsi

bundleId

Tali

Ya

ID dari bundel konfigurasi. Lulus sebagai parameter jalur.

versionId

Tali

Ya

UUID dari versi tertentu untuk diambil. Lulus sebagai parameter jalur.

Respons

Kedua operasi mengembalikan bidang yang sama. GetConfigurationBundleVersiontambahan kembaliversionCreatedAt.

Bidang Tipe Deskripsi

bundleArn

String

ARN dari bundel konfigurasi.

bundleId

String

ID dari bundel konfigurasi.

bundleName

String

Nama bundel.

description

String

Deskripsi bundel (jika diatur).

versionId

String

UUID versi dikembalikan.

components

Peta

Peta pengenal komponen ke konfigurasi komponen. Setiap nilai berisi configuration objek dengan pasangan kunci-nilai yang disimpan dalam versi ini.

lineageMetadata

Objek

Metadata garis keturunan versi termasukparentVersionIds,,, branchName dan. createdBy commitMessage

createdAt

Stempel waktu

Ketika bundel awalnya dibuat.

updatedAt

Stempel waktu

Saat bundel terakhir diperbarui (GetConfigurationBundle hanya).

versionCreatedAt

Stempel waktu

Ketika versi khusus ini dibuat (GetConfigurationBundleVersion hanya).

Kesalahan

Kesalahan Status HTTP Deskripsi

ValidationException

400

Parameter permintaan tidak valid.

ResourceNotFoundException

404

Yang ditentukan bundleId atau versionId tidak ada.

AccessDeniedException

403

Izin tidak mencukupi. Verifikasi kebijakan IAM termasuk bedrock-agentcore:GetConfigurationBundle ataubedrock-agentcore:GetConfigurationBundleVersion.

ThrottlingException

429

Tingkat permintaan terlampaui. Coba lagi dengan backoff eksponensial.

InternalServerException

500

Service-side kesalahan. Coba lagi permintaannya.