Share via

azcopy set-properties (معاينة)

  • مقالة

بالنظر إلى موقع ما، غيّر كافة خصائص النظام الصالحة لهذا التخزين (كائن ثنائي كبير الحجم أو ملف).

الخلاصة

azcopy set-properties [resourceURL] [flags]

تعيين خصائص تخزين الملفات وكائن ثنائي كبير الحجم. الخصائص التي يدعمها هذا الأمر حاليًا هي:

  • الكائنات الثنائية كبيرة الحجم -> المستوى، بيانات التعريف، العلامات
  • Azure Data Lake Storage Gen2 -> المستوى، بيانات التعريف، العلامات
  • الملفات -> بيانات التعريف

إشعار

ستُستبدل نقاط نهاية Azure Data Lake Storage Gen2 بنقاط نهاية "تخزين كائن ثنائي كبير الحجم".

راجع الأمثلة للحصول على مزيد من المعلومات.

الأمثلة

تغيير مستوى الكائن الثنائي كبير الحجم إلى فعّال:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot

تغيير مستوى الكائن الثنائي كبير الحجم من "أرشفة" إلى "فرعي" مع تعيين أولوية إعادة التحميل إلى "قصوى":

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cool --rehydrate-priority=high

تغيير مستوى جميع الملفات في الدليل إلى "أرشفة":

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --block-blob-tier=archive --recursive=true

تغيير بيانات تعريف الكائن الثنائي كبير الحجم إلى {key = "abc", val = "def"} و{key = "ghi", val = "jkl"}:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=abc=def;ghi=jkl

تغيير بيانات التعريف لجميع الملفات في الدليل إلى {key = "abc", val = "def"} و{key = "ghi", val = "jkl"}:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --metadata=abc=def;ghi=jkl --recursive=true

مسح كافة بيانات التعريف الموجودة للكائن الثنائي كبير الحجم:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=clear

تغيير علامات كائن ثنائي كبير الحجم إلى {key = "abc", val = "def"} و{key = "ghi", val = "jkl"}:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=abc=def&ghi=jkl

أثناء تعيين العلامات على الكائنات الثنائية كبيرة الحجم، هناك أذونات أخرى ('t' للعلامات) باستخدام SAS. ستُرجع الخدمة خطأ تخويل بدون هذه العلامات.

مسح كافة علامات الكائن الثنائي كبير الحجم الموجودة في الكائن الثنائي كبير الحجم:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=clear

أثناء تعيين العلامات على الكائنات الثنائية كبيرة الحجم، هناك أذونات أخرى ('t' للعلامات) باستخدام SAS. ستُرجع الخدمة خطأ تخويل بدون هذه العلامات.

الخيارات

--blob-tags سلسلة تعيين العلامات على الكائنات الثنائية كبيرة الحجم لتصنيف البيانات في حساب التخزين الخاص بك (مفصولة ب '&')

سلسة --block-blob-tier تُغيّر طبقة التخزين للكائنات الثنائية كبيرة الحجم إلى المستوى المحدد (الافتراضي "بلا")

--dry-run يطبع مسارات الملفات التي ستتأثر بهذا الأمر. هذه العلامة لا تُؤثر على الملفات الفعلية.

سلسلة --exclude-path تستبعد هذه المسارات عند الإزالة. لا يدعم هذا الخيار أحرف البدل (*). يتحقق من بادئة المسار النسبي. على سبيل المثال: myFolder;myFolder/subDirName/file.pdf

سلسلة --exclude-pattern تستبعد الملفات التي يتطابق اسمها مع قائمة الأنماط. على سبيل المثال: .jpg؛.pdf؛exactName

سلسلة --from-to تحدد بشكل اختياري مجموعة وجهة المصدر. القيم الصالحة: BlobNone، FileNone، BlobFSNone

-h, --help يساعدا خصائص المجموعة

سلسلة --include-path تتضمن فقط هذه المسارات عند تعيين الخاصية. لا يدعم هذا الخيار أحرف البدل (*). يتحقق من بادئة المسار النسبي. على سبيل المثال: myFolder;myFolder/subDirName/file.pdf

سلسلة --include-pattern تتضمن فقط الملفات التي يتطابق اسمها مع قائمة الأنماط. على سبيل المثال: .jpg؛.pdf؛exactName

سلسلة --list-of-files تحدد موقع الملف النصي الذي يحتوي على قائمة الملفات المراد نسخها.

سلسلة --metadata تُعيّن الموقع المحدد مع أزواج قيمة المفتاح هذه (مفصولة بـ ';') كبيانات تعريف.

سلسلة --page-blob-tier تُحمّل الكائن الثنائي كبير الحجم للصفحة إلى "تخزين Azure" باستخدام مستوى الكائنات الثنائية كبيرة الحجم هذا. (الافتراضي 'لا شيء'). (الافتراضي "لا شيء")

--recursive ابحث في الدلائل الفرعية بشكل متكرر عند التحميل من نظام الملفات المحلي.

سلسلة --rehydrate-priority علامة اختيارية تحدد أولوية إعادة التحميل لإعادة التحميل. القيم الصالحة: قياسية، عالية. افتراضي- قياسي (افتراضي "قياسي")

الخيارات الموروثة من الأوامر الأصل

--cap-mbps float ارتفاع معدل النقل بوحدات ميجابت في الثانية. قد تختلف الإنتاجية لحظة بلحظة قليلا عن الحد الأقصى. إذا تم تعيين هذا الخيار على صفر، أو تم حذفه، فلن يتم تحديد معدل النقل لنقظة الارتكاز.

--log-level (سلسلة) حدد إسهاب السجل لملف السجل، والمستويات المتاحة: INFO (جميع الطلبات / الاستجابات)، وWARNING (الاستجابات البطيئة)، وERROR (الطلبات الفاشلة فقط)، وNONE (لا توجد سجلات إخراج). (الافتراضي "INFO"). (الافتراضي "المعلومات")

--output-type (سلسلة) تنسيق إخراج الأمر. وتشمل الخيارات: النص، json. القيمة الافتراضية هي 'text'. (افتراضي "نص")

سلسلة --output-level تحدد إسهاب الإخراج. المستويات المتوفرة: ضرورية وهادئة. (افتراضي "افتراضي")

--trusted-microsoft-suffixes (سلسلة) يحدد لاحقات المجال الأخرى حيث قد يتم إرسال رموز Microsoft Entra ID لتسجيل الدخول. الافتراضي هو '.core.windows.net؛.core.chinacloudapi.cn؛.core.cloudapi.de؛.core.usgovcloudapi.net؛ *.storage.azure.net'. تتم إضافة أي قيمة مدرجة هنا إلى الإعداد الافتراضي. للأمان، يجب وضع مجالات Microsoft Azure هنا فقط. يمكنك فصل الإدخالات المتعددة بفواصل منقوطة.

(راجع أيضًا )