QueueClient class

الحزمة:: @azure/storage-queue

يمثل QueueClient عنوان URL لرسائل Azure Storage Queue مما يسمح لك بمعالجة رسائلها.

يمتد: StorageClient

المنشئون

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

الخصائص

name	اسم قائمة الانتظار.

الخصائص الموروثة

accountName
url	قيمة سلسلة عنوان URL.

الأساليب

clearMessages(QueueClearMessagesOptions)	يؤدي مسح إلى حذف كافة الرسائل من قائمة انتظار. راجع https://learn.microsoft.com/rest/api/storageservices/clear-messages
create(QueueCreateOptions)	إنشاء قائمة انتظار جديدة ضمن الحساب المحدد. راجع https://learn.microsoft.com/rest/api/storageservices/create-queue4
createIfNotExists(QueueCreateOptions)	إنشاء قائمة انتظار جديدة ضمن الحساب المحدد إذا لم تكن موجودة بالفعل. إذا كانت قائمة الانتظار موجودة بالفعل، فلن يتم تغييرها. راجع https://learn.microsoft.com/rest/api/storageservices/create-queue4
delete(QueueDeleteOptions)	حذف قائمة الانتظار المحددة بشكل دائم. راجع https://learn.microsoft.com/rest/api/storageservices/delete-queue3
deleteIfExists(QueueDeleteOptions)	حذف قائمة الانتظار المحددة بشكل دائم إذا كانت موجودة. راجع https://learn.microsoft.com/rest/api/storageservices/delete-queue3
deleteMessage(string, string, QueueDeleteMessageOptions)	يقوم deleteMessage بإزالة الرسالة المحددة من قائمة الانتظار الخاصة بها بشكل دائم. راجع https://learn.microsoft.com/rest/api/storageservices/delete-message2
exists(QueueExistsOptions)	إرجاع true إذا كانت قائمة الانتظار المحددة موجودة؛ خطأ خلاف ذلك. ملاحظة: استخدم هذه الدالة بعناية حيث قد يتم حذف قائمة انتظار موجودة من قبل عملاء أو تطبيقات أخرى. العكس بالعكس قد تتم إضافة قوائم الانتظار الجديدة من قبل عملاء أو تطبيقات أخرى بعد اكتمال هذه الوظيفة.
generateSasStringToSign(QueueGenerateSasUrlOptions)	متوفر فقط ل QueueClient الذي تم إنشاؤه باستخدام بيانات اعتماد مفتاح مشترك. إنشاء سلسلة لتوقيع URI توقيع الوصول المشترك للخدمة (SAS) استنادا إلى خصائص العميل والمعلمات التي تم تمريرها. يتم توقيع SAS بواسطة بيانات اعتماد المفتاح المشترك للعميل. راجع https://learn.microsoft.com/rest/api/storageservices/constructing-a-service-sas
generateSasUrl(QueueGenerateSasUrlOptions)	متوفر فقط ل QueueClient الذي تم إنشاؤه باستخدام بيانات اعتماد مفتاح مشترك. إنشاء عنوان URI لتوقيع الوصول المشترك للخدمة (SAS) استنادا إلى خصائص العميل والمعلمات التي تم تمريرها. يتم توقيع SAS بواسطة بيانات اعتماد المفتاح المشترك للعميل. راجع https://learn.microsoft.com/rest/api/storageservices/constructing-a-service-sas
getAccessPolicy(QueueGetAccessPolicyOptions)	الحصول على تفاصيل حول أي نهج وصول مخزنة محددة في قائمة الانتظار التي يمكن استخدامها مع توقيعات الوصول المشترك. تحذير: من المحتمل أن يفقد تاريخ JavaScript الدقة عند تحليل سلسلة البدء وانتهاء الصلاحية. على سبيل المثال، التاريخ الجديد("2018-12-31T03:44:23.8827891Z").toISOString() سيحصل على "2018-12-31T03:44:23.882Z". راجع https://learn.microsoft.com/rest/api/storageservices/get-queue-acl
getProperties(QueueGetPropertiesOptions)	يحصل على جميع بيانات التعريف المعرفة من قبل المستخدم وخصائص النظام لقائمة الانتظار المحددة. بيانات التعريف مقترنة بقائمة الانتظار كأزواج قيم الاسم. راجع https://learn.microsoft.com/rest/api/storageservices/get-queue-metadata تحذير: سيكون للكائن `metadata` الذي تم إرجاعه في الاستجابة مفاتيحه بأحرف صغيرة، حتى لو احتوت في الأصل على أحرف كبيرة. يختلف هذا عن مفاتيح بيانات التعريف التي تم إرجاعها بواسطة الأسلوب `listQueues`QueueServiceClient باستخدام خيار `includeMetadata`، والذي سيحتفظ باغلفتها الأصلية.
peekMessages(QueuePeekMessagesOptions)	يسترد peekMessages رسالة واحدة أو أكثر من مقدمة قائمة الانتظار ولكنه لا يغير رؤية الرسالة. راجع https://learn.microsoft.com/rest/api/storageservices/peek-messages
receiveMessages(QueueReceiveMessageOptions)	يسترد receiveMessages رسالة واحدة أو أكثر من مقدمة قائمة الانتظار. راجع https://learn.microsoft.com/rest/api/storageservices/get-messages
sendMessage(string, QueueSendMessageOptions)	يضيف sendMessage رسالة جديدة إلى الجزء الخلفي من قائمة الانتظار. تحدد مهلة الرؤية المدة التي يجب أن تكون فيها الرسالة غير مرئية لعمليات Dequeue وPeek. يصل حجم محتوى الرسالة إلى 64 كيلوبايت، ويجب أن يكون بتنسيق يمكن تضمينه في طلب XML مع ترميز UTF-8. لتضمين العلامات في الرسالة، يجب أن تكون محتويات الرسالة إما مهربة من XML أو ترميز Base64. راجع https://learn.microsoft.com/rest/api/storageservices/put-message
setAccessPolicy(SignedIdentifier[], QueueSetAccessPolicyOptions)	تعيين نهج الوصول المخزنة لقائمة الانتظار التي يمكن استخدامها مع توقيعات الوصول المشترك. راجع https://learn.microsoft.com/rest/api/storageservices/set-queue-acl
setMetadata(Metadata, QueueSetMetadataOptions)	تعيين زوج واحد أو أكثر من أزواج قيمة الاسم المعرفة من قبل المستخدم لقائمة الانتظار المحددة. إذا لم يتم توفير أي خيار، أو لم يتم تحديد بيانات تعريف في معلمة الخيار، فستتم إزالة بيانات تعريف قائمة الانتظار. راجع https://learn.microsoft.com/rest/api/storageservices/set-queue-metadata
updateMessage(string, string, string, number, QueueUpdateMessageOptions)	يغير التحديث مهلة رؤية الرسالة ومحتوياتها. يصل حجم محتوى الرسالة إلى 64 كيلوبايت، ويجب أن يكون بتنسيق يمكن تضمينه في طلب XML مع ترميز UTF-8. لتضمين العلامات في الرسالة، يجب أن تكون محتويات الرسالة إما مهربة من XML أو ترميز Base64. راجع https://learn.microsoft.com/rest/api/storageservices/update-message

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

QueueClient(string, Pipeline)

إنشاء مثيل QueueClient.

new QueueClient(url: string, pipeline: Pipeline)

المعلمات

url: string

سلسلة URL تشير إلى قائمة انتظار Azure Storage، مثل "https://myaccount.queue.core.windows.net/myqueue". يمكنك إلحاق SAS إذا كنت تستخدم AnonymousCredential، مثل "https://myaccount.queue.core.windows.net/myqueue?sasString".

pipeline: Pipeline

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

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

إنشاء مثيل QueueClient.

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

المعلمات

url: string

credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential

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

options: StoragePipelineOptions

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

QueueClient(string, string, StoragePipelineOptions)

إنشاء مثيل QueueClient.

new QueueClient(connectionString: string, queueName: string, options?: StoragePipelineOptions)

المعلمات

connectionString: string

سلسلة اتصال الحساب أو سلسلة اتصال SAS لحساب تخزين Azure. [ ملاحظة - يمكن استخدام سلسلة اتصال الحساب فقط في وقت تشغيل NODE.JS. ] مثال سلسلة اتصال الحساب - DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=accountKey;EndpointSuffix=core.windows.net مثال سلسلة اتصال SAS - BlobEndpoint=https://myaccount.blob.core.windows.net/;QueueEndpoint=https://myaccount.queue.core.windows.net/;FileEndpoint=https://myaccount.file.core.windows.net/;TableEndpoint=https://myaccount.table.core.windows.net/;SharedAccessSignature=sasString

queueName: string

اسم قائمة الانتظار.

options: StoragePipelineOptions

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

تفاصيل الخاصية

name

اسم قائمة الانتظار.

string name

قيمة الخاصية

string

تفاصيل الخاصية الموروثة

accountName

accountName: string

قيمة الخاصية

string

موروث من StorageClient.accountName

url

قيمة سلسلة عنوان URL.

url: string

قيمة الخاصية

string

موروث من StorageClient.url

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

clearMessages(QueueClearMessagesOptions)

يؤدي مسح إلى حذف كافة الرسائل من قائمة انتظار.

راجع https://learn.microsoft.com/rest/api/storageservices/clear-messages

function clearMessages(options?: QueueClearMessagesOptions): Promise<MessagesClearResponse>

المعلمات

options: QueueClearMessagesOptions

خيارات لمسح عملية الرسائل.

المرتجعات

Promise<MessagesClearResponse>

بيانات الاستجابة لعملية مسح الرسائل.

create(QueueCreateOptions)

إنشاء قائمة انتظار جديدة ضمن الحساب المحدد.

راجع https://learn.microsoft.com/rest/api/storageservices/create-queue4

function create(options?: QueueCreateOptions): Promise<QueueCreateResponse>

المعلمات

options: QueueCreateOptions

خيارات لعملية إنشاء قائمة الانتظار.

المرتجعات

Promise<QueueCreateResponse>

بيانات الاستجابة لعملية إنشاء قائمة الانتظار.

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

import { QueueServiceClient } from "@azure/storage-queue";
import { DefaultAzureCredential } from "@azure/identity";

const account = "<account>";
const queueServiceClient = new QueueServiceClient(
  `https://${account}.queue.core.windows.net`,
  new DefaultAzureCredential(),
);

const queueName = "<valid queue name>";
const queueClient = queueServiceClient.getQueueClient(queueName);
const createQueueResponse = await queueClient.create();
console.log(
  `Created queue ${queueName} successfully, service assigned request Id: ${createQueueResponse.requestId}`,
);

createIfNotExists(QueueCreateOptions)

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

راجع https://learn.microsoft.com/rest/api/storageservices/create-queue4

function createIfNotExists(options?: QueueCreateOptions): Promise<QueueCreateIfNotExistsResponse>

المعلمات

options: QueueCreateOptions

المرتجعات

Promise<QueueCreateIfNotExistsResponse>

delete(QueueDeleteOptions)

حذف قائمة الانتظار المحددة بشكل دائم.

راجع https://learn.microsoft.com/rest/api/storageservices/delete-queue3

function delete(options?: QueueDeleteOptions): Promise<QueueDeleteResponse>

المعلمات

options: QueueDeleteOptions

خيارات لعملية حذف قائمة الانتظار.

المرتجعات

Promise<QueueDeleteResponse>

بيانات الاستجابة لعملية حذف قائمة الانتظار.

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

import { QueueServiceClient } from "@azure/storage-queue";
import { DefaultAzureCredential } from "@azure/identity";

const account = "<account>";
const queueServiceClient = new QueueServiceClient(
  `https://${account}.queue.core.windows.net`,
  new DefaultAzureCredential(),
);

const queueName = "<valid queue name>";
const queueClient = queueServiceClient.getQueueClient(queueName);
const deleteQueueResponse = await queueClient.delete();
console.log(
  `Deleted queue successfully, service assigned request Id: ${deleteQueueResponse.requestId}`,
);

deleteIfExists(QueueDeleteOptions)

حذف قائمة الانتظار المحددة بشكل دائم إذا كانت موجودة.

راجع https://learn.microsoft.com/rest/api/storageservices/delete-queue3

function deleteIfExists(options?: QueueDeleteOptions): Promise<QueueDeleteIfExistsResponse>

المعلمات

options: QueueDeleteOptions

المرتجعات

Promise<QueueDeleteIfExistsResponse>

deleteMessage(string, string, QueueDeleteMessageOptions)

يقوم deleteMessage بإزالة الرسالة المحددة من قائمة الانتظار الخاصة بها بشكل دائم.

راجع https://learn.microsoft.com/rest/api/storageservices/delete-message2

function deleteMessage(messageId: string, popReceipt: string, options?: QueueDeleteMessageOptions): Promise<MessageIdDeleteResponse>

المعلمات

messageId: string

معرف الرسالة.

popReceipt: string

قيمة إيصال pop صالحة تم إرجاعها من مكالمة سابقة إلى رسائل الاستلام أو عملية تحديث الرسالة.

options: QueueDeleteMessageOptions

خيارات لحذف عملية الرسالة.

المرتجعات

Promise<MessageIdDeleteResponse>

بيانات الاستجابة لعملية حذف الرسالة.

exists(QueueExistsOptions)

إرجاع true إذا كانت قائمة الانتظار المحددة موجودة؛ خطأ خلاف ذلك.

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

function exists(options?: QueueExistsOptions): Promise<boolean>

المعلمات

options: QueueExistsOptions

خيارات لعملية Exists.

المرتجعات

Promise<boolean>

generateSasStringToSign(QueueGenerateSasUrlOptions)

متوفر فقط ل QueueClient الذي تم إنشاؤه باستخدام بيانات اعتماد مفتاح مشترك.

إنشاء سلسلة لتوقيع URI توقيع الوصول المشترك للخدمة (SAS) استنادا إلى خصائص العميل والمعلمات التي تم تمريرها. يتم توقيع SAS بواسطة بيانات اعتماد المفتاح المشترك للعميل.

راجع https://learn.microsoft.com/rest/api/storageservices/constructing-a-service-sas

function generateSasStringToSign(options: QueueGenerateSasUrlOptions): string

المعلمات

options: QueueGenerateSasUrlOptions

المعلمات الاختيارية.

المرتجعات

string

SAS URI الذي يتكون من URI للمورد الذي يمثله هذا العميل، متبوعا بالرمز المميز SAS الذي تم إنشاؤه.

generateSasUrl(QueueGenerateSasUrlOptions)

متوفر فقط ل QueueClient الذي تم إنشاؤه باستخدام بيانات اعتماد مفتاح مشترك.

إنشاء عنوان URI لتوقيع الوصول المشترك للخدمة (SAS) استنادا إلى خصائص العميل والمعلمات التي تم تمريرها. يتم توقيع SAS بواسطة بيانات اعتماد المفتاح المشترك للعميل.

راجع https://learn.microsoft.com/rest/api/storageservices/constructing-a-service-sas

function generateSasUrl(options: QueueGenerateSasUrlOptions): string

المعلمات

options: QueueGenerateSasUrlOptions

المعلمات الاختيارية.

المرتجعات

string

SAS URI الذي يتكون من URI للمورد الذي يمثله هذا العميل، متبوعا بالرمز المميز SAS الذي تم إنشاؤه.

getAccessPolicy(QueueGetAccessPolicyOptions)

الحصول على تفاصيل حول أي نهج وصول مخزنة محددة في قائمة الانتظار التي يمكن استخدامها مع توقيعات الوصول المشترك.

تحذير: من المحتمل أن يفقد تاريخ JavaScript الدقة عند تحليل سلسلة البدء وانتهاء الصلاحية. على سبيل المثال، التاريخ الجديد("2018-12-31T03:44:23.8827891Z").toISOString() سيحصل على "2018-12-31T03:44:23.882Z".

راجع https://learn.microsoft.com/rest/api/storageservices/get-queue-acl

function getAccessPolicy(options?: QueueGetAccessPolicyOptions): Promise<QueueGetAccessPolicyResponse>

المعلمات

options: QueueGetAccessPolicyOptions

خيارات قائمة الانتظار الحصول على عملية نهج الوصول.

المرتجعات

Promise<QueueGetAccessPolicyResponse>

بيانات الاستجابة لعملية نهج الوصول إلى قائمة الانتظار.

getProperties(QueueGetPropertiesOptions)

يحصل على جميع بيانات التعريف المعرفة من قبل المستخدم وخصائص النظام لقائمة الانتظار المحددة. بيانات التعريف مقترنة بقائمة الانتظار كأزواج قيم الاسم.

راجع https://learn.microsoft.com/rest/api/storageservices/get-queue-metadata

تحذير: سيكون للكائن metadata الذي تم إرجاعه في الاستجابة مفاتيحه بأحرف صغيرة، حتى لو احتوت في الأصل على أحرف كبيرة. يختلف هذا عن مفاتيح بيانات التعريف التي تم إرجاعها بواسطة الأسلوب listQueuesQueueServiceClient باستخدام خيار includeMetadata، والذي سيحتفظ باغلفتها الأصلية.

function getProperties(options?: QueueGetPropertiesOptions): Promise<QueueGetPropertiesResponse>

المعلمات

options: QueueGetPropertiesOptions

خيارات قائمة الانتظار الحصول على عملية الخصائص.

المرتجعات

Promise<QueueGetPropertiesResponse>

بيانات الاستجابة لعملية الحصول على خصائص قائمة الانتظار.

peekMessages(QueuePeekMessagesOptions)

يسترد peekMessages رسالة واحدة أو أكثر من مقدمة قائمة الانتظار ولكنه لا يغير رؤية الرسالة.

راجع https://learn.microsoft.com/rest/api/storageservices/peek-messages

function peekMessages(options?: QueuePeekMessagesOptions): Promise<QueuePeekMessagesResponse>

المعلمات

options: QueuePeekMessagesOptions

خيارات لعملية الرسائل خاطفة.

المرتجعات

Promise<QueuePeekMessagesResponse>

بيانات الاستجابة لعملية رسائل النظرة الخاطفة.

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

import { QueueServiceClient } from "@azure/storage-queue";
import { DefaultAzureCredential } from "@azure/identity";

const account = "<account>";
const queueServiceClient = new QueueServiceClient(
  `https://${account}.queue.core.windows.net`,
  new DefaultAzureCredential(),
);

const queueName = "<valid queue name>";
const queueClient = queueServiceClient.getQueueClient(queueName);
const peekMessagesResponse = await queueClient.peekMessages();
console.log(`The peeked message is: ${peekMessagesResponse.peekedMessageItems[0].messageText}`);

receiveMessages(QueueReceiveMessageOptions)

يسترد receiveMessages رسالة واحدة أو أكثر من مقدمة قائمة الانتظار.

راجع https://learn.microsoft.com/rest/api/storageservices/get-messages

function receiveMessages(options?: QueueReceiveMessageOptions): Promise<QueueReceiveMessageResponse>

المعلمات

options: QueueReceiveMessageOptions

خيارات لتلقي عملية الرسائل.

المرتجعات

Promise<QueueReceiveMessageResponse>

بيانات الاستجابة لعملية تلقي الرسائل.

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

import { QueueServiceClient } from "@azure/storage-queue";
import { DefaultAzureCredential } from "@azure/identity";

const account = "<account>";
const queueServiceClient = new QueueServiceClient(
  `https://${account}.queue.core.windows.net`,
  new DefaultAzureCredential(),
);

const queueName = "<valid queue name>";
const queueClient = queueServiceClient.getQueueClient(queueName);
const response = await queueClient.receiveMessages();
if (response.receivedMessageItems.length === 1) {
  const receivedMessageItem = response.receivedMessageItems[0];
  console.log(`Processing & deleting message with content: ${receivedMessageItem.messageText}`);
  const deleteMessageResponse = await queueClient.deleteMessage(
    receivedMessageItem.messageId,
    receivedMessageItem.popReceipt,
  );
  console.log(
    `Delete message successfully, service assigned request Id: ${deleteMessageResponse.requestId}`,
  );
}

sendMessage(string, QueueSendMessageOptions)

يضيف sendMessage رسالة جديدة إلى الجزء الخلفي من قائمة الانتظار. تحدد مهلة الرؤية المدة التي يجب أن تكون فيها الرسالة غير مرئية لعمليات Dequeue وPeek. يصل حجم محتوى الرسالة إلى 64 كيلوبايت، ويجب أن يكون بتنسيق يمكن تضمينه في طلب XML مع ترميز UTF-8. لتضمين العلامات في الرسالة، يجب أن تكون محتويات الرسالة إما مهربة من XML أو ترميز Base64.

راجع https://learn.microsoft.com/rest/api/storageservices/put-message

function sendMessage(messageText: string, options?: QueueSendMessageOptions): Promise<QueueSendMessageResponse>

المعلمات

messageText: string

نص الرسالة المراد إرسالها

options: QueueSendMessageOptions

خيارات لإرسال عملية الرسائل.

المرتجعات

Promise<QueueSendMessageResponse>

بيانات الاستجابة لعملية إرسال الرسائل.

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

import { QueueServiceClient } from "@azure/storage-queue";
import { DefaultAzureCredential } from "@azure/identity";

const account = "<account>";
const queueServiceClient = new QueueServiceClient(
  `https://${account}.queue.core.windows.net`,
  new DefaultAzureCredential(),
);

const queueName = "<valid queue name>";
const queueClient = queueServiceClient.getQueueClient(queueName);
// Send a message into the queue using the sendMessage method.
const sendMessageResponse = await queueClient.sendMessage("Hello World!");
console.log(
  `Sent message successfully, service assigned message Id: ${sendMessageResponse.messageId}, service assigned request Id: ${sendMessageResponse.requestId}`,
);

setAccessPolicy(SignedIdentifier[], QueueSetAccessPolicyOptions)

تعيين نهج الوصول المخزنة لقائمة الانتظار التي يمكن استخدامها مع توقيعات الوصول المشترك.

راجع https://learn.microsoft.com/rest/api/storageservices/set-queue-acl

function setAccessPolicy(queueAcl?: SignedIdentifier[], options?: QueueSetAccessPolicyOptions): Promise<QueueSetAccessPolicyResponse>

المعلمات

queueAcl: SignedIdentifier[]

options: QueueSetAccessPolicyOptions

خيارات قائمة الانتظار تعيين عملية نهج الوصول.

المرتجعات

Promise<QueueSetAccessPolicyResponse>

بيانات الاستجابة لعملية نهج الوصول لمجموعة الانتظار.

setMetadata(Metadata, QueueSetMetadataOptions)

تعيين زوج واحد أو أكثر من أزواج قيمة الاسم المعرفة من قبل المستخدم لقائمة الانتظار المحددة.

إذا لم يتم توفير أي خيار، أو لم يتم تحديد بيانات تعريف في معلمة الخيار، فستتم إزالة بيانات تعريف قائمة الانتظار.

راجع https://learn.microsoft.com/rest/api/storageservices/set-queue-metadata

function setMetadata(metadata?: Metadata, options?: QueueSetMetadataOptions): Promise<QueueSetMetadataResponse>

المعلمات

metadata: Metadata

إذا لم يتم توفير بيانات تعريف، فستتم إزالة جميع بيانات التعريف الموجودة.

options: QueueSetMetadataOptions

خيارات لقائمة الانتظار تعيين عملية بيانات التعريف.

المرتجعات

Promise<QueueSetMetadataResponse>

بيانات الاستجابة لعملية بيانات تعريف مجموعة قائمة الانتظار.

updateMessage(string, string, string, number, QueueUpdateMessageOptions)

يغير التحديث مهلة رؤية الرسالة ومحتوياتها. يصل حجم محتوى الرسالة إلى 64 كيلوبايت، ويجب أن يكون بتنسيق يمكن تضمينه في طلب XML مع ترميز UTF-8. لتضمين العلامات في الرسالة، يجب أن تكون محتويات الرسالة إما مهربة من XML أو ترميز Base64.

راجع https://learn.microsoft.com/rest/api/storageservices/update-message

function updateMessage(messageId: string, popReceipt: string, message?: string, visibilityTimeout?: number, options?: QueueUpdateMessageOptions): Promise<MessageIdUpdateResponse>

المعلمات

messageId: string

معرف الرسالة

popReceipt: string

قيمة إيصال pop صالحة تم إرجاعها من مكالمة سابقة إلى رسائل الاستلام أو عملية تحديث الرسالة.

message: string

رسالة للتحديث. إذا كانت هذه المعلمة غير معرفة، فلن يتم تحديث محتوى الرسالة.

visibilityTimeout: number

تحديد قيمة مهلة الرؤية الجديدة، بالثوان، بالنسبة إلى وقت الخادم. يجب أن تكون القيمة الجديدة أكبر من أو تساوي 0، ولا يمكن أن تكون أكبر من 7 أيام. لا يمكن تعيين مهلة رؤية الرسالة إلى قيمة بعد وقت انتهاء الصلاحية. يمكن تحديث رسالة حتى يتم حذفها أو انتهاء صلاحيتها.

options: QueueUpdateMessageOptions

خيارات لتحديث عملية الرسالة.

المرتجعات

Promise<MessageIdUpdateResponse>

بيانات الاستجابة لعملية رسالة التحديث.

مشاركة عبر

QueueClient class

المنشئون

الخصائص

الخصائص الموروثة

الأساليب

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

QueueClient(string, Pipeline)

المعلمات

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

المعلمات

QueueClient(string, string, StoragePipelineOptions)

المعلمات

تفاصيل الخاصية

name

قيمة الخاصية

تفاصيل الخاصية الموروثة

accountName

قيمة الخاصية

url

قيمة الخاصية

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

clearMessages(QueueClearMessagesOptions)

المعلمات

المرتجعات

create(QueueCreateOptions)

المعلمات

المرتجعات

createIfNotExists(QueueCreateOptions)

المعلمات

المرتجعات

delete(QueueDeleteOptions)

المعلمات

المرتجعات

deleteIfExists(QueueDeleteOptions)

المعلمات

المرتجعات

deleteMessage(string, string, QueueDeleteMessageOptions)

المعلمات

المرتجعات

exists(QueueExistsOptions)

المعلمات

المرتجعات

generateSasStringToSign(QueueGenerateSasUrlOptions)

المعلمات

المرتجعات

generateSasUrl(QueueGenerateSasUrlOptions)

المعلمات

المرتجعات

getAccessPolicy(QueueGetAccessPolicyOptions)

المعلمات

المرتجعات

getProperties(QueueGetPropertiesOptions)

المعلمات

المرتجعات

peekMessages(QueuePeekMessagesOptions)

المعلمات

المرتجعات

receiveMessages(QueueReceiveMessageOptions)

المعلمات

المرتجعات

sendMessage(string, QueueSendMessageOptions)

المعلمات

المرتجعات

setAccessPolicy(SignedIdentifier[], QueueSetAccessPolicyOptions)

المعلمات

المرتجعات

setMetadata(Metadata, QueueSetMetadataOptions)

المعلمات

المرتجعات

updateMessage(string, string, string, number, QueueUpdateMessageOptions)

المعلمات

المرتجعات