의 구성 및 보안 인증 파일 설정 AWS CLI

보안 인증 정보, 리전 및 출력 형식을 빠르게 설정하고 보려면 이 명령을 실행합니다. 다음 예제는 샘플 값을 보여줍니다.

$ aws configure
AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Default region name [None]: us-west-2
Default output format [None]: json

aws configure set를 사용하여 보안 인증 또는 구성 설정을 지정할 수 있습니다. --profile 설정으로 보거나 수정하려는 프로파일을 지정합니다.

예를 들어 다음 명령은 region프로파일에서 integ을 설정합니다.

$ aws configure set region us-west-2 --profile integ

설정을 제거하려면 텍스트 편집기에서 config 및 credentials 파일의 설정을 수동으로 삭제합니다.

aws configure get을 사용하여 설정한 보안 인증 또는 구성 설정을 검색할 수 있습니다. --profile 설정으로 보거나 수정하려는 프로파일을 지정합니다.

예를 들어 다음 명령은 region프로파일에서 integ 설정을 검색합니다.

$ aws configure get region --profile integ
us-west-2

출력이 비어 있으면 설정이 명시적으로 지정되지 않고 기본값을 사용합니다.

IAM 웹 콘솔에서 생성된 CSV 보안 인증 정보를 가져옵니다. IAM Identity Center에서 생성된 자격 증명에는 해당되지 않습니다. IAM Identity Center를 사용하는 고객은 aws configure sso를 사용해야 합니다. 프로필 이름이 사용자 이름과 일치하는 CSV 파일을 가져옵니다. CSV 파일에는 다음 헤더가 포함되어야 합니다.

$ aws configure import --csv file://credentials.csv

구성 데이터를 나열하려면 aws configure list 명령을 사용합니다. 이 명령은 지정된 프로필에 사용되는 프로필, 액세스 키, 비밀 키 및 리전 구성 정보를 나열합니다. 각 구성 항목에 대해 값, 구성 값이 검색된 위치, 구성 변수 이름이 표시됩니다.

예를 들어 환경 변수 AWS 리전 에 를 제공하는 경우 이 명령은 구성한 리전의 이름, 이 값이 환경 변수에서 가져온 이름, 환경 변수의 이름을 보여줍니다.

역할 및 IAM Identity Center와 같은 임시 자격 증명 방법의 경우 이 명령은 일시적으로 캐시된 액세스 키를 표시하고 보안 액세스 키가 표시됩니다.

$ aws configure list
      Name                    Value             Type    Location
      ----                    -----             ----    --------
   profile                <not set>             None    None
access_key     ****************ABCD  shared-credentials-file    
secret_key     ****************ABCD  shared-credentials-file    
    region                us-west-2             env    AWS_DEFAULT_REGION

모든 프로파일 이름을 나열하려면 aws configure list-profiles 명령을 사용합니다.

$ aws configure list-profiles
default
test

이 명령을 실행하여 AWS IAM Identity Center 보안 인증 정보, 리전 및 출력 형식을 빠르게 설정하고 확인합니다. 다음 예제는 샘플 값을 보여줍니다.

$ aws configure sso
SSO session name (Recommended): my-sso
SSO start URL [None]: https://my-sso-portal.awsapps.com/start
SSO region [None]: us-east-1
SSO registration scopes [None]: sso:account:access

이 명령을 실행하여 credentials 및 config 파일의 sso-session 섹션에서 AWS IAM Identity Center 보안 인증 정보, 리전 및 출력 형식을 빠르게 설정하고 확인합니다. 다음 예제는 샘플 값을 보여줍니다.

$ aws configure sso-session
SSO session name: my-sso
SSO start URL [None]: https://my-sso-portal.awsapps.com/start
SSO region [None]: us-east-1
SSO registration scopes [None]: sso:account:access

명령 요청을 인증하기 위한 자격 증명의 일부로 사용되는 AWS 액세스 키를 지정합니다. 이 키는 config 파일에 저장될 수도 있지만, credentials 파일에 저장하는 것이 좋습니다.

AWS_ACCESS_KEY_ID 환경 변수로 재정의할 수도 있습니다. 명령줄 옵션으로 액세스 키 ID를 지정할 수는 없습니다.

aws_access_key_id = AKIAIOSFODNN7EXAMPLE

명령 요청을 인증하기 위한 자격 증명의 일부로 사용되는 AWS 보안 암호 키를 지정합니다. 이 키는 config 파일에 저장될 수도 있지만, credentials 파일에 저장하는 것이 좋습니다.

AWS_SECRET_ACCESS_KEY 환경 변수로 재정의할 수도 있습니다. 명령줄 옵션으로 보안 액세스 키를 지정할 수는 없습니다.

aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

AWS 세션 토큰을 지정합니다. 세션 토큰은 수동으로 임시 보안 보안 인증을 지정하는 경우에만 필요합니다. 이 키는 config 파일에 저장될 수도 있지만, credentials 파일에 저장하는 것이 좋습니다.

AWS_SESSION_TOKEN 환경 변수로 재정의할 수도 있습니다. 명령줄 옵션으로 세션 토큰을 지정할 수는 없습니다.

aws_session_token = AQoEXAMPLEH4aoAH0gNCAPyJxz4BlCFFxWNE1OPTgk5TthT+FvwqnKwRcOIfrRh3c/LTo6UDdyJwOOvEVPvLXCrrrUtdnniCEXAMPLE/IvU1dYUg2RVAJBanLiHb4IgRmpRV3zrkuWJOgQs8IZZaIv2BXIa2R4Olgk

인증서를 확인하는 데 사용되는 CA SSL 인증서 번들(.pem확장이 있는 파일)을 지정합니다.

AWS_CA_BUNDLE 환경 변수나 --ca-bundle 명령줄 옵션으로 재정의할 수도 있습니다.

ca_bundle = dev/apps/ca-certs/cabundle-2019mar05.pem

AWS CLI 버전 2에 대한 자동 프롬프트를 활성화합니다. 두 가지 설정을 사용할 수 있습니다.

aws_cli_auto_prompt 환경 변수 또는 --cli-auto-prompt 및 --no-cli-auto-prompt 명령줄 파라미터를 사용하여 이 설정을 재정의할 수 있습니다.

AWS CLI 버전 2 자동 프롬프트 기능에 대한 자세한 내용은 섹션을 참조하세요에서 명령 프롬프트 활성화 및 사용 AWS CLI.

AWS CLI 버전 2가 바이너리 입력 파라미터를 해석하는 방법을 지정합니다. 다음 값 중 하나일 수 있습니다.

이 항목은 동등한 수준의 환경 변수를 갖지 않습니다. --cli-binary-format raw-in-base64-out 파라미터를 사용하여 단일 명령에서 값을 지정할 수 있습니다.

cli_binary_format = raw-in-base64-out

fileb:// 접두사 표기법을 사용하여 파일의 이진 값을 참조하는 경우 는 AWS CLI 항상 파일에 원시 이진 콘텐츠가 포함될 것으로 예상하고 값을 변환하려고 시도하지 않습니다.

file:// 접두사 표기법을 사용하여 파일의 이진 값을 참조하면 는 현재 cli_binary_format 설정에 따라 파일을 AWS CLI 처리합니다. 해당 설정의 값이 base64 (명시적으로 설정되지 않은 경우 기본값)인 경우 는 파일에 base64로 인코딩된 텍스트가 포함될 것으로 AWS CLI 예상합니다. 해당 설정의 값이 인 경우 raw-in-base64-out는 파일에 원시 바이너리 콘텐츠가 포함될 것으로 AWS CLI 예상합니다.

기본 설정은 “Disable”입니다. 이 설정은 AWS CLI에 대한 명령 기록을 활성화합니다. 이 설정을 활성화하면 는 aws 명령 기록을 AWS CLI 기록합니다.

cli_history = enabled

기록을 나열하려면 aws history list 명령을 사용하고 세부 정보를 보려면 aws history show 명령에 결과 command_ids를 사용할 수 있습니다. 자세한 내용은 AWS CLI 참조 가이드의 aws history 섹션을 참조하세요.

출력에 사용할 페이저 프로그램을 지정합니다. 기본적으로 AWS CLI 버전 2는 운영 체제의 기본 호출기 프로그램을 통해 모든 출력을 반환합니다.

AWS_PAGER 환경 변수로 재정의할 수 있습니다.

cli_pager=less

출력에 포함된 타임스탬프 값의 형식을 지정합니다. 다른 값 중 하나를 지정할 수 있습니다.

이 항목은 동등한 수준의 환경 변수나 명령줄 옵션을 가지고 있지 않습니다.

cli_timestamp_format = iso8601

이 명령에 사용할 인증 자격 증명을 생성하거나 검색하기 위해 가 AWS CLI 실행하는 외부 명령을 지정합니다. 이 명령은 특정 형식으로 보안 인증을 반환해야 합니다. 이 설정을 사용하는 방법에 대한 자세한 내용은 에서 외부 프로세스를 사용하여 보안 인증 정보 소싱 AWS CLI 단원을 참조하세요.

이 항목은 동등한 수준의 환경 변수나 명령줄 옵션을 가지고 있지 않습니다.

credential_process = /opt/bin/awscreds-retriever --username susan

Amazon EC2 인스턴스 또는 컨테이너 내에서 가 AWS CLI role_arn 파라미터로 지정한 역할을 수임하는 데 사용할 자격 증명을 찾을 수 있는 위치를 지정하는 데 사용됩니다. source_profile과 credential_source 모두를 동일한 프로파일에서 지정할 수 없습니다.

이 파라미터는 다음 세 가지 값 중 하나를 가질 수 있습니다.

credential_source = Ec2InstanceMetadata

역할 세션의 최대 기간(초)을 지정합니다. 이 값의 범위는 900초(15분)부터 해당 역할에 대한 최대 세션 기간 설정(최대값: 43200초)까지 가능합니다. 이는 선택적 파라미터이며 기본적으로 값이 3600초로 설정됩니다.

모든 서비스 요청에 사용되는 엔드포인트를 지정합니다. config 파일의 services 섹션에서 이 설정을 사용하면 엔드포인트가 지정된 서비스에 대해서만 사용됩니다.

다음 예제에서는 Amazon S3에 대해 글로벌 엔드포인트 http://localhost:1234 및 서비스별 엔드포인트 http://localhost:4567를 사용합니다.

[profile dev]
endpoint_url = http://localhost:1234
services = s3-specific

[services s3-specific]
s3 = 
  endpoint_url = http://localhost:4567

엔드포인트 구성 설정은 시스템 또는 사용자 환경 변수, 로컬 AWS 구성 파일 또는 명령줄에 파라미터로 명시적으로 선언되는 등 여러 위치에 있습니다. AWS CLI 엔드포인트 구성 설정은 다음 순서에 따라 우선적으로 적용됩니다.

활성화된 경우 는 config 파일에 지정된 모든 사용자 지정 엔드포인트 구성을 AWS CLI 무시합니다. 유효 값은 true및 false입니다.

ignore_configure_endpoint_urls = true

엔드포인트 구성 설정은 시스템 또는 사용자 환경 변수, 로컬 AWS 구성 파일 또는 명령줄에 파라미터로 명시적으로 선언되는 등 여러 위치에 있습니다. AWS CLI 엔드포인트 구성 설정은 다음 순서에 따라 우선적으로 적용됩니다.

타사에서 고객 계정의 역할을 수임하는 데 사용하는 고유한 식별자를 지정합니다. 이는 ExternalId 작업의 AssumeRole 파라미터로 매핑됩니다. 이 파라미터는 역할에 대한 신뢰 정책에서 ExternalId에 값을 지정하는 경우에만 필요합니다. 자세한 내용은 IAM 사용 설명서의 AWS 리소스에 대한 액세스 권한을 타사에 부여할 때 외부 ID를 사용하는 방법을 참조하세요.

AWS CLI 재시도 핸들러가 사용하는 최대 재시도 횟수 값을 지정합니다. 여기서 초기 호출은 사용자가 제공하는 max_attempts 값으로 계산됩니다.

AWS_MAX_ATTEMPTS 환경 변수를 사용하여 이 값을 재정의할 수 있습니다.

max_attempts = 3

역할을 수임할 때 사용할 MFA 디바이스의 식별 번호입니다. 이는 수임 중인 역할의 신뢰 정책에 MFA 인증이 필요한 조건이 포함된 경우에만 필수입니다. 값은 하드웨어 디바이스의 일련 번호(예: GAHT12345678) 또는 가상 MFA 디바이스의 Amazon 리소스 이름(ARN)(예: )일 수 있습니다arn:aws:iam::123456789012:mfa/user.

이 프로파일을 사용하여 요청된 명령의 기본 출력 형식을 지정합니다. 다음 값 중 하나를 지정할 수 있습니다.

AWS_DEFAULT_OUTPUT 환경 변수나 --output 명령줄 옵션으로 재정의할 수도 있습니다.

output = table

AWS CLI 클라이언트가 파라미터를 AWS 서비스 엔드포인트로 보내기 전에 파라미터 검증을 시도할지 여부를 지정합니다.

이 항목은 동등한 수준의 환경 변수나 명령줄 옵션을 가지고 있지 않습니다.

parameter_validation = false

이 프로파일을 사용하여 요청 AWS 리전 된 명령에 대한 요청을 보낼 를 지정합니다.

AWS_REGION 환경 변수, AWS_DEFAULT_REGION 환경 변수 또는 --region 명령줄 옵션을 사용하여 이 값을 재정의할 수 있습니다.

region = us-west-2

에서 AWS CLI 사용하는 재시도 모드를 지정합니다. 레거시(기본값), 표준 및 적응형, 이렇게 3가지 재시도 모드를 사용할 수 있습니다. 재시도에 대한 자세한 내용은 AWS CLI 에서 재시도 AWS CLI을 참조하세요.

AWS_RETRY_MODE 환경 변수를 사용하여 이 값을 재정의할 수 있습니다.

retry_mode = standard

AWS CLI 명령을 실행하는 데 사용할 IAM 역할의 Amazon 리소스 이름(ARN)을 지정합니다. 또한 다음 파라미터 중 하나를 지정하여 이 역할을 수임할 수 있는 권한이 있는 보안 인증을 식별해야 합니다.

role_arn = arn:aws:iam::123456789012:role/role-name

환경 변수 AWS_ROLE_ARN이 이 설정을 재정의합니다.

웹 보안 인증 사용에 대한 자세한 내용은 웹 자격 증명을 사용한 역할 수임 단원을 참조하세요.

역할 세션에 연결할 이름을 지정합니다. 이 값은 AWS CLI 가 AssumeRole 작업을 호출할 때 RoleSessionName 파라미터에 제공되며, 는 가정된 역할 사용자 의 일부가 됩니다ARN arn:aws:sts::123456789012:assumed-role/role_name/role_session_name. 이는 선택 가능한 파라미터입니다. 이 값을 제공하지 않은 경우 세션 이름이 자동으로 생성됩니다. 이 이름은 이 세션과 연결된 항목에 대한 AWS CloudTrail 로그에 나타납니다.

role_session_name = maria_garcia_role

환경 변수 AWS_ROLE_SESSION_NAME이 이 설정을 재정의합니다.

웹 보안 인증 사용에 대한 자세한 내용은 웹 자격 증명을 사용한 역할 수임 단원을 참조하세요.

프로파일에 사용할 서비스 구성을 지정합니다.

[profile dev-s3-specific-and-global]
endpoint_url = http://localhost:1234
services = s3-specific

[services s3-specific]
s3 = 
  endpoint_url = http://localhost:4567

services 섹션에 대한 자세한 내용은 섹션 유형: services을 참조하세요.

환경 변수 AWS_ROLE_SESSION_NAME이 이 설정을 재정의합니다.

웹 보안 인증 사용에 대한 자세한 내용은 웹 자격 증명을 사용한 역할 수임 단원을 참조하세요.

여러 고객 애플리케이션에서 단일 를 사용하여 에 전화를 걸 AWS 계정 수 있습니다 AWS 서비스. 애플리케이션 ID는 를 사용하여 호출 세트를 수행한 소스 애플리케이션을 식별합니다 AWS 서비스. AWS SDKs 및 서비스는 이 값을 고객 커뮤니케이션에 다시 표시하는 것 외에는 이 값을 사용하거나 해석하지 않습니다. 예를 들어 이 값을 운영 이메일에 포함시켜 알림과 연결된 애플리케이션을 고유하게 식별할 수 있습니다.

애플리케이션 ID는 최대 길이가 50자인 문자열입니다. 문자, 숫자 및 특수 문자는 허용됩니다. ! $ % & * + - . , ^ _ ` | ~ 기본적으로 값이 할당되지 않습니다.

sdk_ua_app_id = prod1

AWS_SDK_UA_APP_ID 환경 변수를 사용하여 이 설정을 덮어쓸 수 있습니다. 이 값은 명령줄 파라미터로 설정할 수 없습니다.

AWS CLI 에서 role_arn 파라미터로 지정한 역할을 수임하는 데 사용할 수 있는 장기 보안 인증으로 명명된 프로파일을 지정합니다. source_profile과 credential_source 모두를 동일한 프로파일에서 지정할 수 없습니다.

source_profile = production-profile

연결된 IAM Identity Center 사용자에게 부여하려는 권한이 있는 IAM 역할이 포함된 AWS 계정 ID를 지정합니다.

이 설정에는 환경 변수 또는 명령줄 옵션이 없습니다.

sso_account_id = 123456789012

AWS 액세스 포털 호스트가 포함된 AWS 리전을 지정합니다. 이는 와 별개이며 기본 CLI region 파라미터와 다른 리전일 수 있습니다.

이 설정에는 환경 변수 또는 명령줄 옵션이 없습니다.

sso_region = us_west-2

sso-session에 대해 인증될 쉼표로 구분된 범위 목록입니다. 범위는 IAM Identity Center 베어러 토큰 승인 엔드포인트에 대한 액세스를 승인합니다. 유효한 범위는 sso:account:access 등 문자열입니다. 이 설정은 새로 고칠 수 없는 레거시 구성에는 적용되지 않습니다.

sso_registration_scopes = sso:account:access

이 프로파일을 사용할 때 사용자의 권한을 정의하는 IAM 역할의 표시 이름을 지정합니다.

이 설정에는 환경 변수 또는 명령줄 옵션이 없습니다.

sso_role_name = ReadAccess

조직의 AWS 액세스 포털을 가리키URL는 를 지정합니다. 는 이를 AWS CLI 사용하여 IAM Identity Center 서비스와 세션을 URL 설정하여 사용자를 인증합니다. AWS 액세스 포털을 찾으려면 다음 중 하나를 URL사용합니다.

이 설정에는 환경 변수 또는 명령줄 옵션이 없습니다.

sso_start_url = https://my-sso-portal.awsapps.com/start

듀얼 스택 엔드포인트를 사용하여 AWS 요청을 보낼 수 있습니다. IPv4 및 IPv6 트래픽을 모두 지원하는 듀얼 스택 엔드포인트에 대한 자세한 내용은 Amazon Simple Storage Service 사용 설명서의 Amazon S3 듀얼 스택 엔드포인트 사용을 참조하세요. 이중 스택 엔드포인트는 일부 리전에 사용할 수 있는 서비스입니다. 서비스 또는 에 대한 듀얼 스택 엔드포인트가 없는 경우 요청이 실패 AWS 리전합니다. 이 옵션은 기본적으로 비활성화되어 있습니다.

이 옵션은 use_accelerate_endpoint 설정에서 함께 사용할 수 없습니다.

엔드포인트 구성 설정은 시스템 또는 사용자 환경 변수, 로컬 AWS 구성 파일 또는 명령줄에 파라미터로 명시적으로 선언되는 등 여러 위치에 있습니다. AWS CLI 엔드포인트 구성 설정은 다음 순서에 따라 우선적으로 적용됩니다.

일부 AWS 서비스는 일부 에서 연방 정보 처리 표준(FIPS) 140-2를 지원하는 엔드포인트를 제공합니다 AWS 리전. AWS 서비스가 를 지원하는 경우 FIPS이 설정은 AWS CLI 에서 를 사용해야 하는 FIPS 엔드포인트를 지정합니다. 표준 AWS 엔드포인트와 달리 FIPS 엔드포인트는 FIPS 140-2를 준수하는 TLS 소프트웨어 라이브러리를 사용합니다. 이러한 엔드포인트는 미국 정부와 상호 작용하는 기업에 필요할 수 있습니다.

이 설정이 활성화되었지만 의 서비스에 대한 FIPS 엔드포인트가 없는 경우 AWS 명령 AWS 리전이 실패할 수 있습니다. 이 경우 --endpoint-url 옵션을 사용하여 명령에 사용할 엔드포인트를 수동으로 지정하거나 서비스별 엔드포인트를 사용합니다.

로 FIPS 엔드포인트를 지정하는 방법에 대한 자세한 내용은 서비스별 엔드포인트 를 AWS 리전참조하세요. FIPS

엔드포인트 구성 설정은 시스템 또는 사용자 환경 변수, 로컬 AWS 구성 파일 또는 명령줄에 파라미터로 명시적으로 선언되는 등 여러 위치에 있습니다. AWS CLI 엔드포인트 구성 설정은 다음 순서에 따라 우선적으로 적용됩니다.

자격 증명 공급자가 제공하는 OAuth 2.0 액세스 토큰 또는 OpenID Connect ID 토큰이 포함된 파일의 경로를 지정합니다. AWS CLI 에서 이 파일의 내용을 로드하고 해당 파일을 WebIdentityToken 작업에 대한 AssumeRoleWithWebIdentity 인수로 전달합니다.

환경 변수 AWS_WEB_IDENTITY_TOKEN_FILE이 이 설정을 재정의합니다.

웹 보안 인증 사용에 대한 자세한 내용은 웹 자격 증명을 사용한 역할 수임 단원을 참조하세요.

AWS CLI 클라이언트가 연결 TCP 유지 패킷을 사용할지 여부를 지정합니다.

이 항목은 동등한 수준의 환경 변수나 명령줄 옵션을 가지고 있지 않습니다.

tcp_keepalive = false

사용할 주소 지정 방식을 지정합니다. 이렇게 하면 버킷 이름이 호스트 이름에 있는지 아니면 의 일부인지 제어합니다URL. 유효 값은 path, virtual 및 auto입니다. 기본값은 auto입니다.

Amazon S3 엔드포인트는 두 가지 방식으로 구성할 수 있습니다. 첫 번째는 virtual이라고 하는 방식으로 호스트 이름의 일부로 버킷 이름을 포함하고 있습니다. 예: https://bucketname.s3.amazonaws.com. 또는 path 스타일로 버킷 이름을 URI의 경로인 것처럼 취급합니다. 예를 들어 입니다https://s3.amazonaws.com/bucketname. 의 기본값은 를 사용하는 것입니다. autoCLI는 가능한 virtual 스타일을 사용하려고 하지만 필요한 경우 path 스타일로 돌아갑니다. 예를 들어 버킷 이름이 DNS 호환되지 않는 경우 버킷 이름은 호스트 이름의 일부가 될 수 없으며 경로에 있어야 합니다. auto를 사용하면 CLI가 이 조건을 감지하고 자동으로 path 스타일로 전환합니다. 주소 지정 스타일을 로 설정한 경우 path에서 AWS CLI 구성한 AWS 리전이 버킷의 리전과 일치하는지 확인해야 합니다.

Sigv4 페이로드에 SHA256 서명할지 여부를 지정합니다. 기본적으로 를 사용할 때 스트리밍 업로드(UploadPart 및 PutObject)에는 비활성화됩니다HTTPS. 기본적으로 스트리밍 업로드(UploadPart 및 PutObject)false의 경우 로 설정되지만 이 존재하고(기본적으로 생성됨) 엔드포인트ContentMD5에서 를 사용하는 경우에만 가능합니다HTTPS.

true로 설정하면 S3 요청은 사용자에 대해 계산되고 요청 서명에 포함된 SHA256 체크섬의 형태로 추가 콘텐츠 검증을 받습니다. false로 설정되어 있는 경우에는 체크섬이 계산되지 않습니다. 이 옵션을 비활성화하는 것이 체크섬 계산에서 생성된 성능 오버헤드를 줄이는 데 유용할 수 있습니다.

모든 s3 및 s3api 명령에서 Amazon S3 Accelerate 엔드포인트를 사용합니다. 기본값은 false입니다. 이 옵션은 use_dualstack_endpoint 설정에서 함께 사용할 수 없습니다.

true로 설정하면 는 모든 Amazon S3 요청을 의 S3 Accelerate 엔드포인트로 AWS CLI 전달합니다s3-accelerate.amazonaws.com. 이 엔드포인트를 사용하려면 버킷에서 S3 Accelerate를 사용하도록 활성화해야 합니다. 모든 요청은 가상의 버킷 주소 지정 방식(my-bucket.s3-accelerate.amazonaws.com)을 사용하여 전송됩니다. 엔드포인트에서 이러한 작업을 지원하지 않기 때문에 어떤 ListBuckets, CreateBucket 및 DeleteBucket 요청도 S3 가속 엔드포인트로 전송되지 않습니다. --endpoint-url 또는 https://s3-accelerate.amazonaws.com 명령에서 http://s3-accelerate.amazonaws.com 파라미터가 s3 또는 s3api으로 설정되어 있는 경우에는 이 동작도 설정할 수 있습니다.

Amazon S3의 데이터 업로드 및 다운로드에 사용할 수 있는 최대 대역폭을 지정합니다. 기본 값은 제한 없음입니다.

이 값은 S3 명령이 Amazon S3와 데이터를 주고 받는 데 사용할 수 있는 최대 대역폭을 제한합니다. 이 값은 업로드 및 다운로드에만 적용되고, 복사 또는 삭제 작업에는 적용되지 않습니다. 이 값은 초당 바이트로 표현됩니다. 이 값을 다음과 같이 형태로 지정할 수 있습니다.

일반적으로 먼저 max_concurrent_requests를 낮춰서 대역폭 사용량을 낮추려고 시도하는 것이 좋습니다. 이렇게 해도 원하는 속도로 대역폭 사용량이 적절하게 제한되지 않는 경우에는 대역폭 사용량을 추가로 제한하는 데 사용되는 max_bandwidth 설정을 사용할 수 있습니다. 이는 max_concurrent_requests가 현재 실행 중인 스레드의 수를 제어하기 때문입니다. 대신에 먼저 max_bandwidth 값을 낮추되, max_concurrent_requests 설정은 높게 놔두면 스레드가 불필요하게 대기해야 하는 결과가 발생할 수 있습니다. 이로 인해 리소스 사용량과 연결 제한 시간이 초과할 수 있습니다.

동시 요청의 최대 수를 지정합니다. 기본값은 10입니다.

aws s3 이전 명령은 멀티스레드가 됩니다. 언제든지 여러 개의 Amazon S3 요청이 실행 중일 수 있습니다. 예를 들어 명령을 사용하여 S3 버킷aws s3 cp localdir s3://bucket/ --recursive에 파일을 업로드하는 경우 는 파일 localdir/file1, localdir/file2및 를 병렬localdir/file3로 업로드할 AWS CLI 수 있습니다. max_concurrent_requests 설정은 동시에 실행 가능한 이전 작업의 최대 수를 지정합니다.

몇 가지 이유에서 이 값을 변경해야 할 수도 있습니다.

작업 대기열의 최대 작업 수를 지정합니다. 기본값은 1000입니다.

는 AWS CLI 내부적으로 Amazon S3 태스크를 대기열에 넣는 모델을 사용하며, 이 작업은 숫자가 로 제한된 소비자가 실행합니다max_concurrent_requests. 태스크는 보통 단일 Amazon S3 작업에 매핑됩니다. 예를 들어 작업은 PutObjectTask, GetObjectTask 또는 UploadPartTask가 될 수 있습니다. 작업이 대기열에 추가되는 속도는 소비자가 작업을 완료하는 속도보다 훨씬 빠를 수 있습니다. 무한 증가를 피하기 위해 작업 대기열 크기가 특정 크기로 제한됩니다. 이 설정은 최대 크기의 값을 변경합니다.

일반적으로 이 설정을 변경할 필요는 없습니다. 이 설정은 AWS CLI 가 실행해야 한다고 인식하는 작업 수에도 해당합니다. 즉, 기본적으로 는 앞으로 1,000개의 작업만 볼 AWS CLI 수 있습니다. 이 값을 늘리면 대기 속도가 작업 완료 속도보다 빠르다고 가정할 때 가 필요한 총 작업 수를 더 빠르게 알 AWS CLI 수 있습니다. max_queue_size가 커질수록 메모리가 더 필요하게 된다는 단점이 있습니다.

가 개별 파일의 멀티파트 전송에 AWS CLI 사용하는 청크 크기를 지정합니다. 기본값은 8MB이며 최소 5MB입니다.

파일 전송이 multipart_threshold를 초과하면 AWS CLI 는 파일을 이 크기의 청크로 분할합니다. multipart_threshold와 동일한 구문을 사용하여, 즉 정수 형태의 바이트 수를 사용하거나 크기와 접미사를 사용하는 방법으로 이 값을 지정할 수 있습니다.

개별 파일의 멀티파트 전송에 AWS CLI 사용하는 크기 임계값을 지정합니다. 기본값은 8MB입니다.

파일을 업로드, 다운로드 또는 복사할 때 파일이 이 크기를 초과하면 Amazon S3 명령이 멀티파트 작업으로 전환됩니다. 이 값을 두 가지 방법으로 지정할 수 있습니다.