مشاركة عبر

BlobBatchClient class

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

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

راجع https://learn.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://learn.microsoft.com/en-us/rest/api/storageservices/blob-batch

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

BlobBatchClient(string, PipelineLike)

إنشاء مثيل BlobBatchClient.

new BlobBatchClient(url: string, pipeline: PipelineLike)

المعلمات

url

string

عنوان url يشير إلى خدمة Azure Storage blob، مثل "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 blob، مثل "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://learn.microsoft.com/en-us/rest/api/storageservices/blob-batch

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

المعلمات

batchRequest
BlobBatch

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

options
BlobBatchSubmitBatchOptionalParams

المرتجعات

Promise<BlobBatchSubmitBatchResponse>