aws cli
1.0.0
แพ็คเกจนี้มอบอินเทอร์เฟซบรรทัดคำสั่งแบบรวมให้กับ Amazon Web Services
ข้ามไปที่:
README นี้มีไว้สำหรับ AWS CLI เวอร์ชัน 1 หากคุณกำลังมองหาข้อมูลเกี่ยวกับ AWS CLI เวอร์ชัน 2 โปรดไปที่สาขา v2
แพ็คเกจ aws-cli ใช้งานได้กับเวอร์ชัน Python:
ในวันที่ 30-05-2022 การรองรับ Python 3.6 สิ้นสุดลงแล้ว สิ่งนี้เกิดขึ้นหลังจากการสิ้นสุดการสนับสนุน Python Software Foundation สำหรับรันไทม์ซึ่งเกิดขึ้นในวันที่ 23-12-2021
ในวันที่ 13-12-2566 การรองรับ Python 3.7 สิ้นสุดลงแล้ว สิ่งนี้เกิดขึ้นหลังจากการสิ้นสุดการสนับสนุน Python Software Foundation สำหรับรันไทม์ซึ่งเกิดขึ้นในวันที่ 27-06-2023 สำหรับข้อมูลเพิ่มเติม โปรดดูโพสต์บนบล็อกนี้
ความสนใจ!
เราขอแนะนำให้ลูกค้าทุกคนตรวจสอบเว็บไซต์ Amazon Web Services Security Bulletins เป็นประจำ เพื่อหากระดานข่าวความปลอดภัยที่สำคัญที่เกี่ยวข้องกับ aws-cli
AWS CLI เวอร์ชัน 1 เปิดให้ใช้งานทั่วไปในวันที่ 09/02/2013 และขณะนี้อยู่ในระยะการสนับสนุนเต็มรูปแบบของวงจรความพร้อมใช้งาน
สำหรับข้อมูลเกี่ยวกับการบำรุงรักษาและการสนับสนุนสำหรับ SDK เวอร์ชันหลักและการพึ่งพาที่เกี่ยวข้อง โปรดดูส่วนนโยบายการบำรุงรักษาใน AWS SDK และเครื่องมือ คู่มือการอ้างอิงการกำหนดค่าและข้อมูลรับรองที่ใช้ร่วมกัน
การติดตั้ง AWS CLI และการขึ้นต่อกันใช้คุณสมบัติแพ็คเกจต่างๆ ที่มอบให้โดย pip และ setuptools เพื่อให้การติดตั้งราบรื่น ขอแนะนำให้ใช้:
pip : 9.0.2 หรือสูงกว่าsetuptools : 36.2.0 หรือสูงกว่า วิธีที่ปลอดภัยที่สุดในการติดตั้ง AWS CLI คือการใช้ pip ใน virtualenv :
$ python -m pip ติดตั้ง awscli
หรือหากคุณไม่ได้ติดตั้งใน virtualenv ให้ติดตั้งแบบโกลบอล:
$ sudo python -m pip ติดตั้ง awscli
หรือสำหรับผู้ใช้ของคุณ:
$ python -m pip install --user awscli
หากคุณติดตั้งแพ็คเกจ aws-cli และต้องการอัปเกรดเป็นเวอร์ชันล่าสุด คุณสามารถเรียกใช้:
$ python -m pip install --upgrade awscli
สิ่งนี้จะติดตั้งแพ็คเกจ aws-cli รวมถึงการอ้างอิงทั้งหมด
บันทึก
บน macOS หากคุณเห็นข้อผิดพลาดเกี่ยวกับเวอร์ชัน six ที่มาพร้อมกับ distutils ใน El Capitan ให้ใช้ตัวเลือก --ignore-installed :
$ sudo python -m pip ติดตั้ง awscli --ละเว้นการติดตั้งหก
บน Linux และ Mac OS สามารถติดตั้ง AWS CLI ได้โดยใช้ตัวติดตั้งแบบรวม AWS CLI ยังสามารถติดตั้งบน Windows ผ่านทาง MSI Installer ได้อีกด้วย
หากคุณต้องการรันสาขา develop ของ AWS CLI โปรดดูส่วนเวอร์ชันการพัฒนาของคู่มือสนับสนุน
ดูส่วนการติดตั้งของคู่มือผู้ใช้ AWS CLI สำหรับข้อมูลเพิ่มเติม
ก่อนที่จะใช้ AWS CLI คุณต้องกำหนดค่าข้อมูลประจำตัว AWS ของคุณ คุณสามารถทำได้หลายวิธี:
วิธีเริ่มต้นที่เร็วที่สุดคือการรันคำสั่ง aws configure :
$ aws กำหนดค่า รหัสคีย์การเข้าถึง AWS: MYACCESSKEY รหัสการเข้าถึงความลับของ AWS: MYSECRETKEY ชื่อภูมิภาคเริ่มต้น [us-west-2]: us-west-2 รูปแบบเอาต์พุตเริ่มต้น [ไม่มี]: json
หากต้องการใช้ตัวแปรสภาพแวดล้อม ให้ทำดังต่อไปนี้:
$ ส่งออก AWS_ACCESS_KEY_ID=$ ส่งออก AWS_SECRET_ACCESS_KEY=
หากต้องการใช้ไฟล์ข้อมูลประจำตัวที่แชร์ ให้สร้างไฟล์ที่จัดรูปแบบ INI ดังนี้:
[ค่าเริ่มต้น] aws_access_key_id=MYACCESSKEY aws_secret_access_key=MYSECRETKEY [ทดสอบ] aws_access_key_id=MYACCESSKEY aws_secret_access_key=MYSECRETKEY
และวางไว้ใน ~/.aws/credentials (หรือใน %UserProfile%.aws/credentials บน Windows) หากคุณต้องการวางไฟล์ข้อมูลรับรองที่ใช้ร่วมกันในตำแหน่งอื่นนอกเหนือจากที่ระบุไว้ข้างต้น คุณต้องบอก aws-cli ว่าจะค้นหาไฟล์ได้ที่ไหน ทำได้โดยการตั้งค่าตัวแปรสภาพแวดล้อมที่เหมาะสม:
$ ส่งออก AWS_SHARED_CREDENTIALS_FILE=/path/to/shared_credentials_file
หากต้องการใช้ไฟล์กำหนดค่า ให้สร้างไฟล์ที่จัดรูปแบบ INI ดังนี้
[ค่าเริ่มต้น] aws_access_key_id=<คีย์การเข้าถึงเริ่มต้น> aws_secret_access_key=<คีย์ลับเริ่มต้น> # ทางเลือก เพื่อกำหนดภูมิภาคเริ่มต้นสำหรับโปรไฟล์นี้ ภูมิภาค=us-ตะวันตก-1 [การทดสอบโปรไฟล์] aws_access_key_id=<กำลังทดสอบคีย์การเข้าถึง> aws_secret_access_key=<กำลังทดสอบคีย์ลับ> ภูมิภาค=us-ตะวันตก-2
และวางไว้ใน ~/.aws/config (หรือใน %UserProfile%.awsconfig บน Windows) หากคุณต้องการวางไฟล์กำหนดค่าในตำแหน่งอื่นนอกเหนือจากที่ระบุไว้ข้างต้น คุณต้องแจ้ง AWS CLI ว่าจะค้นหาไฟล์ได้ที่ไหน ทำได้โดยการตั้งค่าตัวแปรสภาพแวดล้อมที่เหมาะสม:
$ ส่งออก AWS_CONFIG_FILE=/path/to/config_file
อย่างที่คุณเห็น คุณสามารถกำหนดได้หลาย profiles ทั้งในไฟล์ข้อมูลรับรองที่ใช้ร่วมกันและไฟล์การกำหนดค่า จากนั้นคุณสามารถระบุโปรไฟล์ที่จะใช้ได้โดยใช้ตัวเลือก --profile หากไม่มีการระบุโปรไฟล์ ระบบจะใช้โปรไฟล์ default
ในไฟล์กำหนดค่า ยกเว้นโปรไฟล์เริ่มต้น คุณ ต้อง ใส่โปรไฟล์นำหน้าส่วนการกำหนดค่าแต่ละส่วนของกลุ่มโปรไฟล์ด้วย profile ตัวอย่างเช่น หากคุณมีโปรไฟล์ชื่อ "การทดสอบ" ส่วนหัวของส่วนจะเป็น [profile testing]
ขอแนะนำตัวเลือกสุดท้ายสำหรับข้อมูลประจำตัวหากคุณใช้ AWS CLI บนอินสแตนซ์ EC2 บทบาท IAM เป็นวิธีที่ยอดเยี่ยมในการติดตั้งข้อมูลรับรองบนอินสแตนซ์ของคุณโดยอัตโนมัติ หากคุณใช้บทบาท IAM AWS CLI จะค้นหาและใช้งานโดยอัตโนมัติ
นอกเหนือจากข้อมูลรับรองแล้ว ตัวแปรอื่นๆ อีกจำนวนหนึ่งสามารถกำหนดค่าด้วยตัวแปรสภาพแวดล้อม รายการไฟล์การกำหนดค่า หรือทั้งสองอย่าง ดูคู่มือการอ้างอิงการกำหนดค่าและข้อมูลรับรองที่ใช้ร่วมกันของเครื่องมือ AWS และ SDK สำหรับข้อมูลเพิ่มเติม
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับตัวเลือกการกำหนดค่า โปรดดูหัวข้อตัวแปรการกำหนดค่า AWS CLI คุณสามารถเข้าถึงหัวข้อนี้ได้จาก AWS CLI เช่นกันโดยการเรียกใช้ aws help config-vars
คำสั่ง AWS CLI มีโครงสร้างดังต่อไปนี้:
$ aws <คำสั่ง> <คำสั่งย่อย> [ตัวเลือกและพารามิเตอร์]
ตัวอย่างเช่น หากต้องการแสดงรายการบัคเก็ต S3 คำสั่งจะเป็น:
$aws s3 ls
หากต้องการดูเอกสารวิธีใช้ ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้:
$aws ช่วยด้วย $ aws <คำสั่ง> ช่วยด้วย $ aws <คำสั่ง> <คำสั่งย่อย> ช่วยด้วย
หากต้องการรับเวอร์ชันของ AWS CLI:
$ aws --version
หากต้องการเปิดเอาต์พุตการดีบัก:
$ aws --debug <คำสั่ง> <คำสั่งย่อย>
คุณสามารถอ่านข้อมูลเพิ่มเติมเกี่ยวกับบทการใช้ AWS CLI ของคู่มือผู้ใช้ AWS CLI
แพ็คเกจ aws-cli มีฟีเจอร์การเติมคำสั่งให้สมบูรณ์สำหรับระบบที่คล้าย Unix คุณลักษณะนี้ไม่ได้ติดตั้งโดยอัตโนมัติ ดังนั้นคุณต้องกำหนดค่าด้วยตนเอง หากต้องการเรียนรู้เพิ่มเติม โปรดอ่านหัวข้อการเสร็จสิ้นคำสั่ง AWS CLI
วิธีที่ดีที่สุดในการโต้ตอบกับทีมของเราคือผ่าน GitHub คุณสามารถเปิดปัญหาและเลือกจากหนึ่งในเทมเพลตของเราสำหรับคำแนะนำ รายงานข้อบกพร่อง หรือคำขอคุณสมบัติ
คุณอาจพบความช่วยเหลือจากชุมชนบน Stack Overflow ด้วยแท็ก aws-cli หรือใน AWS Discussion Forum for CLI หากคุณมีแผนการสนับสนุนกับ AWS Support คุณสามารถสร้างกรณีการสนับสนุนใหม่ได้
โปรดตรวจสอบปัญหาการเปิดที่คล้ายกันก่อนที่จะเปิดอีกอันหนึ่ง
AWS CLI ใช้ API บริการของ AWS สำหรับปัญหาทั่วไปเกี่ยวกับบริการหรือข้อจำกัด คุณอาจพบว่าฟอรัมสนทนาของ Amazon Web Services มีประโยชน์
