نظرة عامة على موفري الموارد المخصصين لـ Azure

  • مقالة

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

  • كيفية استخدام وتوزيع موفر موارد Azure المخصص.
  • كيفية استخدام موفري موارد Azure المخصصين لتوسيع مهام سير العمل الموجودة.
  • أين يمكن العثور على أدلة وعينات التعليمات البرمجية للبدء.

رسم تخطيطي لموفري موارد Azure المخصصة، يعرض العلاقة بين Resource Manager Azure وموفري الموارد المخصصة والموارد.

هام

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

ما الذي يمكن أن يفعله موفرو الموارد المخصصون

فيما يلي بعض الأمثلة لما يمكنك تحقيقه باستخدام موفري موارد Azure المخصصين:

  • توسيع واجهة برمجة تطبيقات REST لـ Azure Resource Manager لتضمين الخدمات الداخلية والخارجية.
  • تمكين السيناريوهات المخصصة بالإضافة إلى مهام سير عمل Azure الموجودة.
  • تخصيص عنصر تحكم وتأثير Azure Resource Manager.

ما هو موفر الموارد المخصصين

يتم إنشاء موفري موارد Azure المخصصين عن طريق إنشاء اتفاق بين Azure ونقطة نهاية. يعرف هذا الاتفاق قائمة بالموارد والإجراءات الجديدة من خلال مورد جديد، Microsoft.CustomProviders/resourceProviders. سيقوم بعد ذلك موفر الموارد المخصص بعرض واجهات برمجة التطبيقات الجديدة هذه في Azure. يشتمل موفري موارد Azure المخصصين من ثلاثة أجزاء: موفر الموارد المخصصين، ونقاط النهاية، والموارد المخصصة.

كيفية إنشاء موفري الموارد المخصصين

موفرو الموارد المخصصين هي قائمة اتفاقات بين Azure ونقاط النهاية. تصف هذه العقود كيفية تفاعل Azure مع نقاط النهاية الخاصة بها. يعمل موفرو الموارد كوكيل وسيقومون بإعادة توجيه الطلبات والاستجابات من وإلى نقطة النهاية المحددة الخاصة بهم. يمكن لموفر الموارد تحديد نوعين من الاتفاقات: resourceTypes وactions. يتم تمكين ذلك من خلال تعريفات نقطة النهاية. يتكون تعريف نقطة النهاية من ثلاثة حقول: الاسم، وroutingType وونقطة النهاية.

عينة نقطة النهاية:

{
  "name": "{endpointDefinitionName}",
  "routingType": "Proxy",
  "endpoint": "https://{endpointURL}/"
}
الخاصية مطلوب الوصف
الاسم نعم اسم تعريف نقطة النهاية. سيعرض Azure هذا الاسم من خلال واجهة برمجة التطبيقات الخاصة به ضمن '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/
resourceProviders/{resourceProviderName}/{endpointDefinitionName}'
routingType لا تحديد نوع الاتفاق مع نقطة النهاية. إذا لم يتم التحديد، فإنه سيتم تحديد "الوكيل" افتراضياً.
نقطة النهاية نعم نقطة النهاية المطلوب توجيه الطلبات إليها. تعالج نقطة النهاية هذه الاستجابة وأي آثار جانبية للطلب.

إنشاء الموارد المخصصة

تصف ResourceTypes الموارد المخصصة الجديدة التي تمت إضافتها إلى Azure. يكشف ذلك عن أساليب RESTful CRUD الأساسية. راجع المزيد حول إنشاء موارد مخصصة

عينة موفر الموارد المخصصة باستخدام resourceTypes:

{
  "properties": {
    "resourceTypes": [
      {
        "name": "myCustomResources",
        "routingType": "Proxy",
        "endpoint": "https://{endpointURL}/"
      }
    ]
  },
  "location": "eastus"
}

واجهات برمجة التطبيقات المضافة إلى Azure للعينة أعلاه:

HttpMethod عينة URI الوصف
PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources/{customResourceName}?api-version=2018-09-01-preview		 استدعاء واجهة برمجة تطبيقات REST لـ Azure لإنشاء مورد جديد.
DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources/{customResourceName}?api-version=2018-09-01-preview		 استدعاء واجهة برمجة تطبيقات REST لـ Azure لحذف مورد موجود.
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources/{customResourceName}?api-version=2018-09-01-preview		 استدعاء واجهة برمجة تطبيقات REST لـ Azure لاسترداد مورد موجود.
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources?api-version=2018-09-01-preview		 استدعاء واجهة برمجة تطبيقات REST لـ Azure لاسترداد قائمة الموارد الموجودة.

إنشاء الإجراءات المخصصة

تصف الإجراءات الإجراءات الجديدة التي تمت إضافتها إلى Azure. يمكن عرض هذه بالإضافة إلى موفر الموارد أو متداخلة ضمن resourceType. راجع المزيد حول إنشاء موارد مخصصة

عينة موفر الموارد المخصصة باستخدام actions:

{
  "properties": {
    "actions": [
      {
        "name": "myCustomAction",
        "routingType": "Proxy",
        "endpoint": "https://{endpointURL}/"
      }
    ]
  },
  "location": "eastus"
}

واجهات برمجة التطبيقات المضافة إلى Azure للعينة أعلاه:

HttpMethod عينة URI الوصف
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomAction?api-version=2018-09-01-preview		 استدعاء واجهة برمجة تطبيقات REST لـ Azure لتنشيط الإجراء.

البحث عن المساعدة

إذا كانت لديك أسئلة حول تطوير موفري موارد Azure المخصصين، فجرب طرحها في تجاوز سعة مكدس الذاكرة المؤقتة. من الممكن أن يكون قد تم طرح السؤال نفسه والإجابة عنه؛ لذا تحقق أولاً قبل النشر. إضافة العلامة azure-custom-providers للحصول على استجابة سريعة!

الخطوات التالية

في هذه المقالة، تعرفت على موفري الموارد المخصصة. انتقل إلى المقالة التالية لإنشاء موفر موارد مخصص.