View a markdown version of this page

Sincronizzazione dei record da fonti esterne - Fondamento Amazon AgentCore
Panoramica diEffettua la sincronizzazione da un server MCP pubblicoSincronizzazione da un server MCP OAuth-protectedSincronizzazione da un server MCP IAM-protectedEffettua la sincronizzazione da una scheda agente A2AAttiva la sincronizzazione su un record esistente

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Sincronizzazione dei record da fonti esterne

La migrazione è ora aperta

AWS Agent Registry è stato lanciato con il nuovo agent-registry namespace. Il supporto per il bedrock-agentcore namespace di anteprima pubblico verrà interrotto il 17 settembre 2026. Per le istruzioni sulla migrazione, consulta la Guida completa alla migrazione del registro.

Panoramica di

AWS Agent Registry può sincronizzare automaticamente i metadati dei record da fonti esterne connettendosi all'URL fornito con credenziali in uscita. Quando si fornisce un provider di URL e credenziali (opzionale per le risorse pubbliche che non richiedono alcuna autorizzazione di accesso), il sistema estrae le definizioni di server e strumenti e popola i descrittori del record in conformità agli schemi di protocollo ufficiali. Inoltre, aggiorna il nome, la descrizione e la versione del record se tali valori vengono trovati all'origine.

Effettua la sincronizzazione da un server MCP pubblico

Per i server MCP pubblici che non richiedono autenticazione o autorizzazione:

Console

Esempio
AWS Agent Registry namespace

  1. Aprire la pagina dei dettagli del registro nella console AWS Agent Registry.

  2. Nella sezione Record di registro, scegli Crea record.

  3. Scegli Sincronizza dall'endpoint.

  4. In Dettagli del record, per Tipo, scegli MCP. Il descrittore è impostato sul server MCP.

  5. Per Endpoint, inserisci l'URL del server MCP pubblico (ad es.). https://knowledge-mcp.global.api.aws Deve essere un URL HTTPS valido.

  6. In Tipo di credenziale, scegli Nessuna.

  7. (Facoltativo) Nella sezione Tag, scegli Aggiungi nuovo tag per allegare uno o più tag al record. Ogni tag ha una chiave e un valore opzionale.

  8. Scegli Crea record.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Apri la pagina dei dettagli del registro nella Bedrock-AgentCore console.

  2. Nella sezione Record di registro, scegli Crea record.

  3. Scegli Sincronizza dall'endpoint.

  4. In Dettagli del record, scegli MCP come tipo di record.

  5. Per Endpoint, inserisci l'URL del server MCP pubblico (ad es.). https://knowledge-mcp.global.api.aws Deve essere un URL HTTPS valido.

  6. In Tipo di credenziale, scegli Nessuna.

  7. Scegli Crea record.

Il record viene creato nello stato CREATING. Il registro si connette all'endpoint, estrae le definizioni del server e dello strumento e compila i descrittori del record. Al termine della sincronizzazione, il record passa a DRAFT. Se la sincronizzazione non riesce, il record passa allo stato CREATE_FAILED con i dettagli dell'errore disponibili nel campo Status Reason. Per la risoluzione dei problemi, consulta Errori di sincronizzazione dei record. Registra gli errori di sincronizzazione

AWS CLI

Esempio
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "aws-knowledge-server" \
  --display-name "AWS Knowledge Server" \
  --record-type MCP \
  --descriptors '{
    "mcpServer": {
      "source": {
        "fromUrl": {
          "url": "https://knowledge-mcp.global.api.aws"
        }
      }
    }
  }' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "aws-knowledge-server" \
  --descriptor-type MCP \
  --synchronization-type URL \
  --synchronization-configuration '{
    "fromUrl":
    {
        "url": "https://knowledge-mcp.global.api.aws"
    }
  }' \
  --region us-east-1

AWS SDK

Esempio
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.create_registry_record(
    registryId='<registryId>',
    name='aws-knowledge-server',
    displayName='AWS Knowledge Server',
    recordType='MCP',
    descriptors={
        'mcpServer': {
            'source': {
                'fromUrl': {
                    'url': 'https://knowledge-mcp.global.api.aws'
                }
            }
        }
    }
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.create_registry_record(
    registryId='<registryId>',
    name='aws-knowledge-server',
    descriptorType='MCP',
    synchronizationType='URL',
    synchronizationConfiguration={
        'fromUrl': {
            'url': 'https://knowledge-mcp.global.api.aws'
        }
    }
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING
Nota

Nel agent-registry namespace, la configurazione di sincronizzazione viene spostata all'interno di ogni descrittore come source (supportata solo nei descrittori attivi e primari). mcpServer a2aAgentCard I campi/di primo livello synchronizationType non esistono più. synchronizationConfiguration

Il record viene creato nello stato CREATING. Il tempo di sincronizzazione varia da secondi a minuti, a seconda della dimensione dei metadati. Una volta completata la sincronizzazione, passa a DRAFT con i descrittori estratti dal server MCP, incluse le definizioni di server e strumenti.

Sincronizzazione da un server MCP OAuth-protected

Quando il server MCP è protetto da OAuth, è necessario creare un client M2M sul server di autorizzazione e quindi configurare un provider di credenziali di AgentCore Identity contenente l'ID client e il segreto consentito per richiamare il server MCP. Una volta ottenuto il provider di credenziali, è possibile fornirlo al registro per la sincronizzazione:

Console

Esempio
AWS Agent Registry namespace

  1. Aprire la pagina dei dettagli del registro nella console AWS Agent Registry.

  2. Nella sezione Record di registro, scegli Crea record.

  3. Scegli Sincronizza dall'endpoint.

  4. In Dettagli del record, per Tipo, scegli MCP. Il descrittore è impostato sul server MCP.

  5. Per Endpoint, immettere l'URL del OAuth-protected server MCP. Deve essere un URL HTTPS valido.

  6. In Tipo di credenziale, scegli OAuth.

  7. Per Provider di credenziali, seleziona o inserisci l'ARN del provider di credenziali da Identity. AgentCore

  8. (Facoltativo) Espandi la configurazione aggiuntiva per configurare:

    1. Ambiti: ambiti OAuth da richiedere quando si ottiene un token di accesso.

    2. Parametri personalizzati: parametri chiave-valore aggiuntivi per la richiesta del token OAuth.

  9. (Facoltativo) Nella sezione Tag, scegli Aggiungi nuovo tag per allegare uno o più tag al record. Ogni tag ha una chiave e un valore opzionale.

  10. Scegli Crea record.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Apri la pagina dei dettagli del registro nella Bedrock-AgentCore console.

  2. Nella sezione Record di registro, scegli Crea record.

  3. Scegli Sincronizza dall'endpoint.

  4. In Dettagli del record, scegli MCP come tipo di record.

  5. Per Endpoint, inserisci l'URL del server OAuth-protected MCP. Deve essere un URL HTTPS valido.

  6. In Tipo di credenziale, scegli OAuth.

  7. Per Provider di credenziali, seleziona o inserisci l'ARN del provider di credenziali da Identity. AgentCore

  8. (Facoltativo) Espandi la configurazione aggiuntiva per configurare:

    1. Ambiti: ambiti OAuth da richiedere quando si ottiene un token di accesso.

    2. Parametri personalizzati: parametri chiave-valore aggiuntivi per la richiesta del token OAuth.

  9. Scegli Crea record.

Il record viene creato nello stato CREATING. Il registro si connette all'endpoint utilizzando le credenziali OAuth, estrae le definizioni del server e dello strumento e compila i descrittori del record. Al termine della sincronizzazione, il record passa a DRAFT. Se la sincronizzazione non riesce, il record passa allo stato CREATE_FAILED con i dettagli dell'errore disponibili nel campo Status Reason. Per la risoluzione dei problemi, consulta Errori di sincronizzazione dei record. Registra gli errori di sincronizzazione

AWS CLI

Esempio
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "oauth-mcp-server" \
  --display-name "OAuth MCP Server" \
  --record-type MCP \
  --descriptors '{
    "mcpServer": {
      "source": {
        "fromUrl": {
          "url": "$MCP_OAUTH_URL",
          "credentialProviderConfigurations": [
            {
              "credentialProviderType": "OAUTH",
              "credentialProvider": {
                "oauthCredentialProvider": {
                  "providerArn": "$OAUTH_PROVIDER_ARN",
                  "grantType": "CLIENT_CREDENTIALS"
                }
              }
            }
          ]
        }
      }
    }
  }' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "oauth-mcp-server" \
  --descriptor-type MCP \
  --synchronization-type URL \
  --synchronization-configuration '{
    "fromUrl":
    {
        "url": "$MCP_OAUTH_URL",
        "credentialProviderConfigurations":
        [
            {
                "credentialProviderType": "OAUTH",
                "credentialProvider":
                {
                    "oauthCredentialProvider":
                    {
                        "providerArn": "$OAUTH_PROVIDER_ARN",
                        "grantType": "CLIENT_CREDENTIALS"
                    }
                }
            }
        ]
    }
  }' \
  --region us-east-1

Sono richieste autorizzazioni IAM aggiuntive:

Nota

Queste autorizzazioni IAM relative alla sincronizzazione autorizzano l'identità del carico di lavoro e le risorse del provider di credenziali OAuth gestite da Identity. AgentCore Tali risorse rimangono intenzionalmente all'interno del namespace, quindi questa politica non cambiabedrock-agentcore.

{
    "Statement":
    [
        {
            "Effect": "Allow",
            "Action":
            [
                "bedrock-agentcore:GetWorkloadAccessToken"
            ],
            "Resource":
            [
                "arn:aws:bedrock-agentcore:*:<account>:workload-identity-directory/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action":
            [
                "bedrock-agentcore:GetResourceOauth2Token"
            ],
            "Resource":
            [
                "arn:aws:bedrock-agentcore:<region>:<account>:token-vault/default/oauth2credentialprovider/<oauthProviderName>"
            ]
        }
    ]
}
Nota

Indirizza la GetResourceOauth2Token dichiarazione allo specifico provider di credenziali OAuth ARN di cui è necessario il token di accesso per questo ruolo. Evita i caratteri jolly nel segmento dei provider dell'ARN, ad esempio token-vault/default/oauth2credentialprovider/ concedendo l'accesso a tutti i provider di credenziali OAuth dell'account, in modo da consentire l'accesso alle credenziali tra team. token-vault/ Segui il principio del privilegio minimo nominando, ad esempio, il provider specifico nel campo. Resource arn:aws:bedrock-agentcore:<region>:<account>:token-vault/default/oauth2credentialprovider/<oauthProviderName>

Restrizioni:

  • Il chiamante CreateRegistryRecord o UpdateRegistryRecord deve disporre dell'identità del carico di lavoro e GetResourceOauth2Token dell'autorizzazione GetWorkloadAccessToken associate al registro per il provider di credenziali.

  • Il fornitore delle credenziali deve provenire dallo stesso account.

Sincronizzazione da un server MCP IAM-protected

Per i server MCP su Amazon Bedrock AgentCore Runtime o Amazon Bedrock AgentCore Gateway, specifica un ruolo IAM per la firma SIGv4. Il ruolo deve disporre dell'autorizzazione per accedere al servizio di destinazione. Ad esempio: bedrock-agentcore:InvokeAgentRuntime o bedrock-agentcore:InvokeAgentRuntimeForUser su AgentCore Runtime; bedrock-agentcore:InvokeGateway su AgentCore Gateway.

Oltre al ruolo IAM, è necessario specificare il service campo per la firma SIGv4. Se il tuo MCP funziona su AgentCore Runtime o AgentCore Gateway, il valore dovrebbe essere. agent-registry Se il tuo MCP funziona su Amazon API Gateway, dovrebbe esserloexecute-api, e se il tuo MCP funziona su AWS Lambda, dovrebbe esserlo. lambda

regionil valore è opzionale. Per impostazione predefinita, la richiesta verrà firmata nella stessa regione del registro.

Console

Esempio
AWS Agent Registry namespace

  1. Aprire la pagina dei dettagli del registro nella console AWS Agent Registry.

  2. Nella sezione Record di registro, scegli Crea record.

  3. Scegli Sincronizza dall'endpoint.

  4. In Dettagli del record, per Tipo, scegli MCP. Il descrittore è impostato sul server MCP.

  5. Per Endpoint, immettere l'URL del IAM-protected server MCP. Deve essere un URL HTTPS valido.

  6. In Tipo di credenziale, scegli IAM.

  7. Per Role ARN, inserisci il ruolo IAM ARN da assumere per la firma Sigv4.

  8. Per Service, inserisci il nome del servizio per la firma Sigv4 (ad esempio,,). agent-registry execute-api lambda

  9. (Facoltativo) Espandi la configurazione aggiuntiva e scegli una regione per la firma Sigv4. Se non specificato, viene utilizzata la regione propria del registro.

  10. (Facoltativo) Nella sezione Tag, scegli Aggiungi nuovo tag per allegare uno o più tag al record. Ogni tag ha una chiave e un valore opzionale.

  11. Scegli Crea record.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Apri la pagina dei dettagli del registro nella Bedrock-AgentCore console.

  2. Nella sezione Record di registro, scegli Crea record.

  3. Scegli Sincronizza dall'endpoint.

  4. In Dettagli del record, scegli MCP come tipo di record.

  5. Per Endpoint, inserisci l'URL del server IAM-protected MCP. Deve essere un URL HTTPS valido.

  6. In Tipo di credenziale, scegli IAM.

  7. Per Role ARN, inserisci il ruolo IAM ARN da assumere per la firma Sigv4.

  8. Per Service, inserisci il nome del servizio per la firma SIGv4 (ad esempio,,). bedrock-agentcore execute-api lambda

  9. (Facoltativo) Espandi la configurazione aggiuntiva e scegli una regione per la firma Sigv4. Se non specificato, viene utilizzata la regione propria del registro.

  10. Scegli Crea record.

Il record viene creato nello stato CREATING. Il registro si connette all'endpoint utilizzando le credenziali IAM, estrae le definizioni di server e strumenti e compila i descrittori del record. Al termine della sincronizzazione, il record passa a DRAFT. Se la sincronizzazione non riesce, il record passa allo stato CREATE_FAILED con i dettagli dell'errore disponibili nel campo Status Reason. Per la risoluzione dei problemi, consulta Errori di sincronizzazione dei record. Registra gli errori di sincronizzazione

AWS CLI

Esempio
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "gateway-mcp-server" \
  --display-name "Gateway MCP Server" \
  --record-type MCP \
  --descriptors '{
    "mcpServer": {
      "source": {
        "fromUrl": {
          "url": "$MCP_IAM_URL",
          "credentialProviderConfigurations": [
            {
              "credentialProviderType": "IAM",
              "credentialProvider": {
                "iamCredentialProvider": {
                  "roleArn": "$IAM_ROLE_ARN",
                  "service": "$SIGNING_SERVICE",
                  "region": "$SIGNING_REGION"
                }
              }
            }
          ]
        }
      }
    }
  }' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "gateway-mcp-server" \
  --descriptor-type MCP \
  --synchronization-type URL \
  --synchronization-configuration '{
    "fromUrl":
    {
        "url": "$MCP_IAM_URL",
        "credentialProviderConfigurations":
        [
            {
                "credentialProviderType": "IAM",
                "credentialProvider":
                {
                    "iamCredentialProvider":
                    {
                        "roleArn": "$IAM_ROLE_ARN",
                        "service": "$SIGNING_SERVICE",
                        "region": "$SIGNING_REGION"
                    }
                }
            }
        ]
    }
  }' \
  --region us-east-1

Sono richieste autorizzazioni IAM aggiuntive:

Nota

Questa iam:PassRole policy autorizza il registro a cedere un ruolo a AgentCore Identity per la sincronizzazione in uscita. Il valore della iam:PassedToService condizione bedrock-agentcore.amazonaws.com si riferisce all'entità del servizio AgentCore Identity e non cambia.

{
    "Statement":
    [
        {
            "Effect": "Allow",
            "Action":
            [
                "iam:PassRole"
            ],
            "Resource":
            [
                "arn:aws:iam::<account>:role/<sync-role>"
            ],
            "Condition":
            {
                "StringEquals":
                {
                    "iam:PassedToService": "bedrock-agentcore.amazonaws.com"
                }
            }
        }
    ]
}

Effettua la sincronizzazione da una scheda agente A2A

Fornisci l'URL della scheda agente o l'URL di base dell'agente dove è .well-known/agent-card.json possibile scoprirla:

Console

Esempio
AWS Agent Registry namespace

  1. Aprire la pagina dei dettagli del registro nella console AWS Agent Registry.

  2. Nella sezione Record di registro, scegli Crea record.

  3. Scegli Sincronizza dall'endpoint.

  4. In Dettagli del record, per Tipo, scegli Agente. Il Descrittore è impostato su A2A Agent Card.

  5. Per Endpoint, inserisci l'URL della scheda agente (ad es.). https://agent.example.com/.well-known/agent-card.json Deve essere un URL HTTPS valido.

  6. In Tipo di credenziale, scegli il metodo di autorizzazione appropriato:

    1. Nessuno: per le carte agente accessibili al pubblico.

    2. IAM: per agenti ospitati su AgentCore Runtime o Gateway. Fornisci l'ARN del ruolo e il nome del servizio.

    3. OAuth: per gli agenti. OAuth-protected Seleziona o inserisci l'ARN del fornitore di credenziali.

  7. (Facoltativo) Nella sezione Tag, scegli Aggiungi nuovo tag per allegare uno o più tag al record. Ogni tag ha una chiave e un valore opzionale.

  8. Scegli Crea record.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Apri la pagina dei dettagli del registro nella Bedrock-AgentCore console.

  2. Nella sezione Record di registro, scegli Crea record.

  3. Scegli Sincronizza dall'endpoint.

  4. In Dettagli del record, scegli Agente come tipo di record.

  5. Per Endpoint, inserisci l'URL della scheda dell'agente (ad es.https://agent.example.com/.well-known/agent-card.json). Deve essere un URL HTTPS valido.

  6. In Tipo di credenziale, scegli il metodo di autorizzazione appropriato:

    1. Nessuno: per le carte agente accessibili al pubblico.

    2. IAM: per agenti ospitati su AgentCore Runtime o Gateway. Fornisci l'ARN del ruolo e il nome del servizio.

    3. OAuth: per gli agenti. OAuth-protected Seleziona o inserisci l'ARN del fornitore di credenziali.

  7. Scegli Crea record.

Il record viene creato nello stato CREATING. Il registro si connette all'endpoint, estrae i metadati della scheda agente e compila i descrittori del record. Al termine della sincronizzazione, il record passa a DRAFT. Se la sincronizzazione non riesce, il record passa allo stato CREATE_FAILED con i dettagli dell'errore disponibili nel campo Status Reason. Per la risoluzione dei problemi, consulta Errori di sincronizzazione dei record. Registra gli errori di sincronizzazione

AWS CLI

Esempio
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "travel-agent" \
  --display-name "Travel Agent" \
  --record-type AGENT \
  --descriptors '{
    "a2aAgentCard": {
      "source": {
        "fromUrl": {
          "url": "https://agent.example.com/.well-known/agent-card.json"
        }
      }
    }
  }' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "travel-agent" \
  --descriptor-type A2A \
  --synchronization-type URL \
  --synchronization-configuration '{"fromUrl": {"url": "https://agent.example.com/.well-known/agent-card.json"}}' \
  --region us-east-1

È inoltre possibile specificare i provider di credenziali per la sincronizzazione A2A, ad esempio è possibile eseguire la sincronizzazione da un agente ospitato su. AgentCore agent-registryDa utilizzare come service campo quando la destinazione della sincronizzazione è un agente ospitato su Runtime o Gateway. AgentCore

Esempio
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "a2a_agent_record" \
  --display-name "A2A Agent Record" \
  --record-type AGENT \
  --descriptors "{
    \"a2aAgentCard\": {
      \"source\": {
        \"fromUrl\": {
          \"url\": \"$A2A_URL\",
          \"credentialProviderConfigurations\": [{
            \"credentialProviderType\": \"IAM\",
            \"credentialProvider\": {
              \"iamCredentialProvider\": {
                \"roleArn\": \"$IAM_INVOKER_ROLE\",
                \"service\": \"agent-registry\"
              }
            }
          }]
        }
      }
    }
  }"
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "a2a_agent_record" \
  --descriptor-type A2A \
  --synchronization-type URL \
  --synchronization-configuration "{
    \"fromUrl\": {
        \"url\": \"$A2A_URL\",
        \"credentialProviderConfigurations\": [{
            \"credentialProviderType\": \"IAM\",
            \"credentialProvider\": {
                \"iamCredentialProvider\": {
                    \"roleArn\": \"$IAM_INVOKER_ROLE\",
                    \"service\": \"bedrock-agentcore\"
                }
            }
        }]
    }
  }"

Attiva la sincronizzazione su un record esistente

Console

  1. Aprire la pagina dei dettagli del record per un record MCP o Agent con la sincronizzazione configurata.

Esempio
AWS Agent Registry namespace

  1. Dalla pagina dei dettagli del record nella console del registro degli AWS agenti, scegli Gestisci, quindi scegli Sincronizzazione.

  2. Nella finestra di dialogo di conferma, esaminate il messaggio secondo cui la sincronizzazione ripristinerà lo stato di bozza del record.

  3. Scegli Sincronizza per confermare.

In alternativa, puoi attivare la sincronizzazione durante la modifica:

  1. Dalla pagina dei dettagli del record, scegli Gestisci, quindi scegli Modifica.

  2. In Sincronizza dall'endpoint, seleziona la casella di controllo Re-sync dall'endpoint.

  3. Scegli Save changes (Salva modifiche).

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Dalla pagina dei dettagli del record nella Bedrock-AgentCore console, scegli il pulsante Sincronizza nelle azioni dell'intestazione.

  2. Nella finestra di dialogo di conferma, rivedi il messaggio secondo cui la sincronizzazione ripristinerà lo stato di bozza del record.

  3. Scegli Sincronizza per confermare.

In alternativa, puoi attivare la sincronizzazione durante la modifica:

  1. Dalla pagina dei dettagli del record, scegli il menu a tre punti (⋮), quindi scegli Modifica.

  2. In Sincronizza dall'endpoint, seleziona la casella di controllo Re-sync dall'endpoint.

  3. Scegli Save changes (Salva modifiche).

Il record passa allo stato UPDATING durante la sincronizzazione. Dopo il completamento, torna a DRAFT con i descrittori aggiornati dall'origine. Se la sincronizzazione non riesce, il record passa allo stato UPDATE_FAILED con i dettagli dell'errore disponibili nel campo Status Reason. Per la risoluzione dei problemi, consulta Errori di sincronizzazione dei record. Registra gli errori di sincronizzazione

AWS CLI

Esempio
AWS Agent Registry namespace
aws agent-registry-control update-registry-record \
  --registry-id $REGISTRY_ID \
  --record-id $RECORD_ID \
  --trigger-synchronization \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control update-registry-record \
  --registry-id $REGISTRY_ID \
  --record-id $RECORD_ID \
  --trigger-synchronization \
  --region us-east-1

AWS SDK

Esempio
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.update_registry_record(
    registryId='<registryId>',
    recordId='<recordId>',
    triggerSynchronization=True
)
print(f"Status: {response['status']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.update_registry_record(
    registryId='<registryId>',
    recordId='<recordId>',
    triggerSynchronization=True
)
print(f"Status: {response['status']}")
Nota

Se lo stato del record non è BOZZA (ad esempio, APPROVATO), l'aggiornamento crea una nuova revisione DRAFT. La revisione approvata rimane rilevabile.

Risoluzione dei problemi: vedi Registra errori di sincronizzazione.