Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Panduan migrasi registri yang komprehensif
AWS Agen Registry - Bermigrasi ke namespace baru agent-registry
Pengantar
Sebagai bagian dari peluncuran agent-registry namespace baru 6 Agustus 2026, AWS Agen Registry memperkenalkan perubahan signifikan pada prinsip layanan, data, dan model API. Jika Anda menggunakan Registry AWS Agen di bawah bedrock-agentcore namespace, Anda harus menyelesaikan migrasi yang mencakup tiga area:
-
Namespace dan perubahan konfigurasi — Kami memindahkan AWS Agen Registry dari namespace AWS Bedrock ke AgentCore namespace khusus sendiri. Perubahan namespace ini hanya berlaku untuk AWS Agen Registry. Semua penawaran lainny AgentCore a—seperti Identity, Gateway, Runtime, dan Policy—tetap tidak terpengaruh. Untuk AWS Agen Registry, namespace layanan berubah dari
bedrock-agentcoremenjadiagent-registry. Ini mempengaruhi setiap permukaan yang mereferensikan layanan: titik akhir, kebijakan IAM, klien SDK, perintah CLI, ARN sumber daya, dan integrasi pengamatan. Anda harus memperbarui kode dan infrastruktur Anda untuk menggunakan namespace baru. -
Perubahan skema API — Model data catatan registri dan registri diperbarui berdasarkan umpan balik pelanggan dari
bedrock-agentcorenamespace. Perubahan ini merusak kompatibilitas mundur dengan skema API yang ada. Kode aplikasi Anda yang membuat atau mengurai permintaan dan tanggapan API harus diperbarui untuk mencerminkan skema baru, sebagai bagian dari migrasi ke namespace baru. -
Migrasi data — Anda harus memigrasikan registri dan catatan registri yang ada dari namespace lama ke yang baru. Kami menyediakan alat migrasi untuk mengekstrak data Anda, mengubahnya ke skema baru, dan memuatnya ke namespace baru. Data dimigrasikan ke akun dan wilayah yang sama — hanya namespace yang berubah.
Panduan ini mencakup setiap area secara rinci dengan contoh sebelum dan sesudah untuk membantu Anda merencanakan dan menjalankan migrasi Anda.
Apa garis waktu migrasi?
Ada dua tonggak penting yang harus Anda ingat untuk migrasi ini:
-
6 Agustus 2026 —
agent-registryNamespace baru untuk AWS Agen Registry resmi diluncurkan. Akses layanan di konsol AWS Agen Registry. Jika Anda memiliki registri dan catatan yang ada, Anda memiliki akses simultan ke ruang nama bedrock-agentcoredanagent-registry. Alat migrasi tersedia di repositori https://github.com/awslabs/agentcore-samples/tree/main/01-features/07-centralize-and-govern-your-ai-infrastructure/03-registry/04-migrate-to-new-namespacesampel agen di situs web. GitHub Anda dapat memulai proses migrasi. catatan
Jika Anda adalah pelanggan baru tanpa registri atau catatan yang ada pada 6 Agustus 2026, Anda tidak dapat mengakses Registry AWS Agen melalui namespace.
bedrock-agentcoreMulai gunakan AWS Agent Registry langsung dariagent-registrynamespace. -
17 September 2026 - Jendela migrasi ditutup.
bedrock-agentcoreNamespace lama dimatikan pada tanggal ini. Anda kehilangan read/write akses ke layanan dan data yang tersisa di namespace lama. Setelah tanggal ini, Anda harus menggunakanagent-registrynamespace.
Namespace dan perubahan konfigurasi
agent-registryNamespace menggantikan bedrock-agentcore di tempat-tempat berikut. Bagian ini mencantumkan setiap permukaan yang berubah dan memberikan contoh cara memperbarui kode Anda.
penting
Perubahan namespace hanya memengaruhi API yang ditawarkan oleh AWS Agen Registry, tetapi tidak pada AWS Bedrock lainnya AgentCore, seperti AWS AgentCore Identity. Dengan demikian, identitas beban kerja dan sumber daya penyedia kredensia OAuth tetap berada di bawah namespace. bedrock-agentcore
Titik akhir layanan
Aplikasi Anda harus menunjuk ke nama host titik akhir yang baru. Titik akhir baru menggunakan .api.aws domain.
| Permukaan | Nilai lama | Nilai baru |
|---|---|---|
|
Titik akhir bidang data |
|
|
|
Titik akhir bidang kontrol |
|
|
IAM dan keamanan
Semua kebijakan IAM, kebijakan kontrol layanan (SCP), dan batas izin yang referensi bedrock-agentcore harus diperbarui. ARN sumber daya juga berubah untuk mencerminkan namespace baru.
| Permukaan | Nilai lama | Nilai baru |
|---|---|---|
|
Awalan tindakan IAM |
|
|
|
Pemimpin layanan |
|
|
|
Pendaftaran ARN |
|
|
|
Rekam ARN |
|
|
Jika Anda memiliki otomatisasi yang mengurai ARN atau menyimpannya, perbarui referensi tersebut juga. Kebijakan kustom dengan kondisi pada awalan tindakan IAM atau prinsipal layanan harus diperbarui agar sesuai dengan nilai baru. Untuk melihat daftar lengkap izin IAM yang terkait dengan AWS Agen Registry, lihat referensi izin IAM AWS Agen Registry.
catatan
Jika saat ini Anda menggunakan Kebijakan BedrockAgentCoreFullAccess AWS Terkelola untuk akses Registri AWS Agen (lihat detail BedrockAgentCoreFullAccess kebijakan), Anda harus menggantinya dengan kebijakan AgentRegistryFullAccess terkelola baru (tersedia pada 6 Agustus 2026). Kebijakan ter BedrockAgentCoreFullAccess kelola lama TIDAK akan diperbarui untuk menyertakan agent-registry:* izin.
SDK, CLI, dan infrastruktur
Perbarui kode aplikasi, skrip penerapan, dan templat infrastruktur sebagai kode untuk mereferensikan kelas klien baru dan namespace CLI.
| Permukaan | Nilai lama | Nilai baru |
|---|---|---|
|
Kelas klien Dataplane SDK |
|
|
|
Kelas klien Controlplane SDK |
|
|
|
Ruang nama CLI |
|
|
|
Kode Kuota Layanan |
|
|
Jika sebelumnya Anda meminta kenaikan kuota khusus berdasarkan kode bedrock-agentcore layanan, Anda harus memintanya kembali di bawahagent-registry.
Pengamatan dan peristiwa
Perbarui kueri CloudTrail Lake, kueri Athena, integrasi SIEM, EventBridge aturan, dasbor, dan alarm yang CloudWatch mereferensikan namespace lama.
| Permukaan | Nilai lama | Nilai baru |
|---|---|---|
|
CloudTrail sumber acara |
|
|
|
EventBridge sumber |
|
|
|
CloudWatch ruang nama |
|
|
EventBridge notifikasi
Di bawah bedrock-agentcore namespace, AWS Agen Registry memancarkan dua EventBridge peristiwa Amazon di bawah sumber aws.bedrock-agentcore peristiwa. Sumber peristiwa sekarang berubah menjadiaws.agent-registry, ARN sumber daya mengadopsi namespace baru, dan cakupan notifikasi diperluas ke catatan registri penuh dan siklus hidup registri. Acara terus pergi ke EventBridge bus default di akun sumber daya itu sendiri. Anda harus memperbarui EventBridge aturan apa pun yang cocok pada sumber lama atau string tipe detail lama.
| Permukaan | Nilai lama | Nilai baru |
|---|---|---|
|
Sumber peristiwa |
|
|
|
Namespace ARN sumber daya |
|
|
|
Bus acara |
Bus default |
Bus default (tidak berubah) |
|
Registry-record acara |
1 tipe detail ( |
5 tipe detail (siklus hidup persetujuan penuh) |
|
Peristiwa registri |
1 tipe detail ( |
7 tipe detail (siklus hidup registri penuh) |
|
Muatan |
|
(tidak berubah) |
penting
Jenis detail registri (induk) berubah dari kalimat menjadi string status pendek. Aturan yang cocok dengan tipe detail Registry State transitions from Creating to Ready tidak lagi diaktifkan - perbarui keRegistry Ready. Jenis detail rekaman registri Registry Record State changed to Pending Approval tidak berubah, jadi aturan yang cocok terus berfungsi setelah Anda memperbarui. source
Registry-record peristiwa. Dipancarkan saat rekaman registri bertransisi antara status alur kerja persetujuan. Resourcesadalah catatan lengkap ARN; detail berisi registryRecordId danregistryId.
| Tipe detail | Pemicu |
|---|---|
|
|
Versi rekaman masuk |
|
|
|
|
|
Rekam transisi ke |
|
|
Rekam transisi ke |
|
|
Rekam transisi ke |
Acara registri. Dipancarkan pada penyediaan registri dan transisi siklus hidup. Resourcesadalah registri lengkap ARN; detail berisi registryId danregistryName.
| Tipe detail | Pemicu |
|---|---|
|
|
Registri masuk |
|
|
Registri menjadi |
|
|
Registri masuk |
|
|
Registri masuk |
|
|
Registri masuk |
|
|
Registri masuk |
|
|
Registri masuk |
Contoh acara (catatan registri).
Sebelum (bedrock-agentcorenamespace, tidak digunakan lagi):
{ "version": "0", "detail-type": "Registry Record State changed to Pending Approval", "source": "aws.bedrock-agentcore", "account": "123456789012", "region": "us-west-2", "resources": ["arn:aws:bedrock-agentcore:us-west-2:123456789012:registry/REG_ID/record/REC_ID"], "detail": { "registryRecordId": "REC_ID", "registryId": "REG_ID" } }
Setelah (agent-registrynamespace):
{ "version": "0", "detail-type": "Registry Record State changed to Pending Approval", "source": "aws.agent-registry", "account": "123456789012", "region": "us-west-2", "resources": ["arn:aws:agent-registry:us-west-2:123456789012:registry/REG_ID/record/REC_ID"], "detail": { "registryRecordId": "REC_ID", "registryId": "REG_ID" } }
catatan
Untuk mencocokkan perubahan status catatan registri dengan satu aturan, cocokkan pada source (aws.agent-registry) ditambah detail-type awalan. Registry Record State changed to Untuk mencocokkan perubahan siklus hidup registri, cocokkan pada awalan tipe detail `Registry `.
Contoh: Memperbarui kebijakan IAM
Ganti awalan tindakan dan namespace ARN sumber daya di semua kebijakan IAM Anda.
Sebelum (bedrock-agentcorenamespace, tidak digunakan lagi):
{ "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Action": [ "bedrock-agentcore:CreateRegistry", "bedrock-agentcore:GetRegistry", "bedrock-agentcore:UpdateRegistry", "bedrock-agentcore:ListRegistries", "bedrock-agentcore:DeleteRegistry", "bedrock-agentcore:CreateRegistryRecord", "bedrock-agentcore:GetRegistryRecord", "bedrock-agentcore:UpdateRegistryRecord", "bedrock-agentcore:ListRegistryRecords", "bedrock-agentcore:DeleteRegistryRecord", "bedrock-agentcore:SubmitRegistryRecordForApproval", "bedrock-agentcore:UpdateRegistryRecordStatus", "bedrock-agentcore:SearchRegistryRecords" ], "Resource": ["arn:aws:bedrock-agentcore:us-west-2:123456789012:*"] }] }
Setelah (agent-registrynamespace):
{ "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Action": [ "agent-registry:CreateRegistry", "agent-registry:GetRegistry", "agent-registry:UpdateRegistry", "agent-registry:ListRegistries", "agent-registry:DeleteRegistry", "agent-registry:CreateRegistryRecord", "agent-registry:GetRegistryRecord", "agent-registry:UpdateRegistryRecord", "agent-registry:ListRegistryRecords", "agent-registry:DeleteRegistryRecord", "agent-registry:SubmitRegistryRecordForApproval", "agent-registry:UpdateRegistryRecordStatus", "agent-registry:SearchDiscoverableRegistryRecords", "agent-registry:ListDiscoverableRegistryRecords", "agent-registry:GetDiscoverableRegistryRecord" ], "Resource": ["arn:aws:agent-registry:us-west-2:123456789012:*"] }] }
catatan
BatchGetDiscoverableRegistryRecordAPI tidak memiliki tindakan IAM sendiri. Ini mengotorisasi setiap catatan yang diminta terhadap agent-registry:GetDiscoverableRegistryRecord tindakan tersebut. Pastikan kebijakan Anda termasuk GetDiscoverableRegistryRecord untuk digunakanBatchGet.
penting
Identitas beban kerja dan sumber daya penyedia kredensia OAuth tetap berada di bawah namespace. bedrock-agentcore Jika registri Anda menggunakan URL sync (source.fromUrl) dengan kredentif OAuth atau IAM, Anda harus mempertahankan izin berikut di samping izin baru Anda: agent-registry:*
"bedrock-agentcore:CreateWorkloadIdentity", "bedrock-agentcore:GetWorkloadIdentity", "bedrock-agentcore:DeleteWorkloadIdentity"
Jangan mengganti setiap bedrock-agentcore tindakan — sumber daya identitas ini sengaja mempertahankan namespace lama.
Contoh: Memperbarui konfigurasi klien SDK
Perbarui nama layanan, kelas klien, dan URL titik akhir dalam panggilan SDK Anda.
Sebelum (bedrock-agentcorenamespace, tidak digunakan lagi):
import boto3 session = boto3.Session(region_name="us-west-2") cp_client = session.client( "bedrock-agentcore-control", endpoint_url="https://bedrock-agentcore-control.us-west-2.amazonaws.com" ) dp_client = session.client( "bedrock-agentcore", endpoint_url="https://bedrock-agentcore.us-west-2.amazonaws.com" )
Setelah (agent-registrynamespace):
import boto3 session = boto3.Session(region_name="us-west-2") cp_client = session.client( "agent-registry-control", endpoint_url="https://agent-registry-control.us-west-2.api.aws" ) dp_client = session.client( "agent-registry", endpoint_url="https://agent-registry.us-west-2.api.aws" )
Contoh: Memperbarui perintah CLI
Ganti namespace CLI di semua skrip dan otomatisasi.
Sebelum (bedrock-agentcorenamespace, tidak digunakan lagi):
aws bedrock-agentcore-control create-registry \ --name "MyRegistry" \ --description "Production registry" \ --region us-west-2 \ --endpoint-url https://bedrock-agentcore-control.us-west-2.amazonaws.com
Setelah (agent-registrynamespace):
aws agent-registry-control create-registry \ --name "MyRegistry" \ --description "Production registry" \ --region us-west-2 \ --endpoint-url https://agent-registry-control.us-west-2.api.aws
Perubahan skema API
Selain migrasi namespace, kami memperbarui model data registri dan catatan registri di agent-registry namespace. Perubahan ini meningkatkan konsistensi dan ekstensibilitas API berdasarkan umpan balik dari bedrock-agentcore namespace. Bagian ini mencakup setiap kategori perubahan dengan contoh sebelum dan sesudah sehingga Anda dapat memperbarui kode aplikasi Anda.
Ubah 1: Pembaruan entitas registri
Konfigurasi otorisasi pada sumber daya registri — yang mengontrol bagaimana bidang data registri diakses — sekarang berada di bawah pem discoveryConfiguration bungkus khusus yang membuat tujuannya eksplisit. Konfigurasi persetujuan (yang mengontrol apakah catatan yang dikirimkan ke PENDING_APPROVAL status secara otomatis bertransisi ke APPROVED status) berpindah dari larik boolean ke larik enum yang dapat diperluas.
Perubahan bidang spesifik adalah:
-
authorizerTypedanauthorizerConfigurationdipindahkan ke dalamdiscoveryConfigurationobjek baru. -
approvalConfiguration.autoApproval(boolean) diganti denganapprovalConfiguration.autoApprovalRules(array string enum). Nilai"APPROVE_ALL"memiliki makna semantik yang sama denganautoApproval: true. Aturan yang ditentukan dalam daftar enum diterapkan. Tidak menentukan (null) berarti persetujuan diperlukan.
Sebelum (bedrock-agentcorenamespace, tidak digunakan lagi):
{ "name": "string", "description": "string", "authorizerConfiguration": { ... }, "authorizerType": "string", "approvalConfiguration": { "autoApproval": true } }
Setelah (agent-registrynamespace): dengan Persetujuan SEMUA
{ "name": "string", "description": "string", "discoveryConfiguration": { "authorizerConfiguration": { ... }, "authorizerType": "string" }, "approvalConfiguration": { "autoApprovalRules": ["APPROVE_ALL"] } }
Setelah (agent-registrynamespace): dengan NULL dalam daftar enum
{ "name": "string", "description": "Registry with manual approval only", "approvalConfiguration": { "autoApprovalRules": [] } }
Ubah 2: Bidang wajib baru pada catatan registri
Catatan registri mendapatkan dua bidang tingkat atas baru yang diperlukan untuk mendukung kategorisasi dan deduplikasi yang lebih baik. Anda harus menentukan kedua bidang saat membuat catatan registri menggunakan CreateRegistryRecord API, dan Anda dapat mengubahnya nanti menggunakan UpdateRegistryRecord API.
| Bidang | Tipe | Deskripsi |
|---|---|---|
|
|
String (wajib) |
Pengidentifikasi unik dalam registri yang dapat ditentukan oleh pelanggan. Setiap catatan harus memiliki nama unik dalam registri. Ketika |
|
|
Enum (wajib) |
Jenis semantik dari catatan. Nilai yang valid: |
Perubahan 3: Restrukturisasi catatan registri
Bid descriptors ang berubah dari penyatuan yang didiskriminasi menjadi struktur kunci datar.
Pada model sebelumnya, descriptorType bidang (MCP,, A2AAGENT_SKILLS,CUSTOM) menentukan bentuk bagian dalam. Ini menggabungkan konten deskriptor ke protokol kasar atau klasifikasi format. Bidang itu sudah tidak ada lagi. recordType, atribut tingkat atas yang terpisah, menggantikannya untuk kategorisasi semantik. API memberlakukan kunci deskriptor yang valid untuk masing-masing recordType saat runtime daripada secara struktural dalam bentuk. Setiap kunci tingkat atas di bawah descriptors sekarang mewakili tipe deskriptor primer granular (misalnya,,, a2aAgentCard mcpServeragentSkillsDefinition,custom). Deskriptor tambahan (misalnya,tools,skillMd) bersarang di bawah deskriptor utama. additionalData inlineContentLapangan menjadi data Bidang schemaVersion dan protocolVersion berkonsolidasi menjadidataSchemaVersion.
A synchronizationConfiguration tribut tingkat atas menjadi source dan bergerak di dalam setiap deskriptor (termasuk additionalData anak-anak).
nameBidang yang ada menjadidisplayName, membuat maknanya lebih eksplisit. Bidang net- name new berfungsi sebagai kunci dedup dan harus unik di semua catatan dalam registri. Jika Anda menentukan keduanya name dan recordVersion untuk catatan yang sama, kombinasinya harus unik.
Bidang berikut diganti namanya:
| Sebelum | Setelah | Catatan |
|---|---|---|
|
|
|
Menampilkan nama catatan. Juga akan ada |
|
|
Dihapus |
Digantikan oleh |
|
|
|
Payload konten dalam setiap deskriptor. |
|
|
|
Bidang versi terpadu untuk semua jenis deskriptor. |
|
|
|
Pindah di dalam setiap deskriptor (termasuk |
Sebelum (bedrock-agentcorenamespace, tidak digunakan lagi):
{ "recordId": "string", "name": "string", "descriptorType": "string", // A2A, MCP, AGENT_SKILL, CUSTOM "descriptors": { "agent": { "a2aAgentCard": { "inlineContent": "string", "schemaVersion": "string" } }, "agentSkills": { "skillDefinition": { "inlineContent": "string", "schemaVersion": "string" }, "skillMd": { "inlineContent": "string" } }, "mcp": { "server": { "inlineContent": "string", "schemaVersion": "string" }, "tools": { "inlineContent": "string", "protocolVersion": "string" } }, "custom": { "inlineContent": "string" } }, "synchronizationType": "URL", "synchronizationConfiguration": { "fromUrl": { "url": "string", "credentialProviderConfigurations": [ { "credentialProvider": { ... }, "credentialProviderType": "string" } ] } }, ... }
Setelah (agent-registrynamespace):
{ "recordId": "string", "displayName": "string", "name": "string", "recordVersion": "string", "recordType": "AGENT" | "MCP" | "SKILL" | "CUSTOM", "descriptors": { "a2aAgentCard": { "data": "string", "dataSchemaVersion": "string", "source": { "fromUrl": { "url": "string", "credentialProviderConfigurations": [...] } } }, "mcpServer": { "data": "string", "dataSchemaVersion": "string", "source": { "fromUrl": { ... } }, "additionalData": { "tools": { "data": "string", "dataSchemaVersion": "string" } } }, "agentSkillsDefinition": { "data": "string", "dataSchemaVersion": "string", "additionalData": { "skillMd": { "data": "string", "dataSchemaVersion": "string", "source": { "fromUrl": { ... } } } } }, "custom"?: { "data": "string" } } ... }
Batasan berikut berlaku:
Tepat satu kunci deskriptor utama dapat diisi per catatan. Deskriptor utama yang valid recordType adalah:
-
AGEN:
a2aAgentCard,mcpServer,custom -
MCP:
mcpServer,custom -
KETERAMPILAN:
agentSkillsDefinition,custom -
KUSTOM:
custom
sourceadalah per-deskriptor daripada blok tingkat atas tunggal. Ini melekat pada deskriptor yang membawa source bidang dalam skema — mcpServer dana2aAgentCard. toolsAnak (di bawahmcpServer.additionalData), agentSkillsDefinition orang tua, dan custom deskriptor membawa nosource.
Di agent-registry namespace, hanya source.fromUrl didukung.
Auto-synchronization hanya dipicu untuk deskriptor mcpServer dan a2aAgentCard primer — yaitu, tipe catatan MCP dan AGENT. A source pada skillMd anak tetap ada tetapi tidak digunakan untuk menjalankan sinkronisasi, dan catatan SKILL tidak dapat disinkronkan secara otomatis. Catatan KUSTOM harus dibuat secara manual dengan menyediakan data secara langsung.
Ubah 4: Pembaruan filter bidang data
SearchRegistryRecordsmenjadi SearchDiscoverableRegistryRecords (POST /discoverable-records-search). Permintaan dan tanggapannya mengambil nama bidang dan model data baru:
-
Filter dengan
recordType(menggantikandescriptorType). -
Filter dengan
recordVersion(menggantikanversion). -
Respons mengembalikan deskriptor dalam format baru, tanpa
credentialProviderConfigurations.
Alat pencarian MCP search_registry_records menjadisearch_discoverable_registry_records, mengembalikan format deskriptor baru, dan menggunakan nama filter baru.
Ubah 5: API penelusuran baru
Dua API bidang data baru mendukung pembuatan pengalaman penelusuran dan katalog di atas catatan yang disetujui. API ini tidak memerlukan migrasi eksplisit apa pun; kami menyebutkannya di sini sebagai tambahan pada model API AWS Agen Registry di agent-registry namespace.
ListDiscoverableRegistryRecords— Mengembalikan daftar halaman catatan registri yang disetujui. Gunakan ini untuk membangun antarmuka penelusuran di atas konten yang dipublikasikan.
// HTTP: POST /registries/{registryId}/discoverable-records-list { "registryId": "string", // path param, required (ARN or ID) "maxResults": 1-100, // query param, optional "nextToken": "string", // query param, optional "filters": [ { "name": "recordType", "values": ["MCP"] } ] } { "registryRecords": [ { "registryArn": "string", "recordArn": "string", "recordId": "string", "name": "string", "displayName": "string", "description": "string", "recordType": "string", "recordVersion": "string", "status": "string", "createdAt": "string", "updatedAt": "string" } ], "nextToken": "string" }
BatchGetDiscoverableRegistryRecord— Mengambil detail lengkap untuk kumpulan catatan di satu atau lebih registri dalam satu panggilan.
// HTTP: POST /discoverable-records-batch { "entries": [ { "registryId": "reg-AAA", "recordIds": ["rec-111", "rec-222"] } ] } { "registryRecords": [ { "registryArn": "string", "recordArn": "string", "recordId": "string", "name": "string", "displayName": "string", "description": "string", "recordType": "string", "descriptors": { ... }, "recordVersion": "string", "status": "string", "createdAt": "string", "updatedAt": "string" } ], "errors": [ { "registryId": "string", "recordId": "string", "errorCode": "RESOURCE_NOT_FOUND" | "ACCESS_DENIED" | "INTERNAL_ERROR", "message": "string" } ] }
Respons mencakup registryRecords array dengan detail rekaman lengkap dan errors array untuk setiap catatan yang tidak dapat diambil.
Saat peluncuran, tepat satu entri (satu registri, 1-100 ID catatan) diterima. Bentuk yang dikelompokkan kompatibel ke depan dengan batching lintas registri di rilis mendatang.
Ubah 6: Daftar API mengadopsi parameter filter terstruktur
Di bedrock-agentcore namespace, List API mengekspos setiap bidang yang dapat difilter sebagai parameter kuerinya sendiri (misalnya,--status READY,--recordType MCP). Dalam agent-registry namespace, filters parameter terstruktur tunggal menggantikan parameter diskrit ini. filtersNilai adalah daftar { "name": "<dotted.path>", "values": ["<value>"] } entri di mana name terdapat jalur atribut yang dibatasi titik. Bidang baru yang dapat disaring, termasuk yang bersarang, menjadi name jalur baru daripada parameter API baru. Operasi daftar juga berubah dari GET kePOST. Parameter paginasi (maxResults,nextToken) tidak berubah.
Sebelum (bedrock-agentcorenamespace, tidak digunakan lagi):
GET /registries?status=READY&authorizerType=AWS_IAM GET /registries/{registryId}/records?name=my-agent&status=APPROVED&recordType=MCP
Setelah (agent-registrynamespace):
// ListRegistries // POST /registries-list { "filters": [ { "name": "status", "values": ["READY"] }, { "name": "discoveryConfiguration.authorizerType", "values": ["AWS_IAM"] } ], "maxResults": 100, "nextToken": "string" } // ListRegistryRecords // POST /registries/{registryId}/records-list { "filters": [ { "name": "name", "values": ["my-agent"] }, { "name": "status", "values": ["APPROVED"] }, { "name": "recordType", "values": ["MCP"] } ], "maxResults": 100, "nextToken": "string" }
Migrasi data
Anda harus memigrasikan registri dan catatan registri yang ada dari bedrock-agentcore namespace ke namespace. agent-registry Kami menyediakan alat migrasi untuk membantu migrasi. Alat ini menangani ekstraksi data yang ada, transformasi dari skema lama ke skema baru, dan memuat ke registri di namespace baru. Alat ini membuat registri baru di agent-registry namespace dalam akun dan wilayah yang sama. Ini memigrasikan semua catatan yang ada dari registri lama Anda ke yang baru, memperhitungkan perubahan skema namespace dan API.
Alat migrasi tersedia di repositori sampel agentcore di
Memilih pendekatan migrasi
Pendekatan yang tepat tergantung pada apakah migrasi penuh satu kali sudah cukup atau apakah Anda memerlukan eksekusi tanpa pengawasan dan kemampuan untuk menjalankan beban tambahan pada cutover.
Kasus 1: Migrasi sederhana
-
Profil: Migrasi penuh satu kali sudah cukup. Anda tidak perlu menjalankan beban tambahan atau membiarkan pekerjaan berjalan tanpa pengawasan.
-
Pendekatan: Jalankan alat migrasi langsung dari terminal Anda atau AWS CloudShell. Tidak ada infrastruktur untuk digunakan. Alat ini terhubung ke
bedrock-agentcorenamespace, mengekstrak registri dan catatan Anda, mengubah data keagent-registryskema, dan membuatnya di namespace baru. Ini adalah jalur paling sederhana dan tidak memerlukan penyebaran infrastruktur.
Kasus 2: Migrasi terkelola dengan AWS Lem
-
Profil: Anda lebih suka eksekusi tanpa pengawasan, atau Anda berencana untuk menjalankan kedua versi registri secara paralel selama periode tertentu dan memerlukan beban tambahan pada cutover untuk menangkap catatan apa pun yang dibuat atau diperbarui di
bedrock-agentcorenamespace setelah proses penuh awal. -
Pendekatan: Terapkan migrasi sebagai pekerjaan AWS Glue menggunakan tumpukan CDK yang disediakan. Pekerjaan berjalan di akun Anda tanpa bergantung pada sesi terminal terbuka.
Alur tipikal adalah: jalankan migrasi penuh untuk memperbarui
agent-registrynamespace, lalu operasikan kedua ruang nama secara paralel saat Anda memvalidasi dan memperbarui integrasi Anda. Saat Anda siap untuk memotong, jalankan beban tambahan untuk menyinkronkan catatan apa pun yang berubah selama periode paralel, memverifikasi, dan mengalihkan lalu lintas keagent-registrynamespace.
Kasus 3: Active-active migrasi
-
Profil: Anda telah membangun platform atau pipeline otomatisasi di atas API
bedrock-agentcorenamespace dan terus menulis catatan baru dalam produksi. -
Pendekatan: Mulailah dengan migrasi penuh menggunakan AWS Glue-based pendekatan terkelola untuk membawa semua data historis ke dalam
agent-registrynamespace. Kemudian arahkan platform atau pipeline Anda keagent-registrynamespace selainbedrock-agentcorenamespace — aplikasi Anda menulis ke keduanya secara bersamaan. Gunakan periode aktif-aktif ini untuk memvalidasi integrasi Anda dan membangun kepercayaan pada namespace.agent-registrySetelah Anda puas, potong semua pembacaan dan penulisan keagent-registrydan nonaktifkan integrasibedrock-agentcorenamespace.
Memverifikasi migrasi Anda
Setelah menjalankan migrasi, konfirmasikan bahwa data Anda telah dimigrasi dengan benar:
-
Daftar semua registri di namespace baru menggunakan perintah
list-registriesCLI dan konfirmasikan jumlah cocok dengan sumber Anda. -
Untuk setiap registri, bandingkan jumlah catatan menggunakan
list-registry-records. -
Spot-check catatan individu untuk mengkonfirmasi bahwa deskriptor diubah dengan benar (penggantian nama bidang, restrukturisasi deskriptor).
-
Perbarui kebijakan IAM, titik akhir, dan klien SDK seperti yang dijelaskan di bagian Namespace dan perubahan konfigurasi.
-
Pastikan aplikasi Anda berhasil membaca dan menulis menggunakan namespace baru.
Perbarui kebijakan kepercayaan IAM untuk catatan yang disinkronkan
Jika salah satu catatan registri Anda menggunakan Sinkronisasi dengan jenis kredensia peran IAM, Anda harus memperbarui kebijakan kepercayaan peran sebelum menjalankan pemuatan langsung. Prinsip layanan yang mengasumsikan peran diubah dari bedrock-agentcore.amazonaws.com ke agent-registry.amazonaws.com dalam namespace baru. Catatan yang menggunakan kredentif OAuth atau tanpa otorisasi tidak terpengaruh.
catatan
Alat migrasi tidak dapat mendeteksi ini — alat tidak pernah mengambil peran sinkronisasi. Layanan registri mengasumsikannya secara asinkron setelah catatan dibuat. Jika Anda melewatkan langkah ini, rekaman yang dimigrasi tiba di agent-registry namespace menunjuk pada peran yang sama, dan sinkronisasi gagal sampai peran mempercayai prinsipal baru.
Perbarui kebijakan kepercayaan pada peran yang direferensikan oleh setiap catatan yang terpengaruh.
Sebelum (bedrock-agentcorenamespace, tidak digunakan lagi):
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "bedrock-agentcore.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
Setelah (agent-registrynamespace):
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "agent-registry.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
Jika catatan telah gagal karena alasan ini, catatan yang dimigrasi ada dalam CREATE_FAILED status. Alat migrasi menolak untuk mengganti catatan dalam status kegagalan, jadi memperbaiki kebijakan kepercayaan saja tidak menyelesaikannya. Untuk memulihkan:
-
Perbarui kebijakan kepercayaan pada peran yang terpengaruh.
-
Hapus
CREATE_FAILEDcatatan dariagent-registrynamespace. -
Re-run beban.
Pertanyaan yang Sering Diajukan
Apa yang berubah di AWS Pendaftaran Agen?
AWS Agen Registry bergerak dari bedrock-agentcore namespace ke agent-registry namespace khusus baru. Migrasi mencakup tiga area: perubahan namespace dan konfigurasi (titik akhir, IAM, SDK, CLI, ARN, observabilitas), perubahan skema API (model data yang direstrukturisasi untuk registri dan catatan), dan migrasi data (memindahkan registri dan catatan yang ada ke namespace baru).
Bisakah saya terus menggunakan Registry di namespace bedrock-agentcore?
Penggunaan Registry yang ada di bedrock-agentcore namespace terus bekerja tanpa gangguan selama jendela migrasi. Namun, kami menyarankan Anda memulai migrasi segera setelah alat tersedia untuk memastikan Anda memiliki cukup waktu untuk menyelesaikan migrasi data dan pembaruan kode.
Namun, jika Anda tidak memiliki registri atau catatan yang ada pada 6 Agustus 2026, Anda tidak dapat mengakses bedrock-agentcore namespace untuk AWS Agen Registry mulai 6 Agustus 2026. Jika Anda memiliki registri atau catatan yang ada pada 6 Agustus 2026, Anda memiliki akses ke bedrock-agentcore namespace untuk AWS Agen Registry selama jendela migrasi (6 Agustus 2026 — 17 September 2026).
Apakah data saya akan dimigrasi secara otomatis?
Tidak. Anda harus memulai migrasi sendiri menggunakan alat migrasi yang kami sediakan. Lihat bagian Migrasi data untuk detail tentang pendekatan yang tersedia berdasarkan skala Anda.
Perubahan skema API apa yang disertakan?
Selain perubahan namespace, kami memperbarui model data API di enam area: entitas registri (konfigurasi otorisasi dikelompokkan di bawahdiscoveryConfiguration), rekaman registri bidang baru (namedanrecordType), restrukturisasi catatan registri (deskriptor diratakan, mengganti nama bidang), pembaruan filter API pencarian (recordType,recordVersion), API penelusuran baru (ListDiscoverableRegistryRecords,BatchGetDiscoverableRegistryRecord), dan filter terstruktur untuk operasi Daftar.
Berapa lama migrasi data akan berlangsung?
Waktu migrasi tergantung pada jumlah registri dan catatan di akun Anda. Untuk akun dengan kurang dari 100 catatan, migrasi selesai dalam hitungan menit saat dijalankan secara lokal. Untuk akun dengan ribuan catatan, perkirakan migrasi selesai dalam waktu kurang dari 15 menit saat dijalankan sebagai pekerjaan terkelola.
Bagaimana jika saya memiliki penerapan skala besar dengan penulisan aktif?
Jika Anda secara aktif menulis data ke bedrock-agentcore namespace dalam produksi, gunakan pendekatan migrasi aktif-aktif seperti yang dijelaskan dalam Kasus 3. Mulailah dengan migrasi penuh untuk memperbarui agent-registry namespace, lalu tulis ke kedua ruang nama secara bersamaan untuk memvalidasi integrasi Anda dan membangun kepercayaan pada namespace baru. Potong bacaan dan tulis agent-registry ketika Anda siap.
Di mana saya bisa mendapatkan bantuan?
Untuk pertanyaan atau bantuan terkait migrasi Anda, hubungi AWS Dukungan