View a markdown version of this page

Daftar bundel konfigurasi - Batuan Dasar Amazon AgentCore
Sampel KodePermintaan parameterResponsKesalahan

Daftar bundel konfigurasi

Buat daftar bundel konfigurasi di akun Anda, atau daftar versi bundel tertentu. Dua operasi tersedia:

  • ListConfigurationBundles— Mengembalikan semua bundel di akun Anda dengan informasi ringkasan.

  • ListConfigurationBundleVersions— Mengembalikan semua versi bundel tertentu, dengan pemfilteran opsional berdasarkan cabang atau sumber pembuatan.

Kedua operasi mendukung pagination.

Sampel Kode

contoh
AgentCore CLI

Daftar versi bundel:

agentcore config-bundle versions --name myAgentConfig

Filter berdasarkan cabang:

agentcore config-bundle versions --name myAgentConfig --branch mainline

Tampilkan hanya versi terbaru per cabang:

agentcore config-bundle versions --name myAgentConfig --latest-per-branch

Filter menurut pembuat (misalnya, versi yang dibuat oleh pekerjaan rekomendasi):

agentcore config-bundle versions --name myAgentConfig --created-by recommendation
AWS SDK (boto3)

Daftar semua bundel dengan pagination:

import boto3

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

paginator = client.get_paginator("list_configuration_bundles")
for page in paginator.paginate(maxResults=20):
    for bundle in page["bundles"]:
        print(f"{bundle['bundleId']} - {bundle['bundleName']}")

Daftar versi bundel tertentu:

response = client.list_configuration_bundle_versions(
    bundleId="myAgentConfig-a1b2c3d4e5",
    filter={"branchName": "mainline"},
    maxResults=20,
)

for version in response["versions"]:
    lineage = version.get("lineageMetadata", {})
    print(
        f"{version['versionId']}  "
        f"{version['versionCreatedAt']}  "
        f"{lineage.get('commitMessage', '')}"
    )

Permintaan parameter

ListConfigurationBundles

Parameter Tipe Diperlukan Deskripsi

maxResults

Bulat

Tidak

Jumlah maksimum hasil yang akan dikembalikan per halaman. Rentang: 1—100.

nextToken

String

Tidak

Token pagination dari respons sebelumnya.

ListConfigurationBundleVersions

Parameter Tipe Diperlukan Deskripsi

bundleId

Tali

Ya

ID dari bundel konfigurasi. Lulus sebagai parameter jalur.

filter

Objek

Tidak

Filter opsional. Lihat Filter versi di bawah ini.

maxResults

Bilangan Bulat

Tidak

Jumlah maksimum hasil yang akan dikembalikan per halaman. Rentang: 1—100.

nextToken

String

Tidak

Token pagination dari respons sebelumnya.

Filter versi

Bidang Tipe Deskripsi

branchName

String

Kembalikan hanya versi di cabang ini.

createdByName

String

Kembalikan hanya versi yang dibuat oleh nama sumber ini (misalnya, optimization-job ataurecommendation).

latestPerBranch

Boolean

Kapantrue, hanya mengembalikan versi terbaru untuk setiap cabang. Dapat dikombinasikan dengan branchName untuk mendapatkan yang terbaru untuk cabang tertentu.

Respons

ListConfigurationBundles

Bidang Tipe Deskripsi

bundles

Daftar

Daftar ringkasan bundel. Masing-masing berisibundleArn,bundleId,bundleName, dandescription.

nextToken

String

Token pagination untuk halaman berikutnya. Absen ketika tidak ada hasil lagi.

ListConfigurationBundleVersions

Bidang Tipe Deskripsi

versions

Daftar

Daftar ringkasan versi. Masing-masing berisi bundleArnbundleId,,versionId,lineageMetadata, danversionCreatedAt.

nextToken

String

Token pagination untuk halaman berikutnya. Absen ketika tidak ada hasil lagi.

Kesalahan

Kesalahan Status HTTP Deskripsi

ValidationException

400

Parameter permintaan tidak valid.

ResourceNotFoundException

404

Yang ditentukan bundleId tidak ada (ListConfigurationBundleVersions hanya).

AccessDeniedException

403

Izin tidak mencukupi.

ThrottlingException

429

Tingkat permintaan terlampaui. Coba lagi dengan backoff eksponensial.

InternalServerException

500

Service-side kesalahan. Coba lagi permintaannya.