aws cli
1.0.0
توفر هذه الحزمة واجهة سطر أوامر موحدة لخدمات Amazon Web Services.
انتقل إلى:
هذا الملف التمهيدي مخصص للإصدار 1 من AWS CLI. إذا كنت تبحث عن معلومات حول الإصدار 2 من AWS CLI، فيرجى زيارة فرع v2.
تعمل الحزمة aws-cli على إصدارات Python:
في 30 مايو 2022، انتهى دعم Python 3.6. يأتي ذلك بعد انتهاء دعم Python Software Foundation لوقت التشغيل والذي حدث بتاريخ 23-12-2021.
في 13-12-2023، انتهى دعم Python 3.7. يأتي ذلك بعد انتهاء دعم Python Software Foundation لوقت التشغيل والذي حدث بتاريخ 27-06-2023. لمزيد من المعلومات، راجع منشور المدونة هذا.
انتباه!
نوصي جميع العملاء بمراقبة موقع Amazon Web Services Security Bullets بانتظام بحثًا عن أي نشرات أمنية مهمة تتعلق بـ aws-cli.
تم توفير الإصدار 1 من AWS CLI بشكل عام بتاريخ 09/02/2013 وهو حاليًا في مرحلة الدعم الكامل لدورة حياة التوفر.
للحصول على معلومات حول الصيانة والدعم للإصدارات الرئيسية من SDK وتبعياتها الأساسية، راجع قسم سياسة الصيانة في دليل AWS SDKs and Tools Shared Configuration and Credentials Reference Guide .
يستخدم تثبيت AWS CLI وتبعياته مجموعة من ميزات التعبئة التي توفرها أدوات pip setuptools . لضمان التثبيت السلس، يوصى باستخدام:
pip : 9.0.2 أو أكبرsetuptools : 36.2.0 أو أحدث الطريقة الأكثر أمانًا لتثبيت AWS CLI هي استخدام النقطة في virtualenv :
$ python -m pip install awscli
أو، إذا لم تكن تقوم بالتثبيت في virtualenv ، للتثبيت عالميًا:
$ sudo python -m pip install 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 install awscli --ignore-installed six
في Linux وMac OS، يمكن تثبيت AWS CLI باستخدام أداة التثبيت المجمعة. يمكن أيضًا تثبيت AWS CLI على نظام التشغيل Windows عبر مثبت MSI.
إذا كنت تريد تشغيل فرع develop لـ AWS CLI، فراجع قسم إصدار التطوير في دليل المساهمة.
راجع قسم التثبيت في دليل مستخدم AWS CLI لمزيد من المعلومات.
قبل استخدام AWS CLI، تحتاج إلى تكوين بيانات اعتماد AWS الخاصة بك. يمكنك القيام بذلك بعدة طرق:
أسرع طريقة للبدء هي تشغيل أمر aws configure :
تكوين $ أوس معرف مفتاح وصول 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=<المفتاح السري الافتراضي> # اختياري، لتحديد المنطقة الافتراضية لملف التعريف هذا. المنطقة=غرب-1 [اختبار الملف الشخصي] aws_access_key_id=<اختبار مفتاح الوصول> aws_secret_access_key=<اختبار المفتاح السري> المنطقة=غرب-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 وتستخدمها تلقائيًا.
بالإضافة إلى بيانات الاعتماد، يمكن تكوين عدد من المتغيرات الأخرى إما باستخدام متغيرات البيئة أو إدخالات ملف التكوين أو كليهما. راجع الدليل المرجعي للتكوين المشترك وبيانات الاعتماد لأدوات AWS وSDK لمزيد من المعلومات.
لمزيد من المعلومات حول خيارات التكوين، يرجى الرجوع إلى موضوع متغيرات تكوين AWS CLI. يمكنك الوصول إلى هذا الموضوع من AWS CLI أيضًا عن طريق تشغيل aws help config-vars .
يحتوي أمر AWS CLI على البنية التالية:
$ aws[الخيارات والمعلمات]
على سبيل المثال، لسرد مجموعات S3، سيكون الأمر كما يلي:
$ أوس S3 ليرة سورية
لعرض وثائق المساعدة، استخدم أحد الإجراءات التالية:
$ أوس مساعدة مساعدة $ aws$ aws مساعدة
للحصول على إصدار AWS CLI:
$ أوس --النسخة
لتشغيل إخراج التصحيح:
$ aws --debug
يمكنك قراءة المزيد من المعلومات في فصل استخدام AWS CLI من دليل مستخدم AWS CLI.
تتضمن حزمة aws-cli ميزة إكمال الأوامر للأنظمة المشابهة لنظام Unix. لا يتم تثبيت هذه الميزة تلقائيًا، لذا يتعين عليك تكوينها يدويًا. لمعرفة المزيد، اقرأ موضوع إكمال AWS CLI Command.
أفضل طريقة للتفاعل مع فريقنا هي من خلال GitHub. يمكنك فتح مشكلة والاختيار من أحد نماذجنا للحصول على إرشادات أو تقارير الأخطاء أو طلبات الميزات.
يمكنك العثور على مساعدة من المجتمع على Stack Overflow باستخدام العلامة aws-cli أو في منتدى مناقشة AWS لـ CLI. إذا كانت لديك خطة دعم مع AWS Support، فيمكنك أيضًا إنشاء حالة دعم جديدة.
يرجى التحقق من وجود مشكلات مماثلة مفتوحة قبل فتح مشكلة أخرى.
تنفذ AWS CLI واجهات برمجة تطبيقات خدمة AWS. بالنسبة للمشكلات العامة المتعلقة بالخدمات أو قيودها، قد تجد منتديات مناقشة خدمات Amazon Web Services مفيدة.
