View a markdown version of this page

Obtenha um pacote de configuração - Base da Amazônia AgentCore
Combinar metadados versus conteúdo da versãoExemplos de códigoParâmetros de solicitaçãoRespostaErros

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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, retorna 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.

Combinar metadados 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 valores-chave de configuração). Se você só precisa saber quais versões existem sem buscar seu conteúdo completo, use ListConfigurationBundleVersions em vez disso.

GetConfigurationBundleVersionretorna os mesmos campos plusversionCreatedAt, que informam 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 “obter conteúdo do pacote” — os config-bundle subcomandos sãoversions, e. diff create-branch Para enumerar versões e capturar seus IDs, use agentcore config-bundle versions --name myAgentConfig --json (opcionalmente com, ou--created-by <name>) e, em seguida --branch <name>--latest-per-branch, insira os IDs de versão em. 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. GetConfigurationBundleVersionalém disso, retornaversionCreatedAt.

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 da linhagem da 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 .