기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

문제 해결

스키마 유효성 검사 오류

다른 유형의 레코드를 생성할 때 설명자에 대한 검증 예외가 표시될 수 있습니다. 유효한 스키마는 지원되는 레코드 유형 섹션을 참조하세요.

일반적인 오류:

동기화 오류 기록

동기화 기능을 사용하여 레코드를 생성하거나 업데이트하면 레코드가 CREATE_FAILED 또는 UPDATE_FAILED 상태로 전환되어 발생한 일을 statusReason 설명할 수 있습니다.

상위 수준에서 오류는 권한 오류, 연결 오류, 검증 오류, 서버 측 오류로 분류할 수 있습니다.

권한 오류

동기화 구성이 잘못되었거나 만료되었습니다.

연결 오류

서버에 연결할 수 없습니다.

유효성 검사 오류

서버가 응답했지만 콘텐츠는 지원되지 않습니다.

서버 측 오류

자동 감지 오류

“조직 범위 레지스트리를 생성하려면 호출자가 AWS 조직에 속해야 합니다.”

레지스트리를 생성하는 계정은 AWS 조직의 멤버가 아닙니다(예: 독립 실행형 계정). 조직에 속한 계정에서 레지스트리를 생성합니다.

“이 조직에서는 자동 감지 사전 조건이 충족되지 않습니다.”

조직이 아직 자동 감지 사전 조건을 충족하지 않거나 전파를 완료하지 않았습니다. 신뢰할 수 있는 액세스가 자동 감지를 위해 활성화되어 있고 관리 계정 또는 등록된 위임된 관리자로부터 레지스트리를 생성하고 있는지 확인한 다음 잠시 기다린 후 다시 시도하세요. 조직 전체에서 자동 감지 활성화를 참조하세요.

“이 계정에 대해 조직 범위의 레지스트리가 이미 있습니다.”

이 계정은 이미 조직 범위의 레지스트리를 소유하고 있으며 계정에는 하나만 있을 수 있습니다. 기존 레지스트리를 사용하거나 다른 레지스트리를 생성하기 전에 삭제합니다. 이 계정에서 레지스트리를 찾을 수 없는 경우 기존 조직 범위 레지스트리 찾기를 참조하세요.

“이 조직에 대해 활성 자동 감지가 있는 다른 조직 범위 레지스트리가 이미 있습니다.”

조직의 다른 계정은 이미 활성 자동 감지 기능이 있는 조직 범위 레지스트리를 소유하고 있으며, 조직은 한 번에 하나만 가질 수 있습니다. 보안상의 이유로 오류 메시지는 기존 레지스트리를 소유한 계정의 이름을 지정하지 않습니다. 충돌을 찾고 해결 방법을 선택하려면 기존 조직 범위 레지스트리 찾기를 참조하세요.

기존 조직 범위 레지스트리 찾기

에서 계정 또는 조직의 다른 위치에 조직 범위 레지스트리가 이미 존재한다고 CreateRegistry 보고하는 경우 오류는 특정 레지스트리 또는 해당 레지스트리를 소유한 계정의 이름을 지정하지 않습니다. 기존 레지스트리를 먼저 찾은 다음 충돌을 해결하는 방법을 결정합니다.

조직 범위의 레지스트리는 일반적으로 다음 계정 중 하나가 소유합니다.

해당 계정에 액세스할 수 있는 관리자에게 실패한 호출과 동일한 리전의 레지스트리를 나열하도록 요청하고이 autoDetectionConfiguration.scope인 레지스트리를 찾습니다ORGANIZATION.

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

관리 계정에서 현재 위임된 관리자인 계정을 확인합니다.

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

충돌은 동일한 리전 내에서만 적용됩니다.의 레지스트리는에서 하나를 생성하는 것을 금지하지 us-east-1 않습니다us-west-2.

기존 레지스트리를 찾으면 다음 경로 중 하나를 선택합니다.

CreateRegistry 신뢰할 수 있는 액세스가 활성화되고 위임된 관리자가 등록되더라도 실패

관리 계정에 AWS 에이전트 레지스트리 서비스 연결 역할()이 있는지 확인합니다AWSServiceRoleForAgentRegistry. 위임된 관리자가 레지스트리를 생성하는 관리자인 경우에도 조직 범위 레지스트리를 생성하려면 먼저 관리 계정에 있어야 합니다. 1단계: 신뢰할 수 있는 액세스 활성화 및 서비스 연결 역할 생성을 참조하세요.

레지스트리는 READY 이지만 레코드가 표시되지 않음

레지스트리의 자동 감지 상태가 ACTIVE ( 사용get-registry)이고 멤버 계정에 지원되는 리소스 유형(AgentCore 런타임 또는 게이트웨이)이 포함되어 있는지 확인합니다. 검색이 완료될 때까지 기다립니다. 처음 설정하면 기존 리소스의 초기 검색에 최대 20분이 걸릴 수 있습니다.

위임된 관리자가 다시 등록된 후에도 자동 감지 상태가 여전히 '레지스트리의 위임된 관리자 계정이 등록 취소됨'으로 표시됨

관리 계정이 조직 범위 레지스트리를 소유한 위임된 관리자를 등록 취소하면 AWS 에이전트 레지스트리는 해당 레지스트리에서 자동 감지를 끄고 상태 이유를 기록합니다. The registry’s delegated administrator account was deregistered.이 상태 이유는 자동 감지가 원래 비활성화된 이유를 설명합니다. 이는 기록 레코드이며 나중에 조직 상태가 변경될 때 새로 고쳐지지 않습니다.

위임된 관리자가 다시 등록되면 레지스트리의 자동 감지가 자동으로 재개되지 않고 상태 이유에 등록 취소 메시지가 계속 표시됩니다. 이는 다음 각 상황에서 예상됩니다.

자동 감지를 재개하려면 영향을 받는 레지스트리를 소유한 계정이 로 명시적으로 enabled 다시 설정해야 합니다true. 리전당 하나의 조직 범위 레지스트리만 ACTIVE 조직에서 로 autoDetection.status 설정할 수 있으므로, 여러 레지스트리가 적합한 경우 활성 상태로 유지하려는 레지스트리에서만 자동 감지를 다시 활성화합니다.

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

전체 수명 주기는 자동 감지 끄기를 참조하세요.

"자동 감지가 활성화된 동안에는 레지스트리를 삭제할 수 없습니다. 먼저 자동 감지를 비활성화합니다.”

조직 범위 레지스트리를 삭제하려면 먼저 자동 감지를 비활성화해야 합니다. 레지스트리를 삭제하려면 다음 단계를 순서대로 완료합니다.

자세한 내용은 레지스트리에서 자동 감지 비활성화를 참조하세요.