View a markdown version of this page

Obtenha um pacote de configuração - Amazon Bedrock AgentCore
Metadados do pacote versus conteúdo da versãoExemplos de códigoParâmetros de solicitaçãoRespostaErros

Obtenha um pacote de configuração

Recupere um pacote de configuração para inspecionar seus metadados ou ler o conteúdo completo da configuração de uma versão específica. Duas operações estão disponíveis:

  • GetConfigurationBundle— Retorna a versão mais recente de um pacote. Se branchName for especificado, retornará a versão mais recente dessa ramificação. Se omitido, retorna a versão mais recente em todas as ramificações. Use isso para ler a configuração ativa atual.

  • GetConfigurationBundleVersion— Retorna uma versão histórica específica por ID de versão. Use isso para inspecionar configurações anteriores ou comparar versões.

Metadados do pacote versus conteúdo da versão

GetConfigurationBundleretorna os metadados em nível de pacote (nome, descrição, ARN) e o conteúdo completo da versão (componentes com seus pares de chave-valor de configuração). Se você só precisa saber quais versões existem sem buscar o conteúdo completo, use ListConfigurationBundleVersions em vez disso.

GetConfigurationBundleVersionretorna os mesmos fields plusversionCreatedAt, que informa exatamente quando essa versão específica foi criada (ao contrário decreatedAt, que é quando o pacote em si foi criado pela primeira vez).

Exemplos de código

exemplo
AgentCore CLI

Veja o histórico de versões de um pacote:

agentcore config-bundle versions --name myAgentConfig

Compare duas versões lado a lado:

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

Não há um comando CLI direto para “obter conteúdo do pacote” — config-bundle os subcomandos versions sãodiff, e. create-branch Para enumerar versões e capturar suas IDs, use agentcore config-bundle versions --name myAgentConfig --json (opcionalmente com, ou--created-by <name>) e--branch <name>, em seguida--latest-per-branch, insira as IDs de versão. config-bundle diff Para obter o conteúdo completo da configuração de uma versão do pacote, use a SDK/REST GetConfigurationBundleVersion operação mostrada abaixo.

AWS SDK (boto3)

Obtenha os metadados do pacote e o conteúdo da versão mais recente:

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']}")

Obtenha uma versão histórica específica:

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']}")

Parâmetros de solicitação

GetConfigurationBundle

Parâmetro Tipo Obrigatório Descrição

bundleId

String

Sim

O ID do pacote de configuração. Passado como parâmetro de caminho.

branchName

String

Não

Nome da filial da qual obter a versão mais recente. Se omitido, retorna a versão mais recente em todas as ramificações.

GetConfigurationBundleVersion

Parâmetro Tipo Obrigatório Descrição

bundleId

String

Sim

O ID do pacote de configuração. Passado como parâmetro de caminho.

versionId

String

Sim

O UUID da versão específica a ser recuperada. Passado como parâmetro de caminho.

Resposta

Ambas as operações retornam os mesmos campos. GetConfigurationBundleVersionretorna adicionalmenteversionCreatedAt.

Campo Tipo Description

bundleArn

String

ARN do pacote de configuração.

bundleId

String

ID do pacote de configuração.

bundleName

String

Nome do pacote.

description

String

Descrição do pacote (se definido).

versionId

String

UUID da versão retornada.

components

Mapa

Mapa do identificador do componente para a configuração do componente. Cada valor contém um configuration objeto com os pares de valores-chave armazenados nesta versão.

lineageMetadata

Objeto

Metadados de linhagem de versãoparentVersionIds, incluindo, branchNamecreatedBy, e. commitMessage

createdAt

Timestamp

Quando o pacote foi criado originalmente.

updatedAt

Timestamp

Quando o pacote foi atualizado pela última vez (GetConfigurationBundle somente).

versionCreatedAt

Timestamp

Quando essa versão específica foi criada (GetConfigurationBundleVersion somente).

Erros

Erro Status HTTP Description

ValidationException

400

Parâmetros de solicitação inválidos.

ResourceNotFoundException

404

O especificado bundleId ou versionId não existe.

AccessDeniedException

403

Permissões insuficientes. Verifique se as políticas do IAM incluem bedrock-agentcore:GetConfigurationBundle oubedrock-agentcore:GetConfigurationBundleVersion.

ThrottlingException

429

Taxa de solicitações excedida. Novas tentativas com recuo exponencial.

InternalServerException

500

Service-side erro. Repetir a solicitação .