자격 증명의 범위는 유효한 지역으로 지정되어야 합니다.

TL;DR — 서명 버전 4는 각 요청의 자격 증명 범위에 지역을 적용합니다. 이 오류는 해당 범위의 지역이 실제로 도달한 엔드포인트의 지역과 일치하지 않음을 의미합니다. 즉, 한 지역에 서명하고 다른 지역으로 요청을 보냈습니다(또는 잘못된 지역 코드를 사용했습니다). 클라이언트의 구성된 지역이 호출하는 엔드포인트와 일치하도록 만드세요.

무엇을 의미하는가

InvalidSignatureException: Credential should be scoped to a valid region, not 'us-west-1'.

서명된 모든 AWS 요청에는 자격 증명 범위, 즉 서명이 계산되는 YYYYMMDD/region/service/aws4_request 문자열이 포함됩니다(리전 및 서비스 코드는 소문자여야 함). AWS는 요청을 수신한 엔드포인트에서 예상 서명을 다시 파생합니다. 범위에 포함된 지역이 요청을 처리하는 지역이 아닌 경우 이 메시지와 함께 확인이 실패합니다. HTTP 400, 클라이언트 측이며 지역이 수정될 때까지 재시도할 수 없습니다.

왜 발생하는가

한 지역에 대해 서명되어 다른 지역으로 전송됨 — SDK에 구성된 region는 다른 지역을 가리키는 하드 코딩되거나 재정의된 endpoint와 다릅니다.
일치하는 지역이 없는 사용자 지정 엔드포인트 — endpoint: https://dynamodb.eu-west-2.amazonaws.com를 설정했지만 클라이언트 지역을 eu-west-1에 두었습니다.
유효하지 않거나 빈 리전 문자열 — 오타 또는 설정되지 않은 환경 변수로 인해 AWS가 유효한 것으로 받아들일 수 없는 범위가 생성됩니다.
서명된 엔드포인트가 아닌 다른 지역 엔드포인트로 요청을 전달하는 프록시 또는 게이트웨이입니다.

어떻게 해결하는가

클라이언트 지역을 엔드포인트와 일치시킵니다. dynamodb.<region>.amazonaws.com를 가리키는 경우 클라이언트의 region를 동일한 <region>로 설정합니다.
리전만 설정하는 것을 선호하고 SDK가 엔드포인트를 구축하도록 합니다. 꼭 필요한 경우가 아니면 수동 재정의를 삭제합니다(예: DynamoDB Local).
지역 코드가 유효한지 확인(us-east-1, eu-west-2, …)하고 실제로 설정되었는지 확인하세요. AWS_REGION/AWS_DEFAULT_REGION 및 구성 파일을 확인하세요.
수임된 역할 또는 교차 지역 설정의 경우 요청이 다른 곳에서 상속된 기본값이 아니라 요청을 보내려는 지역으로 서명되었는지 확인하세요.

DynamoDB Local의 경우 엔드포인트를 http://localhost:8000로 지정하고 클라이언트에 일관된 지역을 제공합니다. 해당 지역은 클라이언트가 서명하는 지역과 일치하기만 하면 됩니다.

먼저 DynoTable에서 확인

DynoTable은 활성 profile에 저장된 지역으로 모든 요청에 서명합니다. 설정 → 프로필은 하나의 양식에 지역 및 선택적 사용자 지정 엔드포인트를 표시합니다. 함께 변경한 다음 연결 테스트를 수행합니다. 이는 endpoint가 eu-west-2를 가리키고 region가 eu-west-1을 유지하는 기존 SDK 실패 모드를 제거합니다.

애플리케이션 코드를 디버그하기 전에 ⌘P을 눌러 어떤 프로필(따라서 어떤 자격 증명 범위)이 라이브인지 확인하세요. 로컬의 경우 엔드포인트 http://localhost:8000와 일치하는 지역을 동일한 프로필에 유지하세요. 프로필이 연결되면 query builder를 사용하여 해당 범위에서 읽기가 성공했음을 증명합니다.

출처

Troubleshoot Signature Version 4 signing (2026-07-13 확인)
Create a signed AWS API request (2026-07-13 인증)

참고 자료

위에 링크된 공식 AWS 문서를 기준으로 2026년 7월 13일에 마지막으로 확인되었습니다.