إدارة خصائص الحاوية وبيانات التعريف باستخدام JavaScript أو TypeScript

• NET.
• Java
• JavaScript
• Python
• ذهب

تدعم حاويات Blob خصائص النظام وبيانات التعريف المحددة مسبقًا من قبل المستخدم، بالإضافة إلى البيانات التي تحتوي عليها. توضح هذه المقالة كيفية إدارة خصائص النظام وبيانات التعريف المعرفة من قبل المستخدم باستخدام مكتبة عميل تخزين Azure لـ JavaScript.

المتطلبات الأساسية

• تفترض الأمثلة في هذه المقالة أن لديك بالفعل مشروعا تم إعداده للعمل مع مكتبة عميل Azure Blob Storage ل JavaScript. للتعرف على إعداد مشروعك، بما في ذلك تثبيت الحزمة، واستيراد الوحدات النمطية، وإنشاء كائن عميل معتمد للعمل مع موارد البيانات، راجع بدء استخدام Azure Blob Storage وJavaScript.
• يجب أن يكون لآلية التخويل أذونات للعمل مع خصائص الحاوية أو بيانات التعريف. لمعرفة المزيد، راجع إرشادات التخويل لعمليات واجهة برمجة تطبيقات REST التالية:
  • الحصول على خصائص الحاوية
  • تعيين بيانات تعريف الحاوية
  • الحصول على بيانات تعريف الحاوية

نبذة عن الخصائص وبيانات التعريف

• خصائص النظام: توجد خصائص النظام على كل مورد تخزين Blob. يمكن قراءة بعضها أو تعيينها، بينما البعض الآخر للقراءة فقط. تحت الأغلفة، تتوافق بعض خصائص النظام مع بعض عناوين HTTP القياسية المعينة. تحتفظ مكتبة عميل تخزين Azure Storage لـ JavaScript بهذه الخصائص لك.

• بيانات التعريف المحددة مسبقًا من المستخدم: تتكون بيانات التعريف المحددة مسبقًا من المستخدم من زوج واحد أو أكثر من أزواج قيمة الاسم التي تحددها لمورد تخزين Blob. يمكنك استخدام بيانات التعريف لتخزين قيم إضافية مع المورد. قيم بيانات التعريف هي لأغراضك فقط، ولا تؤثر على كيفية تصرف المورد.

  أزواج اسم/قيمة بيانات التعريف هي رؤوس HTTP صالحة ويجب أن تلتزم بجميع القيود التي تحكم رؤوس HTTP. لمزيد من المعلومات حول متطلبات تسمية بيانات التعريف، راجع أسماء بيانات التعريف.

استرداد خصائص الحاوية

لاسترداد خصائص الحاوية، استخدم الأسلوب التالي:

• ContainerClient.getProperties

يجلب مثال التعليمات البرمجية التالي خصائص الحاوية ويكتب بعض قيم الخصائص إلى نافذة وحدة التحكم:

JavaScript

async function getContainerProperties(containerClient) {
  
  try {
    const containerProperties = await containerClient.getProperties();

    console.log(`Public access type: ${containerProperties.blobPublicAccess}`);
    console.log(`Lease status: ${containerProperties.leaseStatus}`);
    console.log(`Lease state: ${containerProperties.leaseState}`);
    console.log(`Has immutability policy: ${containerProperties.hasImmutabilityPolicy}`);
  } catch (err) {
    // Handle the error
  }
}

TypeScript

async function getContainerProperties(
  containerClient: ContainerClient
): Promise<void> {

  try {
    const containerProperties: ContainerGetPropertiesResponse =
      await containerClient.getProperties();

      console.log(`Public access type: ${containerProperties.blobPublicAccess}`);
      console.log(`Lease status: ${containerProperties.leaseStatus}`);
      console.log(`Lease state: ${containerProperties.leaseState}`);
      console.log(`Has immutability policy: ${containerProperties.hasImmutabilityPolicy}`);
  } catch (err) {
    // Handle the error
  }
}

تعيين بيانات التعريف واستردادها

يمكنك تحديد بيانات التعريف كزوج واحد أو أكثر من أزواج اسم-قيمة مورد الحاوية. لتعيين بيانات التعريف، قم بإنشاء كائن ContainerClient ثم استخدم الأسلوب التالي:

• ContainerClient.setMetadata

يعين مثال التعليمات البرمجية التالي بيانات التعريف على حاوية:

JavaScript

async function setContainerMetadata(containerClient) {
  
  const metadata = {
    docType: "textDocuments",
    docCategory: "testing",
  };
  
  await containerClient.setMetadata(metadata);

}

TypeScript

async function setContainerMetadata(
  containerClient: ContainerClient,
) {
  
  try {
    const metadata: Metadata = {
      // values must be strings
      docType: "textDocuments",
      docCategory: "testing"
    };
    await containerClient.setMetadata(metadata);
  }
  catch (err) {
    // Handle the error
  }
}

لاسترداد بيانات التعريف، احصل على خصائص الحاوية ثم استخدم خاصية بيانات التعريف التي تم إرجاعها.

الموارد

لمعرفة المزيد حول إعداد خصائص الحاوية وبيانات التعريف واستردادها باستخدام مكتبة عميل Azure Blob Storage ل JavaScript، راجع الموارد التالية.

نماذج التعليمات البرمجية

• عرض نماذج التعليمات البرمجية JavaScript وTypeScript من هذه المقالة (GitHub)

عمليات واجهة برمجة تطبيقات REST

يحتوي Azure SDK ل JavaScript على مكتبات تستند إلى واجهة برمجة تطبيقات AZURE REST، ما يسمح لك بالتفاعل مع عمليات REST API من خلال نماذج JavaScript المألوفة. تستخدم أساليب مكتبة العميل لإعداد واسترداد الخصائص وبيانات التعريف عمليات واجهة برمجة تطبيقات REST التالية:

• الحصول على خصائص الحاوية (REST API)
• تعيين بيانات تعريف الحاوية (REST API)
• الحصول على بيانات تعريف الحاوية (REST API)

يسترد getProperties الأسلوب خصائص الحاوية وبيانات التعريف عن طريق استدعاء كل من عملية Get Blob Properties والعملية Get Blob Metadata .

موارد مكتبة العميل

• الوثائق المرجعية لمكتبة العميل
• التعليمات البرمجية لمصدر مكتبة عميل
• الحزمة (npm)