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á.

Solução de problemas

Erros de validação de esquema

Ao criar tipos diferentes de registros, você pode ver uma exceção de validação para os descritores. Consulte a seção Tipos de registro compatíveis para obter esquemas válidos.

Erros comuns:

Erros de sincronização de registros

Quando você cria ou atualiza um registro usando o recurso de sincronização, o registro pode passar para o status CREATE_FAILED ou UPDATE_FAILED, com uma explicação do que aconteceu. statusReason

Em alto nível, os erros podem ser categorizados como: erros de permissão, erros de conexão, erros de validação e erros do lado do servidor.

Erros de permissão

A configuração de sincronização está errada ou expirou:

Erros de conexão

Não consigo acessar o servidor:

Erros de validação

O servidor respondeu, mas o conteúdo não é suportado:

Erros do lado do servidor

Auto-detection erros

“A criação de um registro com escopo organizacional exige que o chamador faça parte de um AWS Organização.”

A conta que cria o registro não é membro de uma AWS organização (por exemplo, é uma conta independente). Crie o registro a partir de uma conta que pertence à sua organização.

“Auto-detection as condições prévias não estão satisfeitas para esta organização.”

A organização ainda não atende às pré-condições de detecção automática ou ainda não concluiu a propagação. Confirme se o acesso confiável está ativado para detecção automática e se você está criando o registro a partir da conta de gerenciamento ou de um administrador delegado registrado e tente novamente após uma breve espera. Consulte Habilitando a detecção automática em sua organização.

“Já existe um registro com escopo organizacional para essa conta.”

Essa conta já possui um registro com escopo organizacional, e uma conta só pode ter um. Use o registro existente ou exclua-o antes de criar outro. Se você não conseguir encontrar o registro nessa conta, consulte Como localizar um registro existente com escopo organizacional.

“Outro registro com escopo organizacional com detecção automática ativa já existe para essa organização.”

Outra conta em sua organização já possui um registro com escopo organizacional com detecção automática ativa, e uma organização só pode ter um de cada vez. Por motivos de segurança, a mensagem de erro não nomeia a conta que possui o registro existente. Para encontrá-lo e escolher como resolver o conflito, consulte Localizando um registro existente com escopo organizacional.

Localizando um registro existente com escopo organizacional

Quando CreateRegistry relata que um registro com escopo organizacional já existe — na sua conta ou em algum outro lugar da organização — o erro não nomeia o registro específico ou a conta que o possui. Encontre primeiro o registro existente e depois decida como resolver o conflito.

Um registro com escopo organizacional normalmente pertence a uma das seguintes contas:

Peça a um administrador com acesso a essas contas que liste os registros na mesma região da chamada que falhou e procure um que sejaautoDetectionConfiguration.scope: ORGANIZATION

aws agent-registry-control list-registries --region us-east-1

Na conta de gerenciamento, confirme qual conta é atualmente o administrador delegado:

aws organizations list-delegated-administrators \
  --service-principal agent-registry.amazonaws.com

O conflito só se aplica à mesma região — um registro em us-east-1 não impede a criação de um emus-west-2.

Depois de localizar o registro existente, escolha um dos seguintes caminhos:

CreateRegistryfalha mesmo que o acesso confiável esteja ativado e o administrador delegado esteja registrado

Confirme se a conta de gerenciamento tem a função vinculada ao serviço AWS Agent Registry ()AWSServiceRoleForAgentRegistry. Ele deve existir na conta de gerenciamento antes que um registro com escopo organizacional possa ser criado, mesmo quando o administrador delegado é quem o cria. Consulte a Etapa 1: Habilitar o acesso confiável e criar a função vinculada ao serviço.

O registro está PRONTO, mas os registros não estão aparecendo

Confirme se o status de detecção automática do registro é ACTIVE (comget-registry) e se as contas membros contêm tipos de recursos compatíveis (AgentCore Runtimes ou Gateways). Dê tempo para que a descoberta seja concluída — na primeira configuração, a descoberta inicial de recursos preexistentes pode levar até 20 minutos.

Auto-detection o status ainda mostra “O registro da conta de administrador delegado do registro foi cancelado” depois que um administrador delegado é registrado novamente

Quando a conta de gerenciamento cancela o registro do administrador delegado que possui um registro com escopo organizacional, o AWS Agent Registry desativa a detecção automática desse registro e registra o motivo do status. The registry’s delegated administrator account was deregistered. Esse motivo de status descreve por que a detecção automática foi originalmente desativada — é um registro histórico e não é atualizado quando o estado da organização muda posteriormente.

Se um administrador delegado for registrado novamente, a detecção automática do registro não será retomada automaticamente e o motivo do status continuará exibindo a mensagem de cancelamento do registro. Isso é esperado em cada uma das seguintes situações:

Para retomar a detecção automática, a conta proprietária do registro afetado deve enabled voltar explicitamente para. true Somente um registro com escopo organizacional por região pode ser autoDetection.status definido como ACTIVE em uma organização, portanto, se vários registros estiverem qualificados, reative a detecção automática somente naquele que você deseja manter ativo.

aws agent-registry-control update-registry \
  --registry-id <registry-id-or-arn> \
  --auto-detection-configuration '{"optionalValue":{"scope":"ORGANIZATION","enabled":true}}' \
  --region us-east-1

Para ver o ciclo de vida completo, consulte Desativar a detecção automática.

“O registro não pode ser excluído enquanto a detecção automática estiver ativada. Desative a detecção automática primeiro.”

Você deve desativar a detecção automática antes de excluir um registro com escopo organizacional. Para excluir o registro, conclua estas etapas na ordem:

Para obter mais informações, consulte Desativar a detecção automática no registro.