مشاركة عبر

BlobBatchClient class

  • ‏‏المرجع
الحزمة:
@azure/storage-blob

يسمح لك BlobBatchClient بإجراء طلبات مجمعة إلى خدمة Azure Storage Blob.

راجع https://docs.microsoft.com/en-us/rest/api/storageservices/blob-batch

المنشئون

BlobBatchClient(string, PipelineLike)

إنشاء مثيل BlobBatchClient.
BlobBatchClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

إنشاء مثيل BlobBatchClient.

الأساليب

createBatch()

إنشاء BlobBatch. يمثل BlobBatch مجموعة مجمعة من العمليات على الكائنات الثنائية كبيرة الحجم.
deleteBlobs(BlobClient[], BlobDeleteOptions)

إنشاء عمليات حذف متعددة لوضع علامة على الكائنات الثنائية كبيرة الحجم أو اللقطات المحددة للحذف. لاحظ أنه من أجل حذف كائن ثنائي كبير الحجم، يجب حذف جميع لقطاته. يمكنك حذف كليهما في نفس الوقت. راجع حذف تفاصيل العملية. ستتم مصادقة العملية (الطلب الفرعي) وتخويلها ببيانات اعتماد محددة. راجع تفاصيل تخويل دفعة كائن ثنائي كبير الحجم.
deleteBlobs(string[], StorageSharedKeyCredential | AnonymousCredential | TokenCredential, BlobDeleteOptions)

إنشاء عمليات حذف متعددة لوضع علامة على الكائنات الثنائية كبيرة الحجم أو اللقطات المحددة للحذف. لاحظ أنه من أجل حذف كائن ثنائي كبير الحجم، يجب حذف جميع لقطاته. يمكنك حذف كليهما في نفس الوقت. راجع حذف تفاصيل العملية. ستتم مصادقة العمليات وتفويضها ببيانات اعتماد محددة. راجع تفاصيل تخويل دفعة كائن ثنائي كبير الحجم.
setBlobsAccessTier(BlobClient[], AccessTier, BlobSetTierOptions)

إنشاء عمليات طبقة متعددة لتعيين الطبقة على كائن ثنائي كبير الحجم. يسمح بالعملية على كائن ثنائي كبير الحجم للصفحة في حساب تخزين متميز وعلى كائن ثنائي كبير الحجم للكتلة في حساب تخزين كائن ثنائي كبير الحجم (تخزين متكرر محليا فقط). تحدد طبقة الكائن الثنائي كبير الحجم للصفحة المتميزة الحجم المسموح به وIOPS وعرض النطاق الترددي للكائن الثنائي كبير الحجم. تحدد طبقة كائن ثنائي كبير الحجم للكتلة نوع التخزين Hot/Cool/Archive. لا تقوم هذه العملية بتحديث ETag للكائن الثنائي كبير الحجم. راجع تعيين تفاصيل طبقة الكائن الثنائي كبير الحجم. ستتم مصادقة العملية (الطلب الفرعي) وتخويلها ببيانات اعتماد محددة. راجع تفاصيل تخويل دفعة كائن ثنائي كبير الحجم.
setBlobsAccessTier(string[], StorageSharedKeyCredential | AnonymousCredential | TokenCredential, AccessTier, BlobSetTierOptions)

إنشاء عمليات طبقة متعددة لتعيين الطبقة على كائن ثنائي كبير الحجم. يسمح بالعملية على كائن ثنائي كبير الحجم للصفحة في حساب تخزين متميز وعلى كائن ثنائي كبير الحجم للكتلة في حساب تخزين كائن ثنائي كبير الحجم (تخزين متكرر محليا فقط). تحدد طبقة الكائن الثنائي كبير الحجم للصفحة المتميزة الحجم المسموح به وIOPS وعرض النطاق الترددي للكائن الثنائي كبير الحجم. تحدد طبقة كائن ثنائي كبير الحجم للكتلة نوع التخزين Hot/Cool/Archive. لا تقوم هذه العملية بتحديث ETag للكائن الثنائي كبير الحجم. راجع تعيين تفاصيل طبقة الكائن الثنائي كبير الحجم. ستتم مصادقة العملية (الطلب الفرعي) وتخويلها ببيانات اعتماد محددة. راجع تفاصيل تخويل دفعة كائن ثنائي كبير الحجم.
submitBatch(BlobBatch, BlobBatchSubmitBatchOptionalParams)

إرسال طلب الدفعة الذي يتكون من طلبات فرعية متعددة.

احصل على blobBatchClient التفاصيل والتفاصيل الأخرى قبل تشغيل القصاصات البرمجية. blobServiceClient.getBlobBatchClient() يعطي blobBatchClient

استخدام المثال:

let batchRequest = new BlobBatch();
await batchRequest.deleteBlob(urlInString0, credential0);
await batchRequest.deleteBlob(urlInString1, credential1, {
 deleteSnapshots: "include"
});
const batchResp = await blobBatchClient.submitBatch(batchRequest);
console.log(batchResp.subResponsesSucceededCount);

مثال على استخدام عقد إيجار:

let batchRequest = new BlobBatch();
await batchRequest.setBlobAccessTier(blockBlobClient0, "Cool");
await batchRequest.setBlobAccessTier(blockBlobClient1, "Cool", {
 conditions: { leaseId: leaseId }
});
const batchResp = await blobBatchClient.submitBatch(batchRequest);
console.log(batchResp.subResponsesSucceededCount);

راجع https://docs.microsoft.com/en-us/rest/api/storageservices/blob-batch

تفاصيل المنشئ

BlobBatchClient(string, PipelineLike)

إنشاء مثيل BlobBatchClient.

new BlobBatchClient(url: string, pipeline: PipelineLike)

المعلمات

url

string

عنوان url يشير إلى خدمة كائن ثنائي كبير الحجم ل Azure Storage، مثل "https://myaccount.blob.core.windows.net". يمكنك إلحاق SAS إذا كنت تستخدم AnonymousCredential، مثل "https://myaccount.blob.core.windows.net?sasString".

pipeline
PipelineLike

اتصل ب newPipeline() لإنشاء مسار افتراضي، أو توفير مسار مخصص.

BlobBatchClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

إنشاء مثيل BlobBatchClient.

new BlobBatchClient(url: string, credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: StoragePipelineOptions)

المعلمات

url

string

عنوان url يشير إلى خدمة كائن ثنائي كبير الحجم ل Azure Storage، مثل "https://myaccount.blob.core.windows.net". يمكنك إلحاق SAS إذا كنت تستخدم AnonymousCredential، مثل "https://myaccount.blob.core.windows.net?sasString".

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

مثل AnonymousCredential أو StorageSharedKeyCredential أو أي بيانات اعتماد من الحزمة @azure/identity لمصادقة الطلبات إلى الخدمة. يمكنك أيضا توفير كائن ينفذ واجهة TokenCredential. إذا لم يتم تحديده، يتم استخدام AnonymousCredential.

options
StoragePipelineOptions

خيارات لتكوين البنية الأساسية لبرنامج ربط العمليات التجارية HTTP.

تفاصيل الأسلوب

createBatch()

إنشاء BlobBatch. يمثل BlobBatch مجموعة مجمعة من العمليات على الكائنات الثنائية كبيرة الحجم.

function createBatch(): BlobBatch

المرتجعات

BlobBatch

deleteBlobs(BlobClient[], BlobDeleteOptions)

إنشاء عمليات حذف متعددة لوضع علامة على الكائنات الثنائية كبيرة الحجم أو اللقطات المحددة للحذف. لاحظ أنه من أجل حذف كائن ثنائي كبير الحجم، يجب حذف جميع لقطاته. يمكنك حذف كليهما في نفس الوقت. راجع حذف تفاصيل العملية. ستتم مصادقة العملية (الطلب الفرعي) وتخويلها ببيانات اعتماد محددة. راجع تفاصيل تخويل دفعة كائن ثنائي كبير الحجم.

function deleteBlobs(blobClients: BlobClient[], options?: BlobDeleteOptions): Promise<BlobBatchSubmitBatchResponse>

المعلمات

blobClients

BlobClient[]

BlobClients للكائنات الثنائية كبيرة الحجم لحذفها.

options
BlobDeleteOptions

المرتجعات

Promise<BlobBatchSubmitBatchResponse>

deleteBlobs(string[], StorageSharedKeyCredential | AnonymousCredential | TokenCredential, BlobDeleteOptions)

إنشاء عمليات حذف متعددة لوضع علامة على الكائنات الثنائية كبيرة الحجم أو اللقطات المحددة للحذف. لاحظ أنه من أجل حذف كائن ثنائي كبير الحجم، يجب حذف جميع لقطاته. يمكنك حذف كليهما في نفس الوقت. راجع حذف تفاصيل العملية. ستتم مصادقة العمليات وتفويضها ببيانات اعتماد محددة. راجع تفاصيل تخويل دفعة كائن ثنائي كبير الحجم.

function deleteBlobs(urls: string[], credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: BlobDeleteOptions): Promise<BlobBatchSubmitBatchResponse>

المعلمات

urls

string[]

عناوين URL لموارد الكائن الثنائي كبير الحجم المراد حذفها.

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

مثل AnonymousCredential أو StorageSharedKeyCredential أو أي بيانات اعتماد من الحزمة @azure/identity لمصادقة الطلبات إلى الخدمة. يمكنك أيضا توفير كائن ينفذ واجهة TokenCredential. إذا لم يتم تحديده، يتم استخدام AnonymousCredential.

options
BlobDeleteOptions

المرتجعات

Promise<BlobBatchSubmitBatchResponse>

setBlobsAccessTier(BlobClient[], AccessTier, BlobSetTierOptions)

إنشاء عمليات طبقة متعددة لتعيين الطبقة على كائن ثنائي كبير الحجم. يسمح بالعملية على كائن ثنائي كبير الحجم للصفحة في حساب تخزين متميز وعلى كائن ثنائي كبير الحجم للكتلة في حساب تخزين كائن ثنائي كبير الحجم (تخزين متكرر محليا فقط). تحدد طبقة الكائن الثنائي كبير الحجم للصفحة المتميزة الحجم المسموح به وIOPS وعرض النطاق الترددي للكائن الثنائي كبير الحجم. تحدد طبقة كائن ثنائي كبير الحجم للكتلة نوع التخزين Hot/Cool/Archive. لا تقوم هذه العملية بتحديث ETag للكائن الثنائي كبير الحجم. راجع تعيين تفاصيل طبقة الكائن الثنائي كبير الحجم. ستتم مصادقة العملية (الطلب الفرعي) وتخويلها ببيانات اعتماد محددة. راجع تفاصيل تخويل دفعة كائن ثنائي كبير الحجم.

function setBlobsAccessTier(blobClients: BlobClient[], tier: AccessTier, options?: BlobSetTierOptions): Promise<BlobBatchSubmitBatchResponse>

المعلمات

blobClients

BlobClient[]

BlobClients للكائنات الثنائية كبيرة الحجم التي يجب أن تحتوي على مجموعة طبقة جديدة.

tier
AccessTier
options
BlobSetTierOptions

المرتجعات

Promise<BlobBatchSubmitBatchResponse>

setBlobsAccessTier(string[], StorageSharedKeyCredential | AnonymousCredential | TokenCredential, AccessTier, BlobSetTierOptions)

إنشاء عمليات طبقة متعددة لتعيين الطبقة على كائن ثنائي كبير الحجم. يسمح بالعملية على كائن ثنائي كبير الحجم للصفحة في حساب تخزين متميز وعلى كائن ثنائي كبير الحجم للكتلة في حساب تخزين كائن ثنائي كبير الحجم (تخزين متكرر محليا فقط). تحدد طبقة الكائن الثنائي كبير الحجم للصفحة المتميزة الحجم المسموح به وIOPS وعرض النطاق الترددي للكائن الثنائي كبير الحجم. تحدد طبقة كائن ثنائي كبير الحجم للكتلة نوع التخزين Hot/Cool/Archive. لا تقوم هذه العملية بتحديث ETag للكائن الثنائي كبير الحجم. راجع تعيين تفاصيل طبقة الكائن الثنائي كبير الحجم. ستتم مصادقة العملية (الطلب الفرعي) وتخويلها ببيانات اعتماد محددة. راجع تفاصيل تخويل دفعة كائن ثنائي كبير الحجم.

function setBlobsAccessTier(urls: string[], credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, tier: AccessTier, options?: BlobSetTierOptions): Promise<BlobBatchSubmitBatchResponse>

المعلمات

urls

string[]

عناوين URL لمورد الكائن الثنائي كبير الحجم المراد حذفها.

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

مثل AnonymousCredential أو StorageSharedKeyCredential أو أي بيانات اعتماد من الحزمة @azure/identity لمصادقة الطلبات إلى الخدمة. يمكنك أيضا توفير كائن ينفذ واجهة TokenCredential. إذا لم يتم تحديده، يتم استخدام AnonymousCredential.

tier
AccessTier
options
BlobSetTierOptions

المرتجعات

Promise<BlobBatchSubmitBatchResponse>

submitBatch(BlobBatch, BlobBatchSubmitBatchOptionalParams)

إرسال طلب الدفعة الذي يتكون من طلبات فرعية متعددة.

احصل على blobBatchClient التفاصيل والتفاصيل الأخرى قبل تشغيل القصاصات البرمجية. blobServiceClient.getBlobBatchClient() يعطي blobBatchClient

استخدام المثال:

let batchRequest = new BlobBatch();
await batchRequest.deleteBlob(urlInString0, credential0);
await batchRequest.deleteBlob(urlInString1, credential1, {
 deleteSnapshots: "include"
});
const batchResp = await blobBatchClient.submitBatch(batchRequest);
console.log(batchResp.subResponsesSucceededCount);

مثال على استخدام عقد إيجار:

let batchRequest = new BlobBatch();
await batchRequest.setBlobAccessTier(blockBlobClient0, "Cool");
await batchRequest.setBlobAccessTier(blockBlobClient1, "Cool", {
 conditions: { leaseId: leaseId }
});
const batchResp = await blobBatchClient.submitBatch(batchRequest);
console.log(batchResp.subResponsesSucceededCount);

راجع https://docs.microsoft.com/en-us/rest/api/storageservices/blob-batch

function submitBatch(batchRequest: BlobBatch, options?: BlobBatchSubmitBatchOptionalParams): Promise<BlobBatchSubmitBatchResponse>

المعلمات

batchRequest
BlobBatch

مجموعة من عمليات الحذف أو SetTier.

options
BlobBatchSubmitBatchOptionalParams

المرتجعات

Promise<BlobBatchSubmitBatchResponse>