View a markdown version of this page

刪除組態套件 - Amazon Bedrock AgentCore
程式碼範例請求參數回應刪除行為錯誤

刪除組態套件

刪除組態套件及其所有版本。刪除是非同步的 — API 會立即傳回 DELETING 狀態，且服務會在背景移除套件及其版本歷史記錄。

您無法刪除作用中 A/B 測試所參考的套件。先停止 A/B 測試。

程式碼範例

範例
AgentCore CLI

從專案組態中移除套件，然後部署 以傳播刪除：

agentcore remove config-bundle

agentcore deploy

CLI 會提示您選取要移除的套件。

若要以非互動方式移除特定套件 （例如，在指令碼中），請以 傳遞套件名稱，--name並使用 略過確認提示-y：

agentcore remove config-bundle --name MyBundle -y

agentcore deploy
AWS SDK (boto3)
import boto3

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

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

print(f"Bundle ID: {response['bundleId']}")
print(f"Status: {response['status']}")  # DELETING

請求參數

參數 Type 必要 描述

bundleId

String

是

要刪除的組態套件 ID。以路徑參數傳遞。

回應

API 會傳回 HTTP 202 （已接受），表示刪除已排入佇列。

欄位 Type Description

bundleId

String

要刪除的套件 ID。

status

String

套件的狀態。傳回 DELETING。

刪除行為

  • 操作是等冪的 - 在已刪除的套件上呼叫 delete 會傳回相同的回應，而不會發生錯誤。

  • 所有分支的所有版本都會與套件一起刪除。

  • 刪除完成後，套件 ID 和名稱即可重複使用。

  • 如果使用中的 A/B 測試參考套件，刪除會失敗並顯示 ConflictException。先停止 A/B 測試。

錯誤

錯誤 HTTP 狀態 說明

ValidationException

400

無效的請求參數。

ResourceNotFoundException

404

指定的 bundleId 不存在。

ConflictException

409

套件正由另一個資源使用 （例如，作用中的 A/B 測試），無法刪除。

AccessDeniedException

403

許可不足。驗證 IAM 政策是否包含 bedrock-agentcore:DeleteConfigurationBundle。

ThrottlingException

429

超過請求率。以指數退避重試。

InternalServerException

500

服務端錯誤。重試 請求。