# Panduan migrasi registri yang komprehensif
* AWS Registri Agen - Migrasi dari Pratinjau Publik ke Ketersediaan Umum*
## Pengantar
Sebagai bagian dari peluncuran sebagai Generally Available (GA) pada 6 Agustus 2026, AWS Agent Registry memperkenalkan perubahan signifikan pada prinsipal layanan, data, dan model API. Jika Anda menggunakan Registri AWS Agen selama pratinjau publik, Anda harus menyelesaikan migrasi yang mencakup tiga area:
1. **Namespace dan perubahan konfigurasi** - Kami memindahkan AWS Agent Registry dari namespace AWS Bedrock ke AgentCore namespace khusus miliknya sendiri. Perubahan namespace ini hanya berlaku untuk AWS Agent Registry. Semua AgentCore penawaran lainnya—seperti Identity, Gateway, Runtime, dan Policy—tetap tidak terpengaruh. Untuk AWS Agent Registry, namespace layanan berubah dari ke`bedrock-agentcore`. `agent-registry` Ini memengaruhi setiap permukaan yang mereferensikan layanan: titik akhir, kebijakan IAM, klien SDK, perintah CLI, ARN sumber daya, dan integrasi observabilitas. Anda harus memperbarui kode dan infrastruktur Anda untuk menggunakan namespace baru.
1. **Perubahan skema API** - Model data catatan registri dan registri diperbarui berdasarkan umpan balik pelanggan selama pratinjau publik. Perubahan ini merusak kompatibilitas mundur dengan skema API yang ada. Kode aplikasi Anda yang membuat atau mem-parsing permintaan dan respons API harus diperbarui untuk mencerminkan skema baru, sebagai bagian dari migrasi ke namespace baru.
1. **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 menjadi 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 itu timeline migrasi?
Ada dua tonggak penting yang harus Anda ingat untuk migrasi ini:
+ **6 Agustus 2026** — Registri AWS Agen menjadi Tersedia Secara Umum, dan `agent-registry` namespace baru secara resmi diluncurkan. Jika Anda memiliki registri dan catatan yang ada, Anda memiliki akses simultan ke dan ruang nama. `bedrock-agentcore` `agent-registry` Perkakas migrasi tersedia di repositori [agen-sampel GitHub ](https://github.com/awslabs/agentcore-samples). Anda dapat memulai proses migrasi.
**catatan**
Jika Anda adalah pelanggan baru tanpa registri atau catatan yang ada per 6 Agustus 2026, Anda tidak dapat mengakses AWS Agen Registri melalui namespace. `bedrock-agentcore` Mulai gunakan AWS Agent Registry langsung dari `agent-registry` namespace.
+ **17 September 2026** — Jendela migrasi ditutup. `bedrock-agentcore`Namespace lama dimatikan pada tanggal ini. Anda kehilangan read/write akses ke layanan dan data yang tersisa di namespace lama. Setelah tanggal ini, Anda harus menggunakan `agent-registry` namespace.
## Perubahan namespace dan konfigurasi
`agent-registry`Namespace 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 Agent Registry, tetapi tidak pada AWS Bedrock lainnya AgentCore, seperti Identity. AWS AgentCore Dengan demikian, identitas beban kerja dan sumber daya penyedia kredensi OAuth tetap berada di bawah namespace. `bedrock-agentcore`
### Titik akhir layanan
Aplikasi Anda harus menunjuk ke nama host endpoint baru. Endpoint baru menggunakan `.api.aws` domain.
| Permukaan | Nilai lama | Nilai baru |
| --- | --- | --- |
| Titik akhir bidang data | `bedrock-agentcore.{region}.amazonaws.com` | `agent-registry.{region}.api.aws` |
| Kontrol titik akhir pesawat | `bedrock-agentcore-control.{region}.amazonaws.com` | `agent-registry-control.{region}.api.aws` |
### 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 | `bedrock-agentcore:*` | `agent-registry:*` |
| Pemimpin layanan | `bedrock-agentcore.amazonaws.com` | `agent-registry.amazonaws.com` |
| Registri ARN | `arn:aws:bedrock-agentcore:{region}:{account}:registry/{id}` | `arn:aws:agent-registry:{region}:{account}:registry/{id}` |
| Rekam ARN | `arn:aws:bedrock-agentcore:{region}:{account}:registry/{id}/record/{rid}` | `arn:aws:agent-registry:{region}:{account}:registry/{id}/record/{rid}` |
Jika Anda memiliki otomatisasi yang mem-parsing ARN atau menyimpannya, perbarui referensi tersebut juga. Kebijakan khusus dengan ketentuan pada awalan tindakan IAM atau prinsip layanan harus diperbarui agar sesuai dengan nilai baru. Untuk melihat daftar lengkap izin IAM yang terkait dengan AWS Agent Registry, lihat referensi izin [IAM AWS Agent Registry](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-iam-permissions.html).
**catatan**
Jika saat ini Anda menggunakan Kebijakan [BedrockAgentCoreFullAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/BedrockAgentCoreFullAccess.html) AWS Terkelola untuk akses Registri AWS Agen (lihat [detail BedrockAgentCoreFullAccess kebijakan](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/security-iam-awsmanpol.html#security-iam-awsmanpol-BedrockAgentCoreFullAccess)), Anda harus menggantinya dengan kebijakan **AgentRegistryFullAccess**terkelola baru (tersedia di GA). Kebijakan BedrockAgentCoreFullAccess terkelola 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 SDK Dataplane | `BedrockAgentCoreClient` | `AgentRegistryClient` |
| Kelas klien Controlplane SDK | `BedrockAgentCoreControlClient` | `AgentRegistryControlClient` |
| Ruang nama CLI | `aws bedrock-agentcore` | `aws agent-registry` |
| Kode Service Quotas | `bedrock-agentcore` | `agent-registry` |
Jika sebelumnya Anda meminta peningkatan kuota kustom di bawah kode `bedrock-agentcore` layanan, Anda harus memintanya kembali di bawah. `agent-registry`
### Observabilitas dan eventing
Perbarui kueri CloudTrail Lake, kueri Athena, integrasi SIEM, aturan, dasbor CloudWatch , dan alarm yang EventBridge mereferensikan namespace lama.
| Permukaan | Nilai lama | Nilai baru |
| --- | --- | --- |
| CloudTrail sumber acara | `bedrock-agentcore.amazonaws.com` | `agent-registry.amazonaws.com` |
| EventBridge sumber | `aws.bedrock-agentcore` | `aws.agent-registry` |
| CloudWatch namespace | `AWS/BedrockAgentCore` | `AWS/AgentRegistry` |
### Contoh: Memperbarui kebijakan IAM
Ganti awalan tindakan dan resource ARN namespace di semua kebijakan IAM Anda.
**Sebelum (pratinjau publik):**
```
{
"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 (Ketersediaan Umum):**
```
{
"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**
`BatchGetDiscoverableRegistryRecord`API tidak memiliki tindakan IAM sendiri. Ini mengotorisasi setiap catatan yang diminta terhadap `agent-registry:GetDiscoverableRegistryRecord` tindakan tersebut. Pastikan kebijakan Anda termasuk `GetDiscoverableRegistryRecord` untuk digunakan`BatchGet`.
**penting**
Identitas beban kerja dan sumber daya penyedia kredensi OAuth tetap berada di bawah namespace. `bedrock-agentcore` Jika pendaftar Anda menggunakan sinkronisasi URL (`source.fromUrl`) dengan kredensi 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 dengan sengaja mempertahankan namespace lama.
### Contoh: Memperbarui konfigurasi klien SDK
Perbarui nama layanan, kelas klien, dan URL titik akhir dalam panggilan SDK Anda.
**Sebelum (pratinjau publik):**
```
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 (Ketersediaan Umum):**
```
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 (pratinjau publik):**
```
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 (Ketersediaan Umum):**
```
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 catatan registri dan registri untuk Ketersediaan Umum. Perubahan ini meningkatkan konsistensi dan ekstensibilitas API berdasarkan umpan balik dari pratinjau publik. Bagian ini mencakup setiap kategori perubahan dengan contoh sebelum dan sesudah sehingga Anda dapat memperbarui kode aplikasi Anda.
### Perubahan 1: Pembaruan entitas registri
Konfigurasi otorisasi pada sumber daya registri — yang mengontrol bagaimana bidang data registri diakses — sekarang berada di bawah `discoveryConfiguration` pembungkus 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 boolean ke larik enum yang dapat diperluas.
Perubahan bidang spesifik adalah:
+ `authorizerType`dan `authorizerConfiguration` dipindahkan ke dalam `discoveryConfiguration` objek baru.
+ `approvalConfiguration.autoApproval`(boolean) diganti dengan `approvalConfiguration.autoApprovalRules` (array string enum). Nilai `"APPROVE_ALL"` memiliki arti semantik yang sama dengan. `autoApproval: true` Aturan yang ditentukan dalam daftar enum diterapkan. Tidak menentukan (null) berarti persetujuan diperlukan.
**Sebelum (pratinjau publik):**
```
{
"name": "string",
"description": "string",
"authorizerConfiguration": { ... },
"authorizerType": "string",
"approvalConfiguration": {
"autoApproval": true
}
}
```
**Setelah (Ketersediaan Umum): dengan Persetujuan SEMUA**
```
{
"name": "string",
"description": "string",
"discoveryConfiguration": {
"authorizerConfiguration": { ... },
"authorizerType": "string"
},
"approvalConfiguration": {
"autoApprovalRules": ["APPROVE_ALL"]
}
}
```
**Setelah (Ketersediaan Umum): dengan NULL dalam daftar enum**
```
{
"name": "string",
"description": "Registry with manual approval only",
"approvalConfiguration": {
"autoApprovalRules": []
}
}
```
### Ubah 2: Bidang baru yang diperlukan 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 |
| --- | --- | --- |
| `name` | String (wajib) | Pengidentifikasi unik dalam registri yang dapat ditentukan oleh pelanggan. Setiap catatan harus memiliki nama unik dalam registri. Ketika `recordVersion` juga hadir, kombinasi `name` dan `recordVersion` harus unik. |
| `recordType` | Enum (wajib) | Jenis semantik dari catatan. Nilai yang valid:`AGENT`,`MCP`,`SKILL`,`CUSTOM`. Menentukan kunci deskriptor utama mana yang valid di bawah`descriptors`. Anda dapat menggunakan API seperti `ListRegistryRecords` dan `SearchDiscoverableRegistryRecords` untuk memfilter hasil berdasarkan jenis semantik ini. |
### Perubahan 3: Restrukturisasi catatan registri
`descriptors`Bidang berubah dari persatuan yang didiskriminasi menjadi struktur kunci datar.
Pada model sebelumnya, `descriptorType` bidang (`MCP`,, `A2A``AGENT_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``mcpServer`,`agentSkillsDefinition`). `custom` Deskriptor tambahan (misalnya,`tools`,`skillMd`) bersarang di bawah deskriptor utama. `additionalData` `inlineContent`Bidang menjadi`data`. `protocolVersion`Bidang `schemaVersion` dan dikonsolidasikan menjadi`dataSchemaVersion`.
`synchronizationConfiguration`Atribut tingkat atas menjadi `source` dan bergerak di dalam setiap deskriptor (termasuk `additionalData` anak-anak).
`name`Bidang yang ada menjadi`displayName`, membuat maknanya lebih eksplisit. `name`Bidang net-new berfungsi sebagai kunci dedup dan harus unik di semua catatan dalam registri. Jika Anda menentukan keduanya `name` dan `recordVersion` untuk catatan yang sama, kombinasi mereka harus unik.
Bidang berikut diganti namanya:
| Sebelum | Setelah | Catatan |
| --- | --- | --- |
| `name` | `displayName` | Tampilkan nama catatan. Juga akan ada `name` bidang baru yang merupakan kunci dedup. |
| `descriptorType` | Dihapus | Digantikan oleh `recordType` bidang tingkat atas. |
| `inlineContent` | `data` | Muatan konten dalam setiap deskriptor. |
| `schemaVersion` / `protocolVersion` | `dataSchemaVersion` | Bidang versi terpadu untuk semua jenis deskriptor. |
| `synchronizationConfiguration` | `source` | Pindah ke dalam setiap deskriptor (termasuk `additionalData` anak-anak). |
**Sebelum (pratinjau publik):**
```
{
"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 (Ketersediaan Umum):**
```
{
"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"
}
},
"metadata": Document
...
}
```
Batasan berikut berlaku:
Tepat satu kunci deskriptor utama dapat diisi per catatan. Deskriptor primer yang valid per `recordType` adalah:
+ **AGEN:**`a2aAgentCard`,`mcpServer`, `custom`
+ **MCP:**`mcpServer`, `custom`
+ **KETERAMPILAN:**`agentSkillsDefinition`, `custom`
+ **KUSTOM:** `custom`
`source`adalah per-deskriptor daripada satu blok tingkat atas. Ini melekat pada deskriptor yang membawa `source` bidang dalam skema — dan. `mcpServer` `a2aAgentCard` `tools`Anak (di bawah`mcpServer.additionalData`), `agentSkillsDefinition` orang tua, dan `custom` deskriptor membawa no`source`.
Di GA, hanya `source.fromUrl` didukung.
Auto-synchronization hanya dipicu untuk deskriptor `mcpServer` dan `a2aAgentCard` primer — yaitu, jenis catatan MCP dan AGENT. A `source` pada `skillMd` anak dipertahankan 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
`SearchRegistryRecords`menjadi `SearchDiscoverableRegistryRecords` (`POST /discoverable-records-search`). Permintaan dan tanggapannya mengambil nama bidang dan model data baru:
+ Filter dengan `recordType` (menggantikan`descriptorType`).
+ Filter dengan `recordVersion` (menggantikan`version`).
+ Respons mengembalikan deskriptor dalam format baru, tanpa`credentialProviderConfigurations`.
Alat pencarian MCP `search_registry_records` menjadi`search_discoverable_registry_records`, mengembalikan format deskriptor baru, dan menggunakan nama filter baru.
### Ubah 5: API penjelajahan baru
Dua API bidang data baru mendukung penjelajahan bangunan dan pengalaman katalog atas catatan yang disetujui. API ini tidak memerlukan migrasi eksplisit apa pun; kami menyebutkannya di sini sebagai tambahan pada model AWS Agent Registry API di GA.
**ListDiscoverableRegistryRecords**— Mengembalikan daftar paginasi 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 sekumpulan catatan di satu atau lebih pendaftar 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 termasuk `registryRecords` array dengan rincian catatan lengkap dan `errors` array untuk setiap catatan yang tidak dapat diambil.
Saat peluncuran, tepat satu entri (satu registri, 1-100 ID rekaman) diterima. Bentuk yang dikelompokkan kompatibel ke depan dengan batching lintas registri di rilis mendatang.
### Perubahan 6: API Daftar mengadopsi parameter filter terstruktur
Dalam pratinjau publik, API Daftar mengekspos setiap bidang yang dapat difilter sebagai parameter kueri sendiri (misalnya,,`--status READY`). `--recordType MCP` Di GA, satu `filters` parameter terstruktur menggantikan parameter diskrit ini. `filters`Nilai adalah daftar `{ "name": "", "values": [""] }` entri di mana `name` adalah jalur atribut dot-delimited. Bidang baru yang dapat difilter, termasuk yang bersarang, menjadi `name` jalur baru daripada parameter API baru. Operasi daftar juga berubah dari `GET` ke`POST`. Parameter pagination (`maxResults`,`nextToken`) tidak berubah.
**Sebelum (pratinjau publik):**
```
GET /registries?status=READY&authorizerType=AWS_IAM
GET /registries/{registryId}/records?name=my-agent&status=APPROVED&recordType=MCP
```
**Setelah (Ketersediaan Umum):**
```
// 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 namespace ke `bedrock-agentcore` namespace. `agent-registry` Kami menyediakan skrip untuk membantu migrasi. Skrip menangani ekstraksi data yang ada, transformasi dari skema lama ke skema baru, dan pemuatan ke registri di namespace baru. Skrip 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 namespace dan perubahan skema API.
### Memilih pendekatan migrasi Anda
Pendekatan yang tepat tergantung pada skala penggunaan registri Anda dan lingkungan operasional Anda.
#### Kasus 1: Small-scale migrasi dengan eksekusi skrip langsung
+ **Profil:** Kurang dari 5 pendaftar dan kurang dari 100 catatan. Anda memiliki akses langsung ke terminal atau CloudShell di akun target.
+ **Pendekatan:** Jalankan skrip Python migrasi secara langsung. Skrip terhubung ke namespace pratinjau, mencantumkan registri dan catatan Anda, mengubah data ke skema GA, dan membuatnya di namespace baru. Ini adalah jalur paling sederhana dan tidak memerlukan penyebaran infrastruktur.
#### Kasus 2: Migrasi terkelola dengan Lambda atau Glue
+ **Profil:** Anda tidak memiliki akses terminal langsung ke lingkungan target, atau Anda lebih memilih model eksekusi terkelola.
+ **Pendekatan:** Terapkan migrasi sebagai fungsi AWS Lambda atau pekerjaan AWS Glue. Mesin migrasi melakukan alur kerja extract-transform-load yang sama tetapi berjalan sebagai pekerjaan terkelola dalam akun Anda. Untuk sebagian besar akun, migrasi penuh selesai dalam waktu kurang dari 15 menit.
Mesin migrasi:
+ **Mengekstrak** registri dan catatan dari namespace pratinjau, mendukung beban penuh dan tambahan. Ini melakukan paginasi melalui semua respons API dan membuat serial data ke lokasi pementasan.
+ **Mengubah** setiap catatan dengan menerapkan perubahan skema API (penggantian nama bidang, restrukturisasi deskriptor, bidang wajib baru).
+ **Memuat** data yang diubah ke dalam `agent-registry` namespace baru, membuat registri dan catatan menggunakan GA API.
+ **Menghasilkan laporan yang** merangkum apa yang dimigrasi, kesalahan apa pun yang ditemui, dan jumlah catatan untuk verifikasi.
#### Kasus 3: Dual-write migrasi untuk beban kerja produksi aktif
+ **Profil:** Anda telah membangun platform atau pipeline otomatisasi di atas API pratinjau publik dan secara aktif menulis data baru dalam produksi.
+ **Pendekatan:** Gunakan strategi migrasi penulisan ganda untuk menghindari kehilangan data selama transisi:
+ **Perbarui penulis Anda** - Ubah aplikasi Anda untuk menulis ke namespace pratinjau dan namespace baru secara bersamaan`agent-registry`.
+ **Jalankan skrip migrasi dengan deduplikasi** — Jalankan alat migrasi untuk memigrasi data historis. Skrip melakukan deduplikasi berdasarkan `name` bidang, jadi catatan yang sudah ada di namespace baru (dari penulisan ganda Anda) tidak diduplikasi.
+ **Ganti pembaca Anda** — Setelah Anda memverifikasi bahwa semua data ada di namespace baru, perbarui aplikasi Anda untuk membaca secara eksklusif. `agent-registry`
+ **Hapus penulisan ganda** — Setelah mengonfirmasi semua pembacaan dan penulisan berhasil di namespace baru, hapus penulis namespace pratinjau dari aplikasi Anda.
### Memverifikasi migrasi Anda
Setelah menjalankan migrasi, konfirmasikan bahwa data Anda telah dimigrasi dengan benar:
+ Buat daftar semua registri di namespace baru menggunakan perintah `list-registries` CLI dan konfirmasikan hitungannya cocok dengan sumber Anda.
+ Untuk setiap registri, bandingkan jumlah catatan menggunakan`list-registry-records`.
+ Spot-check catatan individu untuk mengonfirmasi 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.
+ Verifikasi bahwa aplikasi Anda berhasil membaca dan menulis menggunakan namespace baru.
## Pertanyaan yang Sering Diajukan
### Apa yang berubah AWS Agen Registry?
AWS Agent Registry bergerak dari namespace pratinjau publik ke `bedrock-agentcore` namespace yang tersedia `agent-registry` secara umum. Migrasi mencakup tiga area: namespace dan perubahan konfigurasi (titik akhir, IAM, SDK, CLI, ARN, observabilitas), perubahan skema API (model data yang direstrukturisasi untuk pendaftar dan catatan), dan migrasi data (memindahkan registri dan catatan Anda yang ada ke namespace baru).
### Bisakah saya terus menggunakan Registry di namespace `bedrock-agentcore`?
Penggunaan Registri Anda 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 per 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 per 6 Agustus 2026, Anda memiliki akses ke `bedrock-agentcore` namespace untuk Registri AWS Agen selama jendela migrasi (6 Agustus 2026 — 17 September 2026).
### Apakah data saya akan dimigrasikan 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 bawah`discoveryConfiguration`), registri merekam bidang baru (`name`dan), restrukturisasi catatan registri (deskriptor diratakan, penggantian nama bidang`recordType`), pembaruan filter API pencarian (,), API penelusuran baru (,`recordVersion`)`recordType`, dan filter terstruktur untuk operasi Daftar. `ListDiscoverableRegistryRecords` `BatchGetDiscoverableRegistryRecord`
### Berapa lama waktu yang dibutuhkan migrasi data?
Waktu migrasi tergantung pada jumlah pendaftar dan catatan di akun Anda. Untuk akun dengan catatan kurang dari 100, 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 namespace pratinjau dalam produksi, gunakan strategi migrasi penulisan ganda seperti yang dijelaskan dalam Kasus 3. Pendekatan ini memastikan tidak ada data yang hilang selama transisi dengan menulis ke kedua ruang nama secara bersamaan, memigrasikan data historis dengan deduplikasi, dan kemudian memotong pembacaan.
### Di mana saya bisa mendapatkan bantuan?
Untuk pertanyaan atau bantuan terkait migrasi Anda, hubungi [AWS Support](https://aws.amazon.com/support).