Dokumentasi ini AWS CLI hanya untuk Versi 1. Untuk dokumentasi yang terkait dengan Versi 2 AWS CLI, lihat Panduan Pengguna Versi 2.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Konfigurasi dan pengaturan file kredensi di AWS CLI
Anda dapat menyimpan pengaturan konfigurasi dan kredensyal yang sering digunakan dalam file yang dikelola oleh file. AWS CLI
File-file tersebut dibagi menjadiprofiles
. Secara default, AWS CLI menggunakan pengaturan yang ditemukan di profil bernamadefault
. Untuk menggunakan pengaturan alternatif, Anda dapat membuat dan mereferensikan profil tambahan.
Anda dapat mengganti pengaturan individual dengan menyetel salah satu variabel lingkungan yang didukung, atau dengan menggunakan parameter baris perintah. Untuk informasi selengkapnya tentang prioritas pengaturan konfigurasi, lihat. Mengkonfigurasi pengaturan untuk AWS CLI
catatan
Untuk informasi tentang pengaturan kredensional Anda, lihat. Otentikasi dan akses kredensional untuk AWS CLI
Topik
Format konfigurasi dan file kredensi
credentials
File config
dan disusun menjadi beberapa bagian. Bagian termasuk profil. Bagian adalah kumpulan pengaturan bernama, dan berlanjut sampai garis definisi bagian lain ditemukan. Beberapa profil dan bagian dapat disimpan dalam credentials
file config
dan.
File-file ini adalah file teks biasa yang menggunakan format berikut:
-
Nama bagian terlampir dalam tanda kurung [] seperti
[default]
,[profile
, dan.user1
][sso-session]
-
Semua entri dalam suatu bagian mengambil bentuk umum dari.
setting_name=value
-
Baris dapat dikomentari dengan memulai baris dengan karakter hash ()
#
.
Jenis bagian: profile
AWS CLI Toko-toko
Tergantung pada file, nama bagian profil menggunakan format berikut:
-
Berkas Config:
[default]
[profile
user1
] -
File kredensional:
[default]
[
user1
]Jangan gunakan kata
profile
saat membuat entri dalamcredentials
file.
Setiap profil dapat menentukan kredensyal yang berbeda dan juga dapat menentukan AWS Wilayah dan format output yang berbeda. Saat menamai profil dalam config
file, sertakan kata awalan "profile
“, tetapi jangan sertakan dalam credentials
file.
Contoh berikut menunjukkan config
file credentials
dan dengan dua profil, wilayah, dan output yang ditentukan. [default] pertama digunakan saat Anda menjalankan AWS CLI
perintah tanpa profil yang ditentukan. Yang kedua digunakan ketika Anda menjalankan AWS CLI perintah dengan --profile user1
parameter.
Untuk informasi selengkapnya dan otorisasi tambahan dan metode kredensi lihat, lihat. Mengautentikasi menggunakan kredensi pengguna IAM untuk AWS CLI
Jenis bagian: services
services
Bagian ini adalah sekelompok pengaturan yang mengonfigurasi titik akhir kustom untuk Layanan AWS permintaan. Profil kemudian ditautkan ke services
bagian.
[profile
dev
] services =my-services
services
Bagian ini dipisahkan menjadi subbagian dengan <SERVICE> =
baris, di mana <SERVICE>
adalah kunci Layanan AWS pengenal. Layanan AWS Pengenal didasarkan pada model API serviceId
dengan mengganti semua spasi dengan garis bawah dan huruf kecil semua huruf. Untuk daftar semua kunci pengenal layanan yang akan digunakan di services
bagian ini, lihatMenggunakan titik akhir di AWS CLI. Kunci pengenal layanan diikuti oleh pengaturan bersarang dengan masing-masing pada barisnya sendiri dan menjorok oleh dua spasi.
Contoh berikut mengonfigurasi titik akhir yang akan digunakan untuk permintaan yang dibuat ke Amazon DynamoDB layanan di my-services
bagian yang digunakan dalam profil. dev
Baris yang segera mengikuti yang menjorok termasuk dalam ayat itu dan berlaku untuk layanan itu.
[profile
dev
] services =my-services
[servicesmy-services
] dynamodb = endpoint_url =http://localhost:8000
Untuk informasi selengkapnya tentang titik akhir khusus layanan, lihat. Menggunakan titik akhir di AWS CLI
Jika profil Anda memiliki kredenal berbasis peran yang dikonfigurasi melalui source_profile
parameter untuk fungsionalitas peran IAM, SDK hanya menggunakan konfigurasi layanan untuk profil yang ditentukan. Itu tidak menggunakan profil yang dirantai peran untuk itu. Misalnya, menggunakan config
file bersama berikut:
[profile
A
] credential_source =Ec2InstanceMetadata
endpoint_url =https://profile-a-endpoint.aws/
[profileB
] source_profile =A
role_arn =arn:aws:iam::123456789012:role/roleB
services =profileB
[servicesprofileB
] ec2 = endpoint_url =https://profile-b-ec2-endpoint.aws
Jika Anda menggunakan profil B
dan membuat panggilan dalam kode Anda ke Amazon EC2, titik akhir akan diselesaikan sebagai. https://profile-b-ec2-endpoint.aws
Jika kode Anda membuat permintaan ke layanan lain, resolusi titik akhir tidak akan mengikuti logika kustom apa pun. Titik akhir tidak menyelesaikan titik akhir global yang ditentukan dalam profil. A
Agar titik akhir global berlaku untuk profilB
, Anda perlu mengatur endpoint_url
langsung di dalam profilB
.
Di mana pengaturan konfigurasi disimpan?
AWS CLI Menyimpan informasi kredensi sensitif yang Anda tentukan aws
configure
dalam file lokal bernamacredentials
, dalam folder bernama
di direktori home Anda. Opsi konfigurasi yang kurang sensitif yang Anda tentukan .aws
aws configure
disimpan dalam file lokal bernamaconfig
, juga disimpan di
folder di direktori home Anda. .aws
Menyimpan kredensi dalam file konfigurasi
Anda dapat menyimpan semua pengaturan profil Anda dalam satu file karena AWS CLI dapat membaca kredensyal dari file. config
Jika ada kredensyal di kedua file untuk profil yang berbagi nama yang sama, kunci dalam file kredensyal diutamakan. Kami menyarankan untuk menyimpan kredensional dalam file. credentials
File-file ini juga digunakan oleh berbagai kit pengembangan perangkat lunak bahasa (SDKs). Jika Anda menggunakan salah satu SDKs selain itu AWS CLI, konfirmasikan apakah kredensialnya harus disimpan dalam file mereka sendiri.
Di mana Anda menemukan lokasi direktori home Anda bervariasi berdasarkan sistem operasi, tetapi disebut menggunakan variabel lingkungan %UserProfile%
di Windows dan $HOME
atau ~
(tilde) dalam sistem berbasis Unix. Anda dapat menentukan lokasi non-default untuk file dengan mengatur variabel AWS_CONFIG_FILE
dan AWS_SHARED_CREDENTIALS_FILE
lingkungan ke jalur lokal lain. Lihat Mengkonfigurasi variabel lingkungan untuk AWS CLI untuk detail.
Bila Anda menggunakan profil bersama yang menentukan peran AWS Identity and Access Management (IAM), operasi akan AWS CLI memanggil AWS STS AssumeRole
operasi untuk mengambil kredensi sementara. Kredensi ini kemudian disimpan (in
). AWS CLI Perintah selanjutnya menggunakan kredensil sementara yang di-cache sampai kedaluwarsa, dan pada saat itu AWS CLI
secara otomatis menyegarkan kredensialnya.~/.aws/cli/cache
Menggunakan profil bernama
Jika tidak ada profil yang didefinisikan secara eksplisit, default
profil digunakan.
Untuk menggunakan profil bernama, tambahkan --profile
opsi ke perintah Anda. Contoh berikut mencantumkan semua EC2 instans Amazon Anda menggunakan kredensyal dan pengaturan yang ditentukan dalam profil. profile-name
user1
$
aws ec2 describe-instances --profile user1
Untuk menggunakan profil bernama untuk beberapa perintah, Anda dapat menghindari menentukan profil di setiap perintah dengan mengatur variabel AWS_PROFILE
lingkungan sebagai profil default. Anda dapat mengganti pengaturan ini dengan menggunakan --profile
parameter.
Mengatur dan melihat pengaturan konfigurasi menggunakan perintah
Ada beberapa cara untuk melihat dan mengatur pengaturan konfigurasi Anda menggunakan perintah.
aws configure
-
Jalankan perintah ini untuk mengatur dan melihat kredensil, Wilayah, dan format output dengan cepat. Contoh berikut menunjukkan nilai sampel.
$
aws configure
AWS Access Key ID [None]:
AWS Secret Access Key [None]:AKIAIOSFODNN7EXAMPLE
Default region name [None]:wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Default output format [None]:us-west-2
json
aws configure set
-
Anda dapat mengatur kredensi atau pengaturan konfigurasi apa pun menggunakan.
aws configure set
Tentukan profil yang ingin Anda lihat atau modifikasi dengan--profile
pengaturan.Misalnya, perintah berikut menetapkan
region
dalam profil bernamainteg
.$
aws configure set region
us-west-2
--profileinteg
Untuk menghapus pengaturan, hapus pengaturan secara manual di
credentials
file Andaconfig
dan di editor teks. aws configure get
-
Anda dapat mengambil semua kredensi atau pengaturan konfigurasi yang telah Anda tetapkan.
aws configure get
Tentukan profil yang ingin Anda lihat atau modifikasi dengan--profile
pengaturan.Misalnya, perintah berikut mengambil
region
pengaturan di profil bernamainteg
.$
aws configure get
region
--profileinteg
us-west-2
Jika output kosong, pengaturan tidak secara eksplisit diatur dan menggunakan nilai default.
aws configure list
-
Untuk membuat daftar data konfigurasi, gunakan
aws configure list
perintah. Perintah ini mencantumkan profil, kunci akses, kunci rahasia, dan informasi konfigurasi wilayah yang digunakan untuk profil yang ditentukan. Untuk setiap item konfigurasi, ini menunjukkan nilai, di mana nilai konfigurasi diambil, dan nama variabel konfigurasi.Misalnya, jika Anda memberikan variabel Wilayah AWS dalam lingkungan, perintah ini menunjukkan nama wilayah yang telah Anda konfigurasi, bahwa nilai ini berasal dari variabel lingkungan, dan nama variabel lingkungan.
Untuk metode kredensi sementara seperti peran dan Pusat Identitas IAM, perintah ini menampilkan kunci akses cache sementara dan kunci akses rahasia ditampilkan.
$
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
Mengatur konfigurasi baru dan contoh perintah kredensional
Contoh berikut menunjukkan konfigurasi profil default dengan kredensil, wilayah, dan output yang ditentukan untuk metode otentikasi yang berbeda.
Pengaturan config
file yang didukung
Pengaturan berikut didukung dalam config
file. Nilai yang tercantum dalam profil yang ditentukan (atau default) digunakan kecuali jika diganti dengan adanya variabel lingkungan dengan nama yang sama, atau opsi baris perintah dengan nama yang sama. Untuk informasi selengkapnya tentang pengaturan pesanan apa yang didahulukan, lihat Mengkonfigurasi pengaturan untuk AWS CLI
Pengaturan global
api_versions
-
Beberapa AWS layanan mempertahankan beberapa versi API untuk mendukung kompatibilitas mundur. Secara default, AWS CLI perintah menggunakan versi API terbaru yang tersedia. Anda dapat menentukan versi API yang akan digunakan untuk profil dengan menyertakan
api_versions
setelan dalamconfig
file.Ini adalah pengaturan “bersarang” yang diikuti oleh satu atau lebih baris indentasi yang masing-masing mengidentifikasi satu AWS layanan dan versi API yang akan digunakan. Lihat dokumentasi untuk setiap layanan untuk memahami versi API mana yang tersedia.
Contoh berikut menunjukkan cara menentukan versi API untuk dua AWS layanan. Versi API ini hanya digunakan untuk perintah yang berjalan di bawah profil yang berisi pengaturan ini.
api_versions = ec2 = 2015-03-01 cloudfront = 2015-09-017
Pengaturan ini tidak memiliki variabel lingkungan atau parameter baris perintah yang setara.
-
aws_access_key_id
-
Menentukan kunci AWS akses yang digunakan sebagai bagian dari kredensyal untuk mengautentikasi permintaan perintah. Meskipun ini dapat disimpan dalam
config
file, kami sarankan Anda menyimpannya dicredentials
file.Dapat diganti oleh variabel lingkungan.
AWS_ACCESS_KEY_ID
Anda tidak dapat menentukan ID kunci akses sebagai opsi baris perintah.aws_access_key_id =
AKIAIOSFODNN7EXAMPLE
aws_secret_access_key
-
Menentukan kunci AWS rahasia yang digunakan sebagai bagian dari kredensyal untuk mengautentikasi permintaan perintah. Meskipun ini dapat disimpan dalam
config
file, kami sarankan Anda menyimpannya dicredentials
file.Dapat diganti oleh variabel lingkungan.
AWS_SECRET_ACCESS_KEY
Anda tidak dapat menentukan kunci akses rahasia sebagai opsi baris perintah.aws_secret_access_key =
wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token
-
Menentukan token AWS sesi. Token sesi hanya diperlukan jika Anda secara manual menentukan kredensil keamanan sementara. Meskipun ini dapat disimpan dalam
config
file, kami sarankan Anda menyimpannya dicredentials
file.Dapat diganti oleh variabel lingkungan.
AWS_SESSION_TOKEN
Anda tidak dapat menentukan token sesi sebagai opsi baris perintah.aws_session_token =
AQoEXAMPLEH4aoAH0gNCAPyJxz4BlCFFxWNE1OPTgk5TthT+FvwqnKwRcOIfrRh3c/LTo6UDdyJwOOvEVPvLXCrrrUtdnniCEXAMPLE/IvU1dYUg2RVAJBanLiHb4IgRmpRV3zrkuWJOgQs8IZZaIv2BXIa2R4Olgk
ca_bundle
-
Menentukan bundel sertifikat CA (file dengan
.pem
ekstensi) yang digunakan untuk memverifikasi sertifikat SSL.Dapat diganti oleh variabel
AWS_CA_BUNDLE
lingkungan atau opsi--ca-bundle
baris perintah.ca_bundle =
dev/apps/ca-certs/cabundle-2019mar05.pem
cli_follow_urlparam
-
Menentukan apakah AWS CLI upaya untuk mengikuti link URL dalam parameter baris perintah yang dimulai dengan
http://
atauhttps://
. Saat diaktifkan, konten yang diambil digunakan sebagai nilai parameter, bukan URL.-
true - Ini adalah nilai default. Jika ditentukan, parameter string apa pun yang dimulai dengan
http://
atauhttps://
diambil dan konten yang diunduh digunakan sebagai nilai parameter untuk perintah. -
false — Jika ditentukan, AWS CLI tidak memperlakukan nilai string parameter yang dimulai dengan
http://
atauhttps://
berbeda dari string lainnya.
Entri ini tidak memiliki variabel lingkungan yang setara atau opsi baris perintah.
cli_follow_urlparam = false
-
cli_history
-
Dinonaktifkan secara default. Pengaturan ini memungkinkan riwayat perintah untuk file AWS CLI. Setelah mengaktifkan pengaturan ini, AWS CLI catatan sejarah
aws
perintah.cli_history = enabled
Anda dapat membuat daftar riwayat Anda menggunakan
aws history list
perintah, dan menggunakanaws history show
perintah yang dihasilkancommand_ids
untuk detailnya. Untuk informasi lebih lanjut lihataws history
di panduan AWS CLI referensi. cli_timestamp_format
-
Menentukan format nilai timestamp termasuk dalam output. Anda dapat menentukan salah satu dari nilai berikut:
-
iso8601 — Nilai default untuk versi 2. AWS CLI Jika ditentukan, AWS CLI format ulang semua stempel waktu sesuai dengan ISO 8601.
Stempel waktu berformat ISO 8601 terlihat seperti contoh berikut. Contoh pertama menunjukkan waktu dalam Coordinated Universal Time (UTC)
dengan memasukkan Z
setelah waktu. Tanggal dan waktu dipisahkan oleh aT
.2019-10-31T22:21:41Z
Untuk menentukan zona waktu yang berbeda, alih-alih
Z
, tentukan+
atau-
dan jumlah jam zona waktu yang diinginkan berada di depan atau di belakang UTC, sebagai nilai dua digit. Contoh berikut menunjukkan waktu yang sama dengan contoh sebelumnya tetapi disesuaikan dengan waktu Standar Pasifik, yaitu delapan jam di belakang UTC.2019-10-31T14:21:41-08
-
wire - Nilai default untuk AWS CLI versi 1. Jika ditentukan, AWS CLI menampilkan semua nilai stempel waktu persis seperti yang diterima dalam respons kueri HTTP.
Entri ini tidak memiliki variabel lingkungan yang setara atau opsi baris perintah.
cli_timestamp_format = iso8601
-
credential_process
-
Menentukan perintah eksternal yang AWS CLI berjalan untuk menghasilkan atau mengambil kredensyal otentikasi untuk digunakan untuk perintah ini. Perintah harus mengembalikan kredensi dalam format tertentu. Untuk informasi selengkapnya tentang cara menggunakan setelan ini, lihatSumber kredensyal dengan proses eksternal di AWS CLI.
Entri ini tidak memiliki variabel lingkungan yang setara atau opsi baris perintah.
credential_process =
/opt/bin/awscreds-retriever --username susan
credential_source
-
Digunakan dalam EC2 instans Amazon atau container untuk menentukan di mana AWS CLI dapat menemukan kredensional yang akan digunakan untuk mengambil peran yang Anda tentukan dengan parameter.
role_arn
Anda tidak dapat menentukan keduanyasource_profile
dancredential_source
di profil yang sama.Parameter ini dapat memiliki salah satu dari tiga nilai:
-
Lingkungan - Menentukan bahwa AWS CLI adalah untuk mengambil kredensyal sumber dari variabel lingkungan.
-
Ec2 InstanceMetadata - Menentukan bahwa AWS CLI adalah untuk menggunakan peran IAM yang dilampirkan ke profil EC2 instance untuk mendapatkan kredensi sumber.
-
EcsContainer— Menentukan bahwa AWS CLI adalah untuk menggunakan peran IAM yang dilampirkan ke wadah ECS sebagai kredensyal sumber.
credential_source = Ec2InstanceMetadata
-
duration_seconds
-
Menentukan durasi maksimum sesi peran, dalam hitungan detik. Nilai dapat berkisar dari 900 detik (15 menit) hingga pengaturan durasi sesi maksimum untuk peran (yang bisa maksimal 43200). Ini adalah parameter opsional dan secara default, nilainya diatur ke 3600 detik.
endpoint_url
-
Menentukan endpoint yang digunakan untuk semua permintaan layanan. Jika pengaturan ini digunakan di servicesbagian
config
file, maka titik akhir hanya digunakan untuk layanan yang ditentukan.Contoh berikut menggunakan endpoint global
http://localhost:1234
dan endpoint khusus layanan untuk Amazonhttp://localhost:4567
S3.[profile dev] endpoint_url = http://localhost:1234 services = s3-specific [services s3-specific] s3 = endpoint_url = http://localhost:4567
Pengaturan konfigurasi titik akhir terletak di beberapa tempat, seperti variabel sistem atau lingkungan pengguna, file AWS konfigurasi lokal, atau secara eksplisit dideklarasikan pada baris perintah sebagai parameter. Pengaturan konfigurasi AWS CLI titik akhir diutamakan dalam urutan sebagai berikut:
-
Opsi baris
--endpoint-url
perintah. -
Jika diaktifkan, variabel lingkungan endpoint
AWS_IGNORE_CONFIGURED_ENDPOINT_URLS
global atau pengaturan profilignore_configure_endpoint_urls
untuk mengabaikan endpoint kustom. -
Nilai yang diberikan oleh variabel lingkungan khusus layanan
AWS_ENDPOINT_URL_<SERVICE>
, seperti.AWS_ENDPOINT_URL_DYNAMODB
-
Nilai yang disediakan oleh
AWS_USE_DUALSTACK_ENDPOINT
,AWS_USE_FIPS_ENDPOINT
, dan variabelAWS_ENDPOINT_URL
lingkungan. -
Nilai endpoint khusus layanan yang disediakan oleh
endpoint_url
pengaturan dalamservices
bagian file bersama.config
-
Nilai yang diberikan oleh
endpoint_url
pengaturanprofile
dalamconfig
file bersama. -
use_dualstack_endpoint
,use_fips_endpoint
, danendpoint_url
pengaturan. -
URL endpoint default untuk masing-masing Layanan AWS digunakan terakhir. Untuk daftar titik akhir layanan standar yang tersedia di setiap Wilayah, lihat AWS Wilayah dan Titik Akhir di. Referensi Umum Amazon Web Services
-
ignore_configure_endpoint_urls
-
Jika diaktifkan, AWS CLI mengabaikan semua konfigurasi titik akhir kustom yang ditentukan dalam file.
config
Nilai yang valid adalahtrue
danfalse
.ignore_configure_endpoint_urls = true
Pengaturan konfigurasi titik akhir terletak di beberapa tempat, seperti variabel sistem atau lingkungan pengguna, file AWS konfigurasi lokal, atau secara eksplisit dideklarasikan pada baris perintah sebagai parameter. Pengaturan konfigurasi AWS CLI titik akhir diutamakan dalam urutan sebagai berikut:
-
Opsi baris
--endpoint-url
perintah. -
Jika diaktifkan, variabel lingkungan endpoint
AWS_IGNORE_CONFIGURED_ENDPOINT_URLS
global atau pengaturan profilignore_configure_endpoint_urls
untuk mengabaikan endpoint kustom. -
Nilai yang diberikan oleh variabel lingkungan khusus layanan
AWS_ENDPOINT_URL_<SERVICE>
, seperti.AWS_ENDPOINT_URL_DYNAMODB
-
Nilai yang disediakan oleh
AWS_USE_DUALSTACK_ENDPOINT
,AWS_USE_FIPS_ENDPOINT
, dan variabelAWS_ENDPOINT_URL
lingkungan. -
Nilai endpoint khusus layanan yang disediakan oleh
endpoint_url
pengaturan dalamservices
bagian file bersama.config
-
Nilai yang diberikan oleh
endpoint_url
pengaturanprofile
dalamconfig
file bersama. -
use_dualstack_endpoint
,use_fips_endpoint
, danendpoint_url
pengaturan. -
URL endpoint default untuk masing-masing Layanan AWS digunakan terakhir. Untuk daftar titik akhir layanan standar yang tersedia di setiap Wilayah, lihat AWS Wilayah dan Titik Akhir di. Referensi Umum Amazon Web Services
-
external_id
-
Menentukan pengenal unik yang digunakan oleh pihak ketiga untuk mengambil peran dalam akun pelanggan mereka. Ini memetakan ke
ExternalId
parameter dalamAssumeRole
operasi. Parameter ini diperlukan hanya jika kebijakan kepercayaan untuk peran menentukan nilai untukExternalId
. Untuk informasi selengkapnya, lihat Cara menggunakan ID eksternal saat memberikan akses ke AWS sumber daya Anda kepada pihak ketiga dalam Panduan Pengguna IAM. max_attempts
-
Menentukan nilai percobaan ulang maksimum yang digunakan oleh penangan AWS CLI coba lagi, di mana panggilan awal diperhitungkan terhadap nilai yang Anda berikan.
max_attempts
Anda dapat mengganti nilai ini dengan menggunakan variabel
AWS_MAX_ATTEMPTS
lingkungan.max_attempts =
3
mfa_serial
-
Nomor identifikasi perangkat MFA yang akan digunakan saat mengambil peran. Ini wajib hanya jika kebijakan kepercayaan dari peran yang diasumsikan mencakup kondisi yang memerlukan otentikasi MFA. Nilai dapat berupa nomor seri untuk perangkat keras (seperti
GAHT12345678
) atau Amazon Resource Name (ARN) untuk perangkat MFA virtual (seperti).arn:aws:iam::123456789012:mfa/
user
output
-
Menentukan format output default untuk perintah yang diminta menggunakan profil ini. Anda dapat menentukan salah satu nilai berikut:
-
text- Output diformat sebagai beberapa baris nilai string yang dipisahkan tab. Ini dapat berguna untuk meneruskan output ke prosesor teks, seperti
grep
,sed
, atauawk
. -
table— Output diformat sebagai tabel menggunakan karakter +|- untuk membentuk batas sel. Ini biasanya menyajikan informasi dalam format “ramah manusia” yang jauh lebih mudah dibaca daripada yang lain, tetapi tidak berguna secara terprogram.
Dapat diganti oleh variabel
AWS_DEFAULT_OUTPUT
lingkungan atau opsi--output
baris perintah.output =
table
parameter_validation
-
Menentukan apakah AWS CLI klien mencoba untuk memvalidasi parameter sebelum mengirim mereka ke endpoint AWS layanan.
-
true - Ini adalah nilai default. Jika ditentukan, AWS CLI melakukan validasi lokal parameter baris perintah.
-
false — Jika ditentukan, AWS CLI tidak memvalidasi parameter baris perintah sebelum mengirimnya ke titik akhir AWS layanan.
Entri ini tidak memiliki variabel lingkungan yang setara atau opsi baris perintah.
parameter_validation = false
-
region
-
Menentukan Wilayah AWS untuk mengirim permintaan untuk perintah yang diminta menggunakan profil ini.
-
Anda dapat menentukan salah satu kode Wilayah yang tersedia untuk layanan yang dipilih seperti yang tercantum di AWS Wilayah dan Titik Akhir di Referensi Umum Amazon Web Services.
-
aws_global
memungkinkan Anda menentukan titik akhir global untuk layanan yang mendukung titik akhir global selain titik akhir Regional, seperti AWS Security Token Service ()AWS STS dan Amazon Simple Storage Service (Amazon S3).
Anda dapat mengganti nilai ini dengan menggunakan
AWS_DEFAULT_REGION
lingkungan, atau opsi baris--region
perintah.region =
us-west-2
-
request_checksum_calculation
-
Menentukan ketika checksum dihitung untuk payload permintaan, dan memiliki pilihan berikut:
-
when_supported
— (Default) Checksum payload permintaan dihitung ketika operasi menentukan algoritma checksum dalam model layanannya atau memerlukan checksum permintaan. -
when_required
— Checksum payload permintaan dihitung ketika operasi memerlukan checksum permintaan atau ketika pengguna menyediakan yang dimodelkanrequestAlgorithmMember
oleh. Layanan AWS
request_checksum_calculation =
when_supported
Variabel lingkungan AWS_REQUEST_CHECKSUM_CALCULATIONmengesampingkan pengaturan ini.
-
response_checksum_validation
-
Menentukan kapan validasi checksum dilakukan untuk payload respon, dan memiliki pilihan berikut:
-
when_supported
— (Default) Validasi checksum payload respons dilakukan ketika operasi menentukan algoritma respons dalam model layanannya yang mendukung. AWS CLI -
when_required
— Validasi checksum payload respons dilakukan ketika operasi menentukan algoritma respons dalam model layanannya yang AWS CLI mendukung, dan Anda mengatur modelrequestValidationModeMember
keENABLED
dalam input operasi.
response_checksum_validation =
when_supported
Variabel lingkungan AWS_RESPONSE_CHECKSUM_VALIDATIONmengesampingkan pengaturan ini.
-
retry_mode
-
Menentukan modus AWS CLI coba lagi yang menggunakan. Ada tiga mode coba lagi yang tersedia: legacy (default), standar, dan adaptif. Untuk informasi lebih lanjut tentang pencobaan ulang, lihat AWS CLI mencoba lagi di AWS CLI.
Anda dapat mengganti nilai ini dengan menggunakan variabel
AWS_RETRY_MODE
lingkungan.retry_mode =
standard
role_arn
-
Menentukan Amazon Resource Name (ARN) dari peran IAM yang ingin Anda gunakan untuk menjalankan perintah. AWS CLI Anda juga harus menentukan salah satu parameter berikut untuk mengidentifikasi kredensyal yang memiliki izin untuk mengambil peran ini:
-
source_profile
-
credential_source
role_arn = arn:aws:iam::
123456789012
:role/role-name
Variabel lingkungan AWS_ROLE_ARNmengesampingkan pengaturan ini.
Untuk informasi selengkapnya tentang penggunaan identitas web, lihatAsumsikan peran dengan identitas web.
-
role_session_name
-
Menentukan nama untuk melampirkan ke sesi peran. Nilai ini disediakan untuk
RoleSessionName
parameter ketika AWS CLI panggilanAssumeRole
operasi, dan menjadi bagian dari peran yang diasumsikan pengguna ARN:.arn:aws:sts::
Ini adalah parameter opsional. Jika Anda tidak memberikan nilai ini, nama sesi dibuat secara otomatis. Nama ini muncul di AWS CloudTrail log untuk entri yang terkait dengan sesi ini.123456789012
:assumed-role/role_name
/role_session_name
role_session_name =
maria_garcia_role
Variabel lingkungan AWS_ROLE_SESSION_NAMEmengesampingkan pengaturan ini.
Untuk informasi selengkapnya tentang penggunaan identitas web, lihatAsumsikan peran dengan identitas web.
services
-
Menentukan konfigurasi layanan yang akan digunakan untuk profil Anda.
[profile
dev-s3-specific-and-global
] endpoint_url =http://localhost:1234
services =s3-specific
[servicess3-specific
] s3 = endpoint_url =http://localhost:4567
Untuk informasi lebih lanjut tentang
services
bagian ini, lihatJenis bagian: services.Variabel lingkungan AWS_ROLE_SESSION_NAMEmengesampingkan pengaturan ini.
Untuk informasi selengkapnya tentang penggunaan identitas web, lihatAsumsikan peran dengan identitas web.
sdk_ua_app_id
-
Satu Akun AWS dapat digunakan oleh beberapa aplikasi pelanggan untuk melakukan panggilan ke Layanan AWS. ID Aplikasi mengidentifikasi aplikasi sumber mana yang membuat serangkaian panggilan menggunakan file Layanan AWS. AWS SDKs dan layanan tidak menggunakan atau menafsirkan nilai ini selain untuk memunculkannya kembali dalam komunikasi pelanggan. Misalnya, nilai ini dapat dimasukkan dalam email operasional untuk mengidentifikasi secara unik aplikasi mana yang terkait dengan notifikasi.
ID Aplikasi adalah string dengan panjang maksimum 50 karakter. Huruf, angka, dan karakter khusus berikut diperbolehkan: Secara
! $ % & * + - . , ^ _ ` | ~
default, tidak ada nilai yang ditetapkan.sdk_ua_app_id =
prod1
Pengaturan ini dapat ditimpa dengan menggunakan variabel AWS_SDK_UA_APP_IDlingkungan. Anda tidak dapat mengatur nilai ini sebagai parameter baris perintah.
sigv4a_signing_region_set
-
Menentukan wilayah yang akan digunakan saat menandatangani dengan Sigv4a menggunakan daftar yang dibatasi koma. Jika variabel ini tidak diatur, AWS CLI menggunakan default yang digunakan oleh Layanan AWS. Jika tidak Layanan AWS memiliki default, tanda tangan permintaan menjadi valid di semua wilayah menggunakan nilai
*
.sigv4a_signing_region_set =
us-west-2, us-east-1
Untuk informasi selengkapnya tentang Sigv4a, lihat Sigv4a Versi AWS Tanda Tangan 4 untuk permintaan API di Panduan Pengguna IAM
Pengaturan ini dapat ditimpa dengan menggunakan variabel AWS_SIGV4A_SIGNING_REGION_SETlingkungan. Anda tidak dapat mengatur nilai ini sebagai parameter baris perintah.
source_profile
-
Menentukan profil bernama dengan kredensil jangka panjang yang AWS CLI dapat digunakan untuk mengambil peran yang Anda tentukan dengan parameter.
role_arn
Anda tidak dapat menentukan keduanyasource_profile
dancredential_source
di profil yang sama.source_profile =
production-profile
sts_regional_endpoints
-
Menentukan bagaimana AWS CLI menentukan endpoint AWS layanan yang digunakan AWS CLI klien untuk berbicara dengan AWS Security Token Service ()AWS STS. Nilai default untuk AWS CLI versi 1 adalah
legacy
.Anda dapat menentukan salah satu dari dua nilai:
-
legacy
— Menggunakan titik akhir STS global,sts.amazonaws.com
, untuk AWS Wilayah berikut:ap-northeast-1
,,,ap-south-1
,ap-southeast-1
,ap-southeast-2
,aws-global
,ca-central-1
,eu-central-1
,eu-north-1
,eu-west-1
,eu-west-2
,eu-west-3
,sa-east-1
,us-east-1
,us-east-2
us-west-1
, danus-west-2
. Semua Wilayah lainnya secara otomatis menggunakan titik akhir Regional masing-masing. -
regional
— AWS CLI Selalu menggunakan AWS STS titik akhir untuk Wilayah yang saat ini dikonfigurasi. Misalnya, jika klien dikonfigurasi untuk digunakanus-west-2
, semua panggilan ke AWS STS dilakukan ke titik akhir Regional,sts.us-west-2.amazonaws.com
bukan titiksts.amazonaws.com
akhir global. Untuk mengirim permintaan ke titik akhir global saat pengaturan ini diaktifkan, Anda dapat menyetel Wilayah keaws-global
.
Pengaturan ini dapat ditimpa dengan menggunakan variabel
AWS_STS_REGIONAL_ENDPOINTS
lingkungan. Anda tidak dapat mengatur nilai ini sebagai parameter baris perintah. -
use_dualstack_endpoint
-
Mengaktifkan penggunaan titik akhir dual-stack untuk mengirim permintaan. AWS Untuk mempelajari lebih lanjut tentang titik akhir dual-stack, yang mendukung keduanya IPv4 dan IPv6 lalu lintas, lihat Menggunakan titik akhir tumpukan ganda Amazon S3 di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon. Titik akhir dual-stack tersedia untuk beberapa layanan di beberapa wilayah. Jika titik akhir tumpukan ganda tidak ada untuk layanan atau Wilayah AWS, permintaan gagal. Ini dinonaktifkan secara default.
Ini saling eksklusif dengan
use_accelerate_endpoint
pengaturan.Pengaturan konfigurasi titik akhir terletak di beberapa tempat, seperti variabel sistem atau lingkungan pengguna, file AWS konfigurasi lokal, atau secara eksplisit dideklarasikan pada baris perintah sebagai parameter. Pengaturan konfigurasi AWS CLI titik akhir diutamakan dalam urutan sebagai berikut:
-
Opsi baris
--endpoint-url
perintah. -
Jika diaktifkan, variabel lingkungan endpoint
AWS_IGNORE_CONFIGURED_ENDPOINT_URLS
global atau pengaturan profilignore_configure_endpoint_urls
untuk mengabaikan endpoint kustom. -
Nilai yang diberikan oleh variabel lingkungan khusus layanan
AWS_ENDPOINT_URL_<SERVICE>
, seperti.AWS_ENDPOINT_URL_DYNAMODB
-
Nilai yang disediakan oleh
AWS_USE_DUALSTACK_ENDPOINT
,AWS_USE_FIPS_ENDPOINT
, dan variabelAWS_ENDPOINT_URL
lingkungan. -
Nilai endpoint khusus layanan yang disediakan oleh
endpoint_url
pengaturan dalamservices
bagian file bersama.config
-
Nilai yang diberikan oleh
endpoint_url
pengaturanprofile
dalamconfig
file bersama. -
use_dualstack_endpoint
,use_fips_endpoint
, danendpoint_url
pengaturan. -
URL endpoint default untuk masing-masing Layanan AWS digunakan terakhir. Untuk daftar titik akhir layanan standar yang tersedia di setiap Wilayah, lihat AWS Wilayah dan Titik Akhir di. Referensi Umum Amazon Web Services
-
use_fips_endpoint
-
Beberapa AWS layanan menawarkan titik akhir yang mendukung Federal Information Processing Standard (FIPS) 140-2
di beberapa. Wilayah AWS Ketika AWS layanan mendukung FIPS, pengaturan ini menentukan titik akhir FIPS apa yang harus digunakan. AWS CLI Tidak seperti AWS endpoint standar, endpoint FIPS menggunakan pustaka perangkat lunak TLS yang sesuai dengan FIPS 140-2. Titik akhir ini mungkin diperlukan oleh korporasi yang berinteraksi dengan pemerintah Amerika Serikat. Jika pengaturan ini diaktifkan, tetapi titik akhir FIPS tidak ada untuk layanan di Anda Wilayah AWS, AWS perintah mungkin gagal. Dalam hal ini, tentukan secara manual titik akhir yang akan digunakan dalam perintah menggunakan
--endpoint-url
opsi atau gunakan titik akhir khusus layanan.Untuk informasi selengkapnya tentang menentukan titik akhir FIPS menurut Wilayah AWS, lihat Titik Akhir FIPS
menurut Layanan. Pengaturan konfigurasi titik akhir terletak di beberapa tempat, seperti variabel sistem atau lingkungan pengguna, file AWS konfigurasi lokal, atau secara eksplisit dideklarasikan pada baris perintah sebagai parameter. Pengaturan konfigurasi AWS CLI titik akhir diutamakan dalam urutan sebagai berikut:
-
Opsi baris
--endpoint-url
perintah. -
Jika diaktifkan, variabel lingkungan endpoint
AWS_IGNORE_CONFIGURED_ENDPOINT_URLS
global atau pengaturan profilignore_configure_endpoint_urls
untuk mengabaikan endpoint kustom. -
Nilai yang diberikan oleh variabel lingkungan khusus layanan
AWS_ENDPOINT_URL_<SERVICE>
, seperti.AWS_ENDPOINT_URL_DYNAMODB
-
Nilai yang disediakan oleh
AWS_USE_DUALSTACK_ENDPOINT
,AWS_USE_FIPS_ENDPOINT
, dan variabelAWS_ENDPOINT_URL
lingkungan. -
Nilai endpoint khusus layanan yang disediakan oleh
endpoint_url
pengaturan dalamservices
bagian file bersama.config
-
Nilai yang diberikan oleh
endpoint_url
pengaturanprofile
dalamconfig
file bersama. -
use_dualstack_endpoint
,use_fips_endpoint
, danendpoint_url
pengaturan. -
URL endpoint default untuk masing-masing Layanan AWS digunakan terakhir. Untuk daftar titik akhir layanan standar yang tersedia di setiap Wilayah, lihat AWS Wilayah dan Titik Akhir di. Referensi Umum Amazon Web Services
-
web_identity_token_file
-
Menentukan path ke file yang berisi token akses OAuth 2.0 atau token OpenID Connect ID yang disediakan oleh penyedia identitas. AWS CLI Memuat isi file ini dan meneruskannya sebagai
WebIdentityToken
argumen untukAssumeRoleWithWebIdentity
operasi.Variabel lingkungan
AWS_WEB_IDENTITY_TOKEN_FILE
mengesampingkan pengaturan ini.Untuk informasi selengkapnya tentang penggunaan identitas web, lihatAsumsikan peran dengan identitas web.
tcp_keepalive
-
Menentukan apakah AWS CLI klien menggunakan paket TCP keep-alive.
Entri ini tidak memiliki variabel lingkungan yang setara atau opsi baris perintah.
tcp_keepalive = false
Pengaturan perintah kustom S3
Amazon S3 mendukung beberapa pengaturan yang mengonfigurasi cara AWS CLI menjalankan operasi Amazon S3. Beberapa berlaku untuk semua perintah S3 di kedua s3api
dan ruang s3
nama. Lainnya khusus untuk perintah “kustom” S3 yang mengabstraksikan operasi umum dan melakukan lebih dari sekadar one-to-one pemetaan ke operasi API. Perintah aws s3
transfercp
,, sync
mv
, dan rm
memiliki pengaturan tambahan yang dapat Anda gunakan untuk mengontrol transfer S3.
Semua opsi ini dapat dikonfigurasi dengan menentukan pengaturan s3
bersarang di file Andaconfig
. Setiap pengaturan kemudian menjorok pada garisnya sendiri.
catatan
Pengaturan ini sepenuhnya opsional. Anda harus dapat berhasil menggunakan perintah aws s3
transfer tanpa mengonfigurasi pengaturan ini. Pengaturan ini disediakan untuk memungkinkan Anda menyetel kinerja atau memperhitungkan lingkungan tertentu tempat Anda menjalankan aws
s3
perintah ini.
Pengaturan ini semua diatur di bawah s3
kunci tingkat atas dalam config
file, seperti yang ditunjukkan pada contoh berikut untuk development
profil.
[profile development] s3 = max_concurrent_requests = 20 max_queue_size = 10000 multipart_threshold = 64MB multipart_chunksize = 16MB max_bandwidth = 50MB/s use_accelerate_endpoint = true addressing_style = path
Pengaturan berikut berlaku untuk perintah S3 apa pun di ruang s3api
nama s3
atau.
addressing_style
-
Menentukan gaya pengalamatan yang akan digunakan. Ini mengontrol apakah nama bucket ada di nama host atau merupakan bagian dari URL. Nilai yang valid adalah:
path
,virtual
, danauto
. Nilai default-nya adalahauto
.Ada dua gaya membangun endpoint Amazon S3. Yang pertama dipanggil
virtual
dan menyertakan nama bucket sebagai bagian dari nama host. Sebagai contoh:https://
. Atau, denganbucketname
.s3.amazonaws.com.rproxy.goskope.compath
gaya, Anda memperlakukan nama bucket seolah-olah itu adalah jalur di URI; misalnya,https://s3.amazonaws.com/
. Nilai default dalam CLI adalah untuk menggunakanbucketname
auto
, yang mencoba menggunakanvirtual
gaya di mana ia bisa, tetapi akan kembali kepath
gaya bila diperlukan. Misalnya, jika nama bucket Anda tidak kompatibel dengan DNS, nama bucket tidak dapat menjadi bagian dari nama host dan harus berada di jalur. Denganauto
, CLI akan mendeteksi kondisi ini dan secara otomatis beralih kepath
gaya untuk Anda. Jika Anda menyetel gaya pengalamatanpath
, Anda harus memastikan bahwa AWS Wilayah yang Anda konfigurasikan AWS CLI cocok dengan Wilayah bucket Anda. payload_signing_enabled
-
Menentukan apakah akan SHA256 menandatangani muatan sigv4. Secara default, ini dinonaktifkan untuk streaming upload (
UploadPart
danPutObject
) saat menggunakan HTTPS. Secara default, ini diatur kefalse
untuk streaming upload (UploadPart
danPutObject
), tetapi hanya jikaContentMD5
ada (dihasilkan secara default) dan titik akhir menggunakan HTTPS.Jika disetel ke true, permintaan S3 menerima validasi konten tambahan dalam bentuk SHA256 checksum yang dihitung untuk Anda dan disertakan dalam tanda tangan permintaan. Jika disetel ke false, checksum tidak dihitung. Menonaktifkan ini dapat berguna untuk mengurangi overhead kinerja yang dibuat oleh perhitungan checksum.
use_accelerate_endpoint
-
Gunakan titik akhir Amazon S3 Accelerate untuk semua
s3
dan perintah.s3api
Nilai default adalah false. Ini saling eksklusif denganuse_dualstack_endpoint
pengaturan.Jika disetel ke true, akan AWS CLI mengarahkan semua permintaan Amazon S3 ke titik akhir
S3 Accelerate
di.s3-accelerate.amazonaws.com
Untuk menggunakan endpoint ini, Anda harus mengaktifkan bucket untuk digunakanS3 Accelerate
. Semua permintaan dikirim menggunakan gaya virtual pengalamatan bucket:
.my-bucket
.s3-accelerate.amazonaws.com.rproxy.goskope.comDeleteBucket
Permintaan apa punListBuckets
CreateBucket
,, dan tidak dikirim ke titik akhir S3 Accelerate karena titik akhir tersebut tidak mendukung operasi tersebut. Perilaku ini juga dapat diatur jika--endpoint-url
parameter diatur kehttps://s3-accelerate.amazonaws.com
atauhttp://s3-accelerate.amazonaws.com
untuk setiaps3
ataus3api
perintah.
Pengaturan berikut hanya berlaku untuk perintah di set perintah s3
namespace.
max_bandwidth
-
Menentukan bandwidth maksimum yang dapat dikonsumsi untuk mengunggah dan mengunduh data ke dan dari Amazon S3. Defaultnya tidak ada batas.
Ini membatasi bandwidth maksimum yang dapat digunakan perintah S3 untuk mentransfer data ke dan dari Amazon S3. Nilai ini hanya berlaku untuk unggahan dan unduhan; itu tidak berlaku untuk salinan atau penghapusan. Nilai dinyatakan sebagai byte per detik. Nilai dapat ditentukan sebagai:
-
Sebuah bilangan bulat. Misalnya,
1048576
menetapkan penggunaan bandwidth maksimum menjadi 1 megabyte per detik. -
Sebuah integer diikuti oleh sufiks tingkat. Anda dapat menentukan sufiks tingkat menggunakan:
KB/s
,MB/s
, atau.GB/s
Misalnya,300KB/s
,10MB/s
.
Secara umum, kami menyarankan Anda terlebih dahulu mencoba menurunkan konsumsi bandwidth dengan menurunkan
max_concurrent_requests
. Jika itu tidak cukup membatasi konsumsi bandwidth ke tingkat yang diinginkan, Anda dapat menggunakanmax_bandwidth
pengaturan untuk membatasi konsumsi bandwidth lebih lanjut. Ini karenamax_concurrent_requests
mengontrol berapa banyak utas yang sedang berjalan. Jika Anda lebih dulu menurunkanmax_bandwidth
tetapi meninggalkanmax_concurrent_requests
pengaturan tinggi, itu dapat mengakibatkan utas harus menunggu yang tidak perlu. Hal ini dapat menyebabkan konsumsi sumber daya berlebih dan batas waktu koneksi. -
max_concurrent_requests
-
Menentukan jumlah maksimum permintaan bersamaan. Nilai default adalah 10.
Perintah
aws s3
transfer multithreaded. Pada waktu tertentu, beberapa permintaan Amazon S3 dapat berjalan. Misalnya, ketika Anda menggunakan perintahaws s3 cp localdir s3://bucket/ --recursive
untuk mengunggah file ke bucket S3, AWS CLI dapat mengunggah filelocaldir/file1
,localdir/file2
, danlocaldir/file3
secara paralel. Pengaturanmax_concurrent_requests
menentukan jumlah maksimum operasi transfer yang dapat berjalan pada saat yang sama.Anda mungkin perlu mengubah nilai ini karena beberapa alasan:
-
Mengurangi nilai ini — Pada beberapa lingkungan, default dari 10 permintaan bersamaan dapat membanjiri sistem. Ini dapat menyebabkan batas waktu koneksi atau memperlambat respons sistem. Menurunkan nilai ini membuat perintah transfer S3 kurang intensif sumber daya. Tradeoff adalah bahwa transfer S3 bisa memakan waktu lebih lama untuk diselesaikan. Menurunkan nilai ini mungkin diperlukan jika Anda menggunakan alat untuk membatasi bandwidth.
-
Meningkatkan nilai ini — Dalam beberapa skenario, Anda mungkin ingin transfer Amazon S3 selesai secepat mungkin, menggunakan bandwidth jaringan sebanyak yang diperlukan. Dalam skenario ini, jumlah default permintaan bersamaan mungkin tidak cukup untuk menggunakan semua bandwidth jaringan yang tersedia. Meningkatkan nilai ini dapat meningkatkan waktu yang diperlukan untuk menyelesaikan transfer Amazon S3.
-
max_queue_size
-
Menentukan jumlah maksimum tugas dalam antrian tugas. Nilai default adalah 1000.
AWS CLI Secara internal menggunakan model di mana ia mengantri tugas Amazon S3 yang kemudian dijalankan oleh konsumen yang jumlahnya dibatasi oleh.
max_concurrent_requests
Sebuah tugas umumnya memetakan ke satu operasi Amazon S3. Misalnya, tugas bisa berupaPutObjectTask
, atau aGetObjectTask
, atauUploadPartTask
. Tingkat di mana tugas ditambahkan ke antrian bisa jauh lebih cepat daripada tingkat di mana konsumen menyelesaikan tugas. Untuk menghindari pertumbuhan tak terbatas, ukuran antrian tugas dibatasi ke ukuran tertentu. Pengaturan ini mengubah nilai angka maksimum itu.Anda biasanya tidak perlu mengubah pengaturan ini. Pengaturan ini juga sesuai dengan jumlah tugas yang AWS CLI disadari perlu dijalankan. Ini berarti bahwa secara default hanya AWS CLI dapat melihat 1000 tugas di depan. Meningkatkan nilai ini berarti bahwa AWS CLI dapat lebih cepat mengetahui jumlah total tugas yang dibutuhkan, dengan asumsi bahwa tingkat antrian lebih cepat daripada tingkat penyelesaian tugas. Penggantiannya adalah max_queue_size yang lebih besar membutuhkan lebih banyak memori.
multipart_chunksize
-
Menentukan ukuran potongan yang AWS CLI digunakan untuk transfer multipart file individual. Nilai default adalah 8 MB, dengan minimal 5 MB.
Ketika transfer file melebihi
multipart_threshold
, AWS CLI membagi file menjadi potongan-potongan ukuran ini. Nilai ini dapat ditentukan menggunakan sintaks yang sama sepertimultipart_threshold
, baik sebagai jumlah byte sebagai integer, atau dengan menggunakan ukuran dan akhiran. multipart_threshold
-
Menentukan ambang batas ukuran AWS CLI penggunaan untuk transfer multipart file individual. Nilai defaultnya adalah 8 MB.
Saat mengunggah, mengunduh, atau menyalin file, perintah Amazon S3 beralih ke operasi multibagian jika file melebihi ukuran ini. Anda dapat menentukan nilai ini dengan salah satu dari dua cara:
-
Ukuran file dalam byte. Misalnya,
1048576
. -
Ukuran file dengan akhiran ukuran. Anda dapat menggunakan
KB
,MB
,GB
, atauTB
. Misalnya:10MB
,1GB
.catatan
S3 dapat memaksakan kendala pada nilai valid yang dapat digunakan untuk operasi multipart. Untuk informasi selengkapnya, lihat dokumentasi Unggahan Multipart S3 di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.
-