s3cmd(1)

General Commands Manual

s3cmd(1)

نام (NAME)

s3cmd - ابزاری برای مدیریت فضای ذخیره‌سازی Amazon S3 و شبکه توزیع محتوای Amazon CloudFront

خلاصه دستور (SYNOPSIS)

s3cmd [OPTIONS] COMMAND [PARAMETERS]

توضیحات (DESCRIPTION)

s3cmd یک کلاینت خط فرمان برای رونوشت فایل‌ها به/از Amazon S3 (سرویس ذخیره‌سازی ساده) و انجام دیگر وظایف مرتبط است، برای نمونه ایجاد و حذف باکت‌ها، فهرست‌کردن اشیاء و غیره.

دستورها (COMMANDS)

s3cmd می‌تواند چندین عمل را که با دستورهای زیر مشخص می‌شوند انجام دهد.

s3cmd mb s3://BUCKET: ایجاد باکت
s3cmd rb s3://BUCKET: حذف باکت
s3cmd ls [s3://BUCKET[/PREFIX]]: فهرست‌کردن اشیاء یا باکت‌ها
s3cmd la: فهرست‌کردن تمام اشیاء در همهٔ باکت‌ها
s3cmd put FILE [FILE...] s3://BUCKET[/PREFIX]: قرار دادن فایل در باکت
s3cmd get s3://BUCKET/OBJECT LOCAL_FILE: دریافت فایل از باکت
s3cmd del s3://BUCKET/OBJECT: حذف فایل از باکت
s3cmd rm s3://BUCKET/OBJECT: حذف فایل از باکت (نام مستعار برای del)
s3cmd restore s3://BUCKET/OBJECT: بازیابی فایل از فضای ذخیره‌سازی Glacier
s3cmd sync LOCAL_DIR s3://BUCKET[/PREFIX] or s3://BUCKET[/PREFIX] LOCAL_DIR or s3://BUCKET[/PREFIX] s3://BUCKET[/PREFIX]: همگام‌سازی یک درخت دایرکتوری با S3 (بررسی تازگی فایل‌ها با استفاده از اندازه و جمع‌آزمایی md5، مگر اینکه با گزینه‌ها لغو شود؛ به بخش زیر مراجعه کنید)
s3cmd du [s3://BUCKET[/PREFIX]]: میزان مصرف دیسک توسط باکت‌ها
s3cmd info s3://BUCKET[/OBJECT]: دریافت اطلاعات گوناگون درباره باکت‌ها یا فایل‌ها
s3cmd cp s3://BUCKET1/OBJECT1 s3://BUCKET2[/OBJECT2]: رونوشت شیء
s3cmd modify s3://BUCKET1/OBJECT: تغییر متاداده شیء
s3cmd mv s3://BUCKET1/OBJECT1 s3://BUCKET2[/OBJECT2]: انتقال شیء
s3cmd setacl s3://BUCKET[/OBJECT]: تغییر فهرست کنترل دسترسی (ACL) برای باکت یا فایل‌ها
s3cmd setversioning s3://BUCKET enable|disable: تغییر نسخه‌بندی باکت
s3cmd setownership s3://BUCKET BucketOwnerPreferred|BucketOwnerEnforced|ObjectWriter: تغییر مالکیت شیء در باکت
s3cmd setblockpublicaccess s3://BUCKET BlockPublicAcls,IgnorePublicAcls,BlockPublicPolicy,RestrictPublicBuckets: تغییر قواعد مسدودسازی دسترسی عمومی
s3cmd setobjectlegalhold STATUS s3://BUCKET/OBJECT: تغییر وضعیت نگه‌داری قانونی شیء
s3cmd setobjectretention MODE RETAIN_UNTIL_DATE s3://BUCKET/OBJECT: تغییر دوره نگه‌داری شیء
s3cmd setpolicy FILE s3://BUCKET: تغییر خط‌مشی باکت
s3cmd delpolicy s3://BUCKET: حذف خط‌مشی باکت
s3cmd setcors FILE s3://BUCKET: تغییر CORS باکت
s3cmd delcors s3://BUCKET: حذف CORS باکت
s3cmd payer s3://BUCKET: تغییر خط‌مشی پرداخت توسط درخواست‌کننده باکت
s3cmd multipart s3://BUCKET [Id]: نمایش بارگذاری‌های چندبخشی
s3cmd abortmp s3://BUCKET/OBJECT Id: لغو یک بارگذاری چندبخشی
s3cmd listmp s3://BUCKET/OBJECT Id: فهرست‌کردن بخش‌های یک بارگذاری چندبخشی
s3cmd accesslog s3://BUCKET: فعال/غیرفعال کردن ثبت گزارش دسترسی به باکت
s3cmd sign STRING-TO-SIGN: امضای رشته دلخواه با استفاده از کلید مخفی
s3cmd signurl s3://BUCKET/OBJECT <expiry_epoch|+expiry_offset>: امضای نشانی اینترنتی S3 برای فراهم کردن دسترسی عمومی محدود با زمان انقضا
s3cmd fixbucket s3://BUCKET[/PREFIX]: تصحیح نام‌های نامعتبر فایل‌ها در باکت
s3cmd settagging s3://BUCKET[/OBJECT] "KEY=VALUE[&KEY=VALUE ...]": تغییر برچسب‌گذاری برای باکت یا فایل‌ها
s3cmd gettagging s3://BUCKET[/OBJECT]: دریافت برچسب‌های باکت یا فایل‌ها
s3cmd deltagging s3://BUCKET[/OBJECT]: حذف برچسب‌های باکت یا فایل‌ها
s3cmd expire s3://BUCKET: تنظیم یا حذف قاعده انقضا برای باکت
s3cmd setlifecycle FILE s3://BUCKET: بارگذاری خط‌مشی چرخه حیات برای باکت
s3cmd getlifecycle s3://BUCKET: دریافت خط‌مشی چرخه حیات برای باکت
s3cmd dellifecycle s3://BUCKET: حذف خط‌مشی چرخه حیات باکت
s3cmd setnotification FILE s3://BUCKET: بارگذاری خط‌مشی اعلان برای باکت
s3cmd getnotification s3://BUCKET: دریافت خط‌مشی اعلان برای باکت
s3cmd delnotification s3://BUCKET: حذف خط‌مشی اعلان باکت

دستورهای پیکربندی وب‌سایت‌های ایستا

s3cmd ws-create s3://BUCKET: ایجاد وب‌سایت از باکت
s3cmd ws-delete s3://BUCKET: حذف وب‌سایت
s3cmd ws-info s3://BUCKET: اطلاعات درباره وب‌سایت

دستورهای مدیریت CloudFront

s3cmd cflist: فهرست‌کردن نقاط توزیع CloudFront
s3cmd cfinfo [cf://DIST_ID]: نمایش پارامترهای نقطه توزیع CloudFront
s3cmd cfcreate s3://BUCKET: ایجاد نقطه توزیع CloudFront
s3cmd cfdelete cf://DIST_ID: حذف نقطه توزیع CloudFront.TP s3cmd cfmodify cf://DIST_ID تغییر پارامترهای نقطه توزیع CloudFront
s3cmd cfinval s3://BUCKET/OBJECT [s3://BUCKET/OBJECT ...]: باطل‌سازی (Invalidate) اشیاء CloudFront
s3cmd cfinvalinfo cf://DIST_ID[/INVAL_ID]: نمایش وضعیت درخواست(های) باطل‌سازی CloudFront

گزینه‌ها (OPTIONS)

مقادیر پیش‌فرض برخی از گزینه‌های مشخص‌شده در زیر را می‌توان در فایل پیکربندی s3cmd (به‌طور پیش‌فرض $HOME/.s3cmd) تعیین کرد. از آنجا که این فایل یک فایل متنی ساده است، می‌توانید آن را با ویرایشگر متنی دلخواه خود باز کرده و تغییرات مورد نظر خود را اعمال کنید.

-h, --help: نمایش این پیام راهنما و خروج
--configure: فراخوانی ابزار تعاملی پیکربندی (یا پیکربندی مجدد). همچنین می‌توانید به‌صورت اختياری از '--configure s3://some-bucket' برای آزمایش دسترسی به یک باکت خاص به‌جای تلاش برای فهرست کردن همه آن‌ها استفاده کنید.
-c FILE, --config=FILE: نام فایل پیکربندی. پیش‌فرض $HOME/.s3cfg است.
--dump-config: نمایش و تخلیه پیکربندی فعلی پس از تجزیه فایل‌های پیکربندی و گزینه‌های خط فرمان و سپس خروج.
--access_key=ACCESS_KEY: کلید دسترسی (Access Key) در AWS
--secret_key=SECRET_KEY: کلید محرمانه (Secret Key) در AWS
--access_token=ACCESS_TOKEN: توکن دسترسی (Access Token) در AWS
-n, --dry-run: فقط نشان می‌دهد چه مواردی باید بارگذاری یا بارگیری شوند، اما در عمل کاری انجام نمی‌دهد. با این حال ممکن است همچنان درخواست‌های S3 را برای دریافت فهرست باکت‌ها و سایر اطلاعات انجام دهد (فقط برای دستورهای انتقال فایل).
-s, --ssl: استفاده از اتصال HTTPS هنگام برقراری ارتباط با S3. (پیش‌فرض)
--no-ssl: عدم استفاده از HTTPS.
-e, --encrypt: رمزگذاری فایل‌ها پیش از بارگذاری در S3.
--no-encrypt: عدم رمزگذاری فایل‌ها.
-f, --force: اجبار در رونویسی و سایر عملیات‌های خطرناک.
--continue: ادامه دریافت یک فایل نیمه‌بارگیری‌شده (فقط برای دستور [get]).
--continue-put: ادامه بارگذاری فایل‌های نیمه‌بارگذاری‌شده یا بخش‌های بارگذاری چندبخشی (multipart). بخش‌ها یا فایل‌هایی را که اندازه و مقدار md5 یکسانی ندارند را مجدداً بارگذاری می‌کند. فایل‌ها یا بخش‌های دارای اندازه و md5 یکسان را نادیده می‌گیرد. نکته: بررسی‌های md5sum همیشه برای بررسی یکسانی (بخش‌های) فایل کافی نیستند. این گزینه را با مسئولیت خود فعال کنید.
--upload-id=UPLOAD_ID: شناسه UploadId برای بارگذاری چندبخشی، در صورتی که بخواهید یک بارگذاری موجود را ادامه دهید (معادل --continue-put) و چندین بارگذاری ناقص وجود داشته باشد. از دستور s3cmd multipart [URI] استفاده کنید تا ببینید چه UploadIdهایی با URI داده‌شده مرتبط هستند.
--skip-existing: نادیده گرفتن فایل‌هایی که در مقصد وجود دارند (فقط برای دستورهای [get] و [sync]).
-r, --recursive: بارگذاری، بارگیری یا حذف بازگشتی (recursive).
--check-md5: بررسی مقادیر مجموع کنترل MD5 هنگام مقایسه فایل‌ها برای [sync]. (پیش‌فرض)
--no-check-md5: عدم بررسی مقادیر مجموع کنترل MD5 هنگام مقایسه فایل‌ها برای [sync]. تنها اندازه فایل مقایسه خواهد شد. ممکن است سرعت انتقال را به‌طور چشمگیری افزایش دهد اما ممکن است برخی فایل‌های تغییریافته را نادیده بگیرد.
-P, --acl-public: ذخیره اشیاء با ACL که به هر کسی اجازه خواندن می‌دهد.
--acl-private: ذخیره اشیاء با ACL پیش‌فرض که تنها به شما اجازه دسترسی می‌دهد.
--acl-grant=PERMISSION:EMAIL or USER_CANONICAL_ID: اعطای مجوز مشخص‌شده به کاربر داده‌شده در آمازون. مجوز یکی از این موارد است: read، write، read_acp، write_acp، full_control، all
--acl-revoke=PERMISSION:USER_CANONICAL_ID: لغو مجوز مشخص‌شده برای کاربر داده‌شده در آمازون. مجوز یکی از این موارد است: read، write، read_acp، write_acp، full_control، all
-D NUM, --restore-days=NUM: تعداد روزهایی که فایل بازیابی‌شده در دسترس نگه داشته می‌شود (تنها برای دستور 'restore'). پیش‌فرض ۱ روز است.
--restore-priority=RESTORE_PRIORITY: اولویت بازیابی فایل‌ها از S3 Glacier (تنها برای دستور 'restore'). گزینه‌های موجود: bulk، standard، expedited
--delete-removed: حذف اشیای مقصد در صورتی که فایل متناظری در مبدأ وجود نداشته باشد [sync]
--no-delete-removed: عدم حذف اشیای مقصد [sync]
--delete-after: انجام حذف‌ها پس از بارگذاری‌های جدید هنگامی که delete-removed فعال است [sync]
--delay-updates: *منسوخ‌شده* قرار دادن تمام فایل‌های به‌روزرسانی‌شده در جای خود در پایان کار [sync]
--max-delete=NUM: عدم حذف بیش از NUM فایل. [del] و [sync]
--limit=NUM: محدود کردن تعداد اشیای بازگردانده‌شده در بدنه پاسخ (تنها برای دستورهای [ls] و [la])
--add-destination=ADDITIONAL_DESTINATIONS: مقصد اضافی برای بارگذاری‌های موازی، علاوه بر آخرین آرگومان. می‌تواند تکرار شود.
--delete-after-fetch: حذف اشیای دوردست پس از واکشی به فایل محلی (تنها برای دستورهای [get] و [sync]).
-p, --preserve: حفظ ویژگی‌های فایل‌سیستم (دسترسی‌ها، مالکیت، برچسب‌های زمانی). پیش‌فرض برای دستور [sync].
--no-preserve: عدم ذخیره ویژگی‌های فایل‌سیستم
--keep-dirs: حفظ تمام دایرکتوری‌های محلی به‌صورت اشیای دوردست از جمله دایرکتوری‌های خالی. ویژگی آزمایشی.
--exclude=GLOB: نام‌های فایل و مسیرهای منطبق با GLOB از همگام‌سازی (sync) مستثنی خواهند شد
--exclude-from=FILE: خواندن الگوهای GLOB مربوط به --exclude از FILE
--rexclude=REGEXP: نام‌های فایل و مسیرهای منطبق با REGEXP (عبارت باقاعده) از همگام‌سازی (sync) مستثنی خواهند شد
--rexclude-from=FILE: خواندن عبارات باقاعده REGEXP مربوط به --rexclude از FILE.TP --include=GLOB نام‌های فایل و مسیرهای منطبق بر GLOB گنجانده خواهند شد، حتی اگر قبلاً توسط یکی از الگوهای --(r)exclude(-from) مستثنی شده باشند.
--include-from=FILE: خواندن الگوهای GLOB گزینه --include از FILE.
--rinclude=REGEXP: مشابه --include است اما به جای GLOB از REGEXP (عبارت باقاعده) استفاده می‌کند.
--rinclude-from=FILE: خواندن الگوهای باقاعده REGEXP برای --rinclude از FILE.
--files-from=FILE: خواندن فهرست نام‌های فایل‌های مبدأ از FILE. برای خواندن از stdin از - استفاده کنید.
--region=REGION, --bucket-location=REGION: منطقه‌ای (Region) که باکت در آن ایجاد می‌شود. در حال حاضر منطقه‌ها عبارتند از: us-east-1، us-west-1، us-west-2، eu-west-1، eu-central-1، ap-northeast-1، ap-southeast-1، ap-southeast-2، sa-east-1
--host=HOSTNAME: مقدار HOSTNAME:PORT برای نقطه پایانی S3 (پیش‌فرض: s3.amazonaws.com، یا گزینه‌های جایگزین مانند s3-eu-west-1.amazonaws.com). همچنین باید --host-bucket را نیز تنظیم کنید.
--host-bucket=HOST_BUCKET: الگوی bucket+hostname:port به سبک DNS برای دسترسی به یک باکت (پیش‌فرض: %(bucket)s.s3.amazonaws.com)
--reduced-redundancy, --rr: ذخیره شیء با «Reduced redundancy» (افزونگی کاهش‌یافته). هزینه کمتر به ازای هر گیگابایت. [دستورهای put، cp، mv]
--no-reduced-redundancy, --no-rr: ذخیره شیء بدون «Reduced redundancy». هزینه بیشتر به ازای هر گیگابایت. [دستورهای put، cp، mv]
--storage-class=CLASS: ذخیره شیء با CLASS مشخص‌شده (STANDARD، STANDARD_IA، ONEZONE_IA، INTELLIGENT_TIERING، GLACIER یا DEEP_ARCHIVE). [دستورهای put، cp، mv]
--access-logging-target-prefix=LOG_TARGET_PREFIX: پیشوند مقصد برای گزارش‌های دسترسی (S3 URI) (برای دستورهای [cfmodify] و [accesslog])
--no-access-logging: غیرفعال‌سازی ثبت گزارش‌های دسترسی (برای دستورهای [cfmodify] و [accesslog])
--default-mime-type=DEFAULT_MIME_TYPE: نوع MIME پیش‌فرض برای اشیاء ذخیره‌شده. پیش‌فرض برنامه binary/octet-stream است.
-M, --guess-mime-type: حدس زدن نوع MIME فایل‌ها از روی پسوند آن‌ها یا mime magic. در صورت عدم تشخیص، استفاده از MIME-Type پیش‌فرضِ مشخص‌شده با گزینه --default-mime-type
--no-guess-mime-type: نوع MIME حدس زده نشود و در عوض از نوع پیش‌فرض استفاده شود.
--no-mime-magic: عدم استفاده از mime magic هنگام حدس زدن نوع MIME.
-m MIME/TYPE, --mime-type=MIME/TYPE: اجبار در تعیین نوع MIME. نادیده گرفتن هر دو گزینه --default-mime-type و --guess-mime-type.
--add-header=NAME:VALUE: افزودن یک سرآیند مشخص HTTP به درخواست بارگذاری. می‌تواند چندین بار استفاده شود. به عنوان مثال تنظیم سرآیندهای 'Expires' یا 'Cache-Control' (یا هر دو) با استفاده از این گزینه.
--remove-header=NAME: حذف یک سرآیند مشخص HTTP. می‌تواند چندین بار استفاده شود. برای نمونه، حذف سرآیندهای 'Expires' یا 'Cache-Control' (یا هر دو) با استفاده از این گزینه. [دستور modify]
--server-side-encryption: مشخص می‌کند که هنگام ارسال اشیاء از رمزگذاری سمت سرور استفاده شود. [دستورهای put، sync، cp، modify]
--server-side-encryption-kms-id=KMS_KEY: شناسه کلید مورد استفاده برای رمزگذاری سمت سرور با کلیدهای مدیریت‌شده AWS KMS‏ (SSE-KMS) هنگام ارسال اشیاء را مشخص می‌کند. [دستورهای put، sync، cp، modify]
--encoding=ENCODING: نادیده‌گرفتن کدگذاری (مجموعه نویسه) شناسایی‌شده به طور خودکار برای ترمینال و سامانه فایل. شناسایی‌شده خودکار: UTF-8
--add-encoding-exts=EXTENSIONs: افزودن کدگذاری به این پسوندهای جداشده با کاما، مانند (css,js,html)، هنگام بارگذاری به S3.
--verbatim: استفاده از نام S3 دقیقاً به همان صورت که در خط فرمان داده شده است. بدون پیش‌پردازش، کدگذاری و غیره. با احتیاط استفاده شود!
--disable-multipart: غیرفعال‌سازی بارگذاری چندبخشی برای فایل‌های بزرگ‌تر از --multipart-chunk-size-mb
--multipart-chunk-size-mb=SIZE: اندازه هر تکه در بارگذاری چندبخشی. فایل‌های بزرگ‌تر از SIZE به طور خودکار به صورت چندبخشیِ چندنخی بارگذاری می‌شوند؛ فایل‌های کوچک‌تر با استفاده از روش سنتی بارگذاری خواهند شد. مقدار SIZE بر حسب مگابایت است، اندازه تکه پیش‌فرض 15MB، حداقل اندازه مجاز 5MB و حداکثر آن 5GB است.
--list-md5: گنجاندن مقادیر MD5 در فهرست‌بندی باکت (تنها برای دستور 'ls').
--list-allow-unordered: از استانداردهای AWS نیست. اجازه می‌دهد نتایج فهرست‌بندی به صورت نامرتب بازگردانده شوند. این قابلیت ممکن است هنگام فهرست کردن باکت‌های بسیار بزرگ سریع‌تر عمل کند.
-H, --human-readable-sizes: نمایش اندازه‌ها با قالبی خوانا برای انسان (مثلاً 1kB به جای 1234).
--ws-index=WEBSITE_INDEX: نام سند شاخص (index-document) (تنها برای دستور [ws-create])
--ws-error=WEBSITE_ERROR: نام سند خطا (error-document) (تنها برای دستور [ws-create])
--expiry-date=EXPIRY_DATE: مشخص می‌کند که قانون انقضا از چه زمانی اجرایی می‌شود (تنها برای دستور [expire]).
--expiry-days=EXPIRY_DAYS: تعداد روزهای پس از ایجاد شیء را مشخص می‌کند که قانون انقضا پس از آن اجرایی می‌شود (تنها برای دستور [expire]).
--expiry-prefix=EXPIRY_PREFIX: مشخص‌کننده یک یا چند شیء با پیشوندی که قانون انقضا بر آن‌ها اعمال می‌شود (تنها برای دستور [expire]).
--skip-destination-validation: صرف‌نظر کردن از اعتبارسنجی مقصدهای Amazon SQS، Amazon SNS و AWS Lambda هنگام اعمال پیکربندی اعلان‌ها (تنها برای دستور [setnotification]).
--progress: نمایش نشانگر پیشرفت (پیش‌فرض در TTY).
--no-progress: عدم نمایش نشانگر پیشرفت (پیش‌فرض در محیط‌های غیر TTY).
--stats: نمایش برخی آمارهای مربوط به انتقال فایل.
--enable: فعال‌سازی توزیع مشخص‌شده در CloudFront (تنها برای دستور [cfmodify]).
--disable: غیرفعال‌سازی توزیع مشخص‌شده در CloudFront (تنها برای دستور [cfmodify]).
--cf-invalidate: نامعتبر کردن (Invalidate) فایل‌های بارگذاری‌شده در CloudFront. همچنین به دستور [cfinval] مراجعه کنید.
--cf-invalidate-default-index: هنگام استفاده از Custom Origin و وب‌گاه ایستای S3، فایل شاخص (index) پیش‌فرض را نامعتبر می‌کند..TP --cf-no-invalidate-default-index-root هنگام استفاده از Custom Origin و وب‌گاه ایستای S3، مسیر فایل شاخص پیش‌فرض را باطل نکن.
--cf-add-cname=CNAME: افزودن CNAME داده‌شده به یک توزیع CloudFront (فقط برای دستورهای [cfcreate] و [cfmodify])
--cf-remove-cname=CNAME: حذف CNAME داده‌شده از یک توزیع CloudFront (فقط برای دستور [cfmodify])
--cf-comment=COMMENT: تنظیم COMMENT برای یک توزیع CloudFront داده‌شده (فقط برای دستورهای [cfcreate] و [cfmodify])
--cf-default-root-object=DEFAULT_ROOT_OBJECT: تنظیم شیء ریشهٔ پیش‌فرض برای بازگرداندن هنگامی که هیچ شیئی در نشانی اینترنتی (URL) مشخص نشده است. از یک مسیر نسبی استفاده کنید، یعنی default/index.html به‌جای /default/index.html یا s3://bucket/default/index.html (فقط برای دستورهای [cfcreate] و [cfmodify])
-v, --verbose: فعال‌سازی خروجی پرجزئیات.
-d, --debug: فعال‌سازی خروجی اشکال‌زدایی.
--version: نمایش نسخهٔ s3cmd (2.4.0) و خروج.
-F, --follow-symlinks: دنبال کردن پیوندهای نمادین مانند فایل‌های معمولی
--cache-file=FILE: فایل ذخیره‌گاه FILE حاوی مقادیر MD5 مبدأ محلی
-q, --quiet: بی‌صدا کردن خروجی در خروجی استاندارد (stdout)
--ca-certs=CA_CERTS_FILE: مسیر فایل گواهی SSL CA با نام CA_CERTS_FILE (به‌جای پیش‌فرض سیستم)
--ssl-cert=SSL_CLIENT_CERT_FILE: مسیر فایل گواهی SSL اختصاصی کارخواه CRT_FILE
--ssl-key=SSL_CLIENT_KEY_FILE: مسیر فایل کلید خصوصی گواهی SSL اختصاصی کارخواه KEY_FILE
--check-certificate: بررسی اعتبار گواهی SSL
--no-check-certificate: عدم بررسی اعتبار گواهی SSL
--check-hostname: بررسی اعتبار نام میزبان در گواهی SSL
--no-check-hostname: عدم بررسی اعتبار نام میزبان در گواهی SSL
--signature-v2: استفاده از نسخهٔ ۲ امضای AWS به‌جای روش‌های جدیدتر امضا. برای سامانه‌های مشابه S3 که هنوز نسخهٔ ۴ امضای AWS را ندارند مفید است.
--limit-rate=LIMITRATE: محدود کردن سرعت بارگذاری یا بارگیری به مقداری مشخص از بایت بر ثانیه. این مقدار می‌تواند برحسب بایت، کیلوبایت با پسوند k، یا مگابایت با پسوند m مشخص شود
--no-connection-pooling: غیرفعال‌سازی استفادهٔ مجدد از اتصال
--requester-pays: تنظیم پرچم REQUESTER PAYS برای عملیات‌ها
-l, --long-listing: تولید فهرست بلند [ls]
--stop-on-error: توقف در صورت بروز خطا در انتقال
--max-retries=NUM: حداکثر دفعات تلاش مجدد برای یک درخواست ناموفق پیش از صرف‌نظر کردن. پیش‌فرض ۵ است
--content-disposition=CONTENT_DISPOSITION: ارائه یک Content-Disposition برای نشانی‌های اینترنتی امضاشده، مانند: "inline; filename=myvideo.mp4"
--content-type=CONTENT_TYPE: ارائه یک Content-Type برای نشانی‌های اینترنتی امضاشده، مانند: "video/mp4".SH "مثال‌ها (EXAMPLES)" یکی از قدرتمندترین دستورهای s3cmd دستور s3cmd sync است که برای همگام‌سازی کامل درخت دایرکتوری‌ها به یا از حافظهٔ دوردست S3 استفاده می‌شود. تا حدودی s3cmd put و s3cmd get رفتار مشابهی با sync دارند.

کاربرد پایه‌ای که در سناریوهای پشتیبان‌گیری رایج است، به همین سادگی است:

s3cmd sync /local/path/ s3://test-bucket/backup/

این دستور همهٔ فایل‌های زیر دایرکتوری /local/path را پیدا کرده و آن‌ها را در مسیرهای متناظر در s3://test-bucket/backup در سمت دوردست کپی می‌کند. برای مثال:

/local/path/file1.ext         ->  s3://bucket/backup/file1.ext
/local/path/dir123/file2.bin  ->  s3://bucket/backup/dir123/file2.bin

با این حال، اگر مسیر محلی با یک اسلش پایان نیابد، نام آخرین دایرکتوری نیز در سمت دوردست استفاده می‌شود. این را با مثال قبلی مقایسه کنید:

s3cmd sync /local/path s3://test-bucket/backup/

موارد زیر را همگام خواهد کرد:

/local/path/file1.ext         ->  s3://bucket/backup/path/file1.ext
/local/path/dir123/file2.bin  ->  s3://bucket/backup/path/dir123/file2.bin

برای بازگردانی فایل‌ها از S3، از ساختار برعکس استفاده کنید:

s3cmd sync s3://test-bucket/backup/ ~/restore/

که این فایل‌ها را بارگیری خواهد کرد:

s3://bucket/backup/file1.ext         ->  ~/restore/file1.ext
s3://bucket/backup/dir123/file2.bin  ->  ~/restore/dir123/file2.bin

بدون اسلش پایانی در مبدأ، رفتار مشابه چیزی خواهد بود که در بارگذاری نشان داده شد:

s3cmd sync s3://test-bucket/backup ~/restore/

فایل‌ها را بدین شکل بارگیری خواهد کرد:

s3://bucket/backup/file1.ext         ->  ~/restore/backup/file1.ext
s3://bucket/backup/dir123/file2.bin  ->  ~/restore/backup/dir123/file2.bin

همهٔ نام‌های فایل‌های مبدأ (موارد برجسته در بالا) با قواعد exclude مطابقت داده می‌شوند و مواردی که مطابقت دارند، سپس دوباره با قواعد include بررسی می‌شوند تا مشخص شود که آیا باید کنار گذاشته شوند یا در فهرست مبدأ نگه‌داشته شوند.

به منظور تطبیق --exclude و --include فقط نام فایل‌های پررنگ شده در بالا به کار می‌روند. به عنوان مثال، فقط path/file1.ext با الگوها بررسی می‌شود، نه /local/path/file1.ext

هر دو گزینهٔ --exclude و --include با نویسه‌های عام سبک پوسته (معروف به GLOB) کار می‌کنند. برای انعطاف‌پذیری بیشتر، s3cmd نسخه‌های عبارت باقاعده (Regular-expression) از این دو گزینه را با نام‌های --rexclude و --rinclude فراهم می‌کند. گزینه‌های دارای پسوند ...-from (مانند --rinclude-from) یک نام فایل را به عنوان یک آرگومان می‌پذیرند. هر خط از چنین فایلی به عنوان یک الگو در نظر گرفته می‌شود.

تنها یک مجموعه الگو از تمام گزینه‌های --(r)exclude(-from) ساخته می‌شود و به طور مشابه برای نوع include نیز چنین است. هر فایلی که برای مثال با --exclude کنار گذاشته شده باشد، می‌تواند با الگویی که در فهرست --rinclude-from یافت می‌شود، بازگردانده شود.

دستور s3cmd را با --dry-run اجرا کنید تا مطمئن شوید قواعد شما همان‌طور که انتظار می‌رود کار می‌کنند. از آن به همراه --debug استفاده کنید تا اطلاعات دقیقی دربارهٔ تطبیق نام فایل‌ها با قواعد exclude و include به دست آورید.

برای مثال، جهت مستثنی کردن همهٔ فایل‌های دارای پسوند ".jpg" به جز آن‌هایی که با یک عدد آغاز می‌شوند، استفاده کنید از:

--exclude '*.jpg' --rinclude '[0-9].*.jpg'

برای مستثنی کردن همهٔ فایل‌ها به جز مواردی با پسوند "*.jpg"، استفاده کنید از:

--exclude '*' --include '*.jpg'

برای مستثنی کردن دایرکتوری محلی 'somedir'، حتماً از یک اسلش رو به جلو در انتها استفاده کنید، بدین صورت:

--exclude 'somedir/' برای مشاهدهٔ به‌روزترین فهرست گزینه‌ها، این دستور را اجرا کنید: s3cmd --help
برای کسب اطلاعات بیشتر درباره نحوه استفاده، مثال‌ها و دیگر اطلاعات مرتبط، به صفحه اصلی پروژه مراجعه کنید: https://s3tools.org

نویسندگان (AUTHORS)

نوشته‌شده توسط Michal Ludvig، Florent Viard و مشارکت‌کنندگان

تماس و پشتیبانی (CONTACT, SUPPORT)

روش ترجیحی برای دریافت پشتیبانی، فهرست پستی ما است:
s3tools-general@lists.sourceforge.net
یا به صفحه اصلی پروژه مراجعه کنید:
https://s3tools.org

گزارش باگ‌ها (BUGS)

گزارش باگ‌ها را به این نشانی ارسال کنید: s3tools-bugs@lists.sourceforge.net

کپی‌رایت و تکثیر (COPYRIGHT)

مجوز (LICENSE)

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز همگانی عمومی گنو (GNU General Public License) منتشرشده توسط بنیاد نرم‌افزارهای آزاد (Free Software Foundation)؛ چه نسخهٔ ۲ مجوز و چه (به انتخاب خودتان) هر نسخهٔ بعدی، بازتوزیع کرده یا تغییر دهید. این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا تناسب با یک هدف خاص. برای جزئیات بیشتر به مجوز همگانی عمومی گنو مراجعه کنید.