[AWS] "파일 업로드에 실패했습니다. 오류 메시지: Unable to locate credentials" 에러 해결 방법

👑 "Unable to locate credentials" 오류란?

"Unable to locate credentials" 에러란 AWS 계정과 관련하여 AWS 자격 증명(인증 정보)을 찾을 수 없을 때 발생하는 오류이다.

이전 포스트에서 다루었던 Boto3와 AWS S3 버킷을 이용한 데이터 업로드 자동화 스크립트를 작성하는 과정에서 발생하였으며, 이번 포스트에서는 위 에러의 해결 방안을 다루었다.

 

---

👑 발견한 "Unable to locate credentials" 오류의 주된 원인 및 유의점

1. 계정의 AWS 자격 증명 확인

# AWS 자격 증명 설정
aws_access_key_id = '엑세스 키 ID',
aws_secret_access_key = '계정의 시크릿 엑세스 키'

 

스크립트 작성 과정에서 AWS 자격 증명을 설정하는 절차가 있는데, 이때 시크릿 엑세스 키나 엑세스 키의 ID를 잘못 입력하거나, 두 요소의 짝이 맞지 않으면 위와 같은 오류가 발생한다.

 

시크릿 엑세스 키와 엑세스 키를 생성하지 않은 경우에도 위와 같은 오류가 발생할 수 있는데, 스크립트를 사용하기 전 반드시 AWS 계정의 엑세스 키와 시크릿 엑세스 키를 생성해놓아야 한다.

 

 

++ AWS Access Key & 시크릿 엑세스 키 생성 및 확인 방법

-->  https://docs.aws.amazon.com/powershell/latest/userguide/pstools-appendix-sign-up.html

AWS Account and Access Keys - AWS Tools for PowerShell

 

---

 

2. 함수 호출 시 인증 정보 전달 여부

def upload_file_to_s3(local_file_path, bucket_name, s3_file_path, aws_access_key_id, aws_secret_access_key):
    """
    로컬 파일을 S3 버킷에 업로드하는 함수
    :param local_file_path: 업로드할 로컬 파일의 경로 (예: "C:\\Users\\USER\\Desktop\\1234.mp3")
    :param bucket_name: 업로드할 S3 버킷의 이름
    :param s3_file_path: S3 버킷 내에서 파일이 저장될 경로 및 이름 (예: "uploads/1234.mp3")
    :param aws_access_key_id: AWS 액세스 키 ID
    :param aws_secret_access_key: AWS 비밀 액세스 키
    """
    try:
        s3_client = boto3.client('s3', aws_access_key_id=aws_access_key_id, aws_secret_access_key=aws_secret_access_key)
        s3_client.upload_file(local_file_path, bucket_name, s3_file_path)
        print(f"파일이 성공적으로 S3 버킷에 업로드되었습니다. 버킷: '{bucket_name}', 경로: '{s3_file_path}'")
    except Exception as e:
        print(f"파일 업로드에 실패했습니다. 오류 메시지: {str(e)}")

 

스크립트에서 실질적인 업로드 역할을 수행하는 함수를 호출할 때, 필요한 인증 정보를 인자로 전달해주지 못하는 경우 위와 같은 에러가 발생한다. 

 

이 경우,  AWS 자격 증명 설정 코드를 스크립트 상에서 파일 저장 경로를 지정하는 코드와 S3 버킷에 파일을 업로드하는 코드 사이에 복사하여 넣어주면 문제를 해결할 수 있다.

 

# AWS 자격 증명 설정
aws_access_key_id = '엑세스 키 ID',
aws_secret_access_key = '계정의 시크릿 엑세스 키'

 

위 코드를

⬇️

아래처럼 배치

 

# S3 버킷의 이름
bucket_name = "giveittome"

# S3 버킷 내에서 파일이 저장될 경로 및 이름
s3_file_path = "hello/test.txt"

<!-- 여기에 해당 코드 추가 -->

# 파일을 S3 버킷에 업로드
upload_file_to_s3(local_file_path, bucket_name, s3_file_path, aws_access_key_id, aws_secret_access_key)

 

---

++ 에러 해결 후의 데이터 업로드 자동화 스크립트가 궁금하다면?

-->  Boto3 SDK를 활용한 데이터 업로드 자동화 스크립트 작성 Forward AWS S3 Bucket (https://alim11.tistory.com/398)

[Data Processing] Boto3 SDK를 활용한 데이터 업로드 자동화 스크립트 작성 (Forward AWS S3 Bucket)