API 버전 잠금 - AWS SDK for JavaScript
API 버전 가져오기

AWS SDK for JavaScript v2가 지원 종료에 도달했습니다. AWS SDK for JavaScript v3로 마이그레이션하실 것을 권장합니다. 마이그레이션 방법에 대한 자세한 내용은 해당 공지 사항을 참조하세요.

API 버전 잠금

AWS 서비스에는 API 호환성을 추적하는 API 버전 번호가 있습니다. AWS 서비스의 API 버전은 YYYY-mm-dd 형식의 날짜 문자열로 식별됩니다. 예를 들어 Amazon S3의 현재 API 버전은 2006-03-01입니다.

프로덕션 코드에서 서비스의 API 버전을 사용하는 경우 잠그는 것이 좋습니다. 그러면 SDK 업데이트로 인한 서비스 변경으로부터 애플리케이션을 격리할 수 있습니다. 서비스 객체를 생성할 때 API 버전을 지정하지 않으면 SDK가 기본적으로 최신 API 버전을 사용합니다. 그러면 애플리케이션이 애플리케이션에 부정적인 영향을 주는 변경 사항이 포함된 업데이트된 API를 참조할 수 있습니다.

서비스에 사용하는 API 버전을 잠그려면 서비스 객체를 생성할 때 apiVersion 파라미터를 전달합니다. 다음 예제에서는 새로 생성된 AWS.DynamoDB 서비스 객체가 2011-12-05 API 버전으로 잠깁니다.

var dynamodb = new AWS.DynamoDB({apiVersion: '2011-12-05'});

AWS.Config에서 apiVersions 파라미터를 지정하여 서비스 API 버전 집합을 전역으로 구성할 수 있습니다. 예를 들어 현재 Amazon Redshift API와 함께 특정 버전의 DynamoDB 및 Amazon EC2 API를 설정하려면 다음과 같이 apiVersions를 설정합니다.

AWS.config.apiVersions = {
  dynamodb: '2011-12-05',
  ec2: '2013-02-01',
  redshift: 'latest'
};

API 버전 가져오기

서비스의 API 버전을 가져오려면 서비스의 참조 페이지(예: Amazon S3용 https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html)에서 API 버전 잠금 섹션을 참조하세요.