View a markdown version of this page

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

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

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 bundel. Jika branchName ditentukan, mengembalikan versi terbaru pada 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 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 sebagai ListConfigurationBundleVersions gantinya.

GetConfigurationBundleVersionmengembalikan bidang plus yang samaversionCreatedAt, yang memberi tahu Anda dengan tepat kapan versi spesifik 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 subperintah adalahversions,diff, dan. create-branch Untuk menghitung versi dan menangkap ID-nya, gunakan agentcore config-bundle versions --name myAgentConfig --json (opsional dengan --branch <name>--latest-per-branch,, atau--created-by <name>), lalu masukkan ID versi keconfig-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 bundel konfigurasi. Diteruskan sebagai parameter jalur.

branchName

String

Tidak

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

GetConfigurationBundleVersion

Parameter Tipe Diperlukan Deskripsi

bundleId

Tali

Ya

ID bundel konfigurasi. Diteruskan sebagai parameter jalur.

versionId

Tali

Ya

UUID dari versi spesifik yang akan diambil. Diteruskan sebagai parameter jalur.

Respons

Kedua operasi mengembalikan bidang yang sama. GetConfigurationBundleVersionjuga kembaliversionCreatedAt.

Bidang Tipe Deskripsi

bundleArn

String

ARN dari bundel konfigurasi.

bundleId

String

ID bundel konfigurasi.

bundleName

String

Nama bundel.

description

String

Deskripsi bundel (jika diatur).

versionId

String

UUID dari 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,createdBy, dancommitMessage.

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 mundur eksponensial.

InternalServerException

500

Service-side kesalahan. Coba lagi permintaannya.