مشاركة عبر

Microsoft.ApiManagement service/backends 2022-08-01

  • مقالة

تعريف مورد Bicep

يمكن نشر نوع مورد الخدمة/الخلفيات مع العمليات التي تستهدف:

  • مجموعات الموارد - راجع أوامر نشر مجموعة الموارد

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

تنسيق المورد

لإنشاء مورد Microsoft.ApiManagement/service/backends، أضف Bicep التالي إلى القالب الخاص بك.

resource symbolicname 'Microsoft.ApiManagement/service/backends@2022-08-01' = {
  name: 'string'
  parent: resourceSymbolicName
  properties: {
    credentials: {
      authorization: {
        parameter: 'string'
        scheme: 'string'
      }
      certificate: [
        'string'
      ]
      certificateIds: [
        'string'
      ]
      header: {
        {customized property}: [
          'string'
        ]
      }
      query: {
        {customized property}: [
          'string'
        ]
      }
    }
    description: 'string'
    properties: {
      serviceFabricCluster: {
        clientCertificateId: 'string'
        clientCertificatethumbprint: 'string'
        managementEndpoints: [
          'string'
        ]
        maxPartitionResolutionRetries: int
        serverCertificateThumbprints: [
          'string'
        ]
        serverX509Names: [
          {
            issuerCertificateThumbprint: 'string'
            name: 'string'
          }
        ]
      }
    }
    protocol: 'string'
    proxy: {
      password: 'string'
      url: 'string'
      username: 'string'
    }
    resourceId: 'string'
    title: 'string'
    tls: {
      validateCertificateChain: bool
      validateCertificateName: bool
    }
    url: 'string'
  }
}

قيم الخصائص

الخدمة/الخلفيات

اسم وصف قيمة
اسم اسم المورد

راجع كيفية تعيين الأسماء والأنواع للموارد التابعة في Bicep.		 سلسلة (مطلوب)

حد الحرف: 1-80

الأحرف الصالحة:
الأبجدية الرقمية والواصلات.

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

لمزيد من المعلومات، راجع مورد تابع خارج المورد الأصل.		 اسم رمزي للمورد من النوع: خدمة
خصائص خصائص عقد كيان الواجهة الخلفية. BackendContractProperties

الخصائص الخلفية

اسم وصف قيمة
وثائق التفويض خصائص تعاقد بيانات اعتماد الواجهة الخلفية BackendCredentialsContract
وصف وصف الخلفية. خيط

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 2000
خصائص عقد خصائص الخلفية BackendProperties
بروتوكول بروتوكول الاتصال الخلفي. 'http'
'soap' (مطلوب)
الوكيل خصائص عقد بوابة الواجهة الخلفية BackendProxyContract
معرف المورد إدارة Uri للمورد في النظام الخارجي. يمكن أن يكون عنوان URL هذا معرف مورد Arm لتطبيقات المنطق أو تطبيقات الوظائف أو تطبيقات واجهة برمجة التطبيقات. خيط

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 2000
عنوان عنوان الواجهة الخلفية. خيط

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 300
tls خصائص TLS الخلفية BackendTlsProperties
url عنوان URL لوقت التشغيل للواجهة الخلفية. سلسلة (مطلوب)

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 2000

تم التعاقد مع BackendCredentials

اسم وصف قيمة
إذن مصادقة عنوان التخويل BackendAuthorizationHeaderCredentials
شهادة قائمة بصمات إبهام شهادة العميل. سيتم تجاهلها إذا تم توفير certificatesIds. سلسلة[]

القيود:
الحد الأقصى للطول = 32
معرفات الشهادة قائمة معرفات شهادة العميل. سلسلة[]

القيود:
الحد الأقصى للطول = 32
راس وصف معلمة الرأس. BackendCredentialsContractHeader
استفسار وصف معلمة الاستعلام. BackendCredentialsContractQuery

BackendAuthorizationHeaderCredentials

اسم وصف قيمة
البارامتر قيمة معلمة المصادقة. سلسلة (مطلوب)

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 300
نظام اسم نظام المصادقة. سلسلة (مطلوب)

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 100

BackendCredentialsContractHeader

اسم وصف قيمة
{خاصية مخصصة} سلسلة[]

BackendCredentialsContractQuery

اسم وصف قيمة
{خاصية مخصصة} سلسلة[]

خصائص الخلفية

اسم وصف قيمة
serviceFabricCluster خصائص مجموعة نسيج الخدمة الخلفية BackendServiceFabricClusterProperties

خصائص الخوادم الخلفيةFabricCluperties

اسم وصف قيمة
clientCertificateId معرف شهادة العميل لنقطة نهاية الإدارة. خيط
clientCertificatethumbprint بصمة إبهام شهادة العميل لنقطة نهاية الإدارة. سيتم تجاهلها إذا تم توفير certificatesIds خيط
نقاط نهاية الإدارة نقطة نهاية إدارة نظام المجموعة. string[] (مطلوبة)
maxPartitionResolutionRetries الحد الأقصى لعدد مرات إعادة المحاولة أثناء محاولة حل القسم. الباحث
serverCertificateThumbprints بصمة الإبهام لخدمة إدارة نظام مجموعة الشهادات تستخدم لاتصال tls سلسلة[]
أسماء serverX509 مجموعة أسماء شهادات Server X509 X509CertificateName[]

X509CertificateName

اسم وصف قيمة
issuerCertificateThumbprint بصمة الإبهام لمصدر الشهادة. خيط
اسم الاسم الشائع للشهادة. خيط

BackendProxyContract

اسم وصف قيمة
شعار كلمة المرور للاتصال بخادم WebProxy خيط
url خاصية WebProxy Server AbsoluteUri التي تتضمن URI بأكمله المخزن في مثيل Uri، بما في ذلك جميع الأجزاء وسلاسل الاستعلام. سلسلة (مطلوب)

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 2000
اسم المستخدم اسم المستخدم للاتصال بخادم WebProxy خيط

خصائص الخلفية

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

تعريف مورد قالب ARM

يمكن نشر نوع مورد الخدمة/الخلفيات مع العمليات التي تستهدف:

  • مجموعات الموارد - راجع أوامر نشر مجموعة الموارد

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

تنسيق المورد

لإنشاء مورد Microsoft.ApiManagement/service/backends، أضف JSON التالي إلى القالب الخاص بك.

{
  "type": "Microsoft.ApiManagement/service/backends",
  "apiVersion": "2022-08-01",
  "name": "string",
  "properties": {
    "credentials": {
      "authorization": {
        "parameter": "string",
        "scheme": "string"
      },
      "certificate": [ "string" ],
      "certificateIds": [ "string" ],
      "header": {
        "{customized property}": [ "string" ]
      },
      "query": {
        "{customized property}": [ "string" ]
      }
    },
    "description": "string",
    "properties": {
      "serviceFabricCluster": {
        "clientCertificateId": "string",
        "clientCertificatethumbprint": "string",
        "managementEndpoints": [ "string" ],
        "maxPartitionResolutionRetries": "int",
        "serverCertificateThumbprints": [ "string" ],
        "serverX509Names": [
          {
            "issuerCertificateThumbprint": "string",
            "name": "string"
          }
        ]
      }
    },
    "protocol": "string",
    "proxy": {
      "password": "string",
      "url": "string",
      "username": "string"
    },
    "resourceId": "string",
    "title": "string",
    "tls": {
      "validateCertificateChain": "bool",
      "validateCertificateName": "bool"
    },
    "url": "string"
  }
}

قيم الخصائص

الخدمة/الخلفيات

اسم وصف قيمة
نوع نوع المورد 'Microsoft.ApiManagement/service/backends'
apiVersion إصدار واجهة برمجة تطبيقات المورد '2022-08-01'
اسم اسم المورد

راجع كيفية تعيين الأسماء والأنواع للموارد التابعة في قوالب JSON ARM.		 سلسلة (مطلوب)

حد الحرف: 1-80

الأحرف الصالحة:
الأبجدية الرقمية والواصلات.

ابدأ بحرف وانتهي بالأبجدية الرقمية.
خصائص خصائص عقد كيان الواجهة الخلفية. BackendContractProperties

الخصائص الخلفية

اسم وصف قيمة
وثائق التفويض خصائص تعاقد بيانات اعتماد الواجهة الخلفية BackendCredentialsContract
وصف وصف الخلفية. خيط

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 2000
خصائص عقد خصائص الخلفية BackendProperties
بروتوكول بروتوكول الاتصال الخلفي. 'http'
'soap' (مطلوب)
الوكيل خصائص عقد بوابة الواجهة الخلفية BackendProxyContract
معرف المورد إدارة Uri للمورد في النظام الخارجي. يمكن أن يكون عنوان URL هذا معرف مورد Arm لتطبيقات المنطق أو تطبيقات الوظائف أو تطبيقات واجهة برمجة التطبيقات. خيط

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 2000
عنوان عنوان الواجهة الخلفية. خيط

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 300
tls خصائص TLS الخلفية BackendTlsProperties
url عنوان URL لوقت التشغيل للواجهة الخلفية. سلسلة (مطلوب)

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 2000

تم التعاقد مع BackendCredentials

اسم وصف قيمة
إذن مصادقة عنوان التخويل BackendAuthorizationHeaderCredentials
شهادة قائمة بصمات إبهام شهادة العميل. سيتم تجاهلها إذا تم توفير certificatesIds. سلسلة[]

القيود:
الحد الأقصى للطول = 32
معرفات الشهادة قائمة معرفات شهادة العميل. سلسلة[]

القيود:
الحد الأقصى للطول = 32
راس وصف معلمة الرأس. BackendCredentialsContractHeader
استفسار وصف معلمة الاستعلام. BackendCredentialsContractQuery

BackendAuthorizationHeaderCredentials

اسم وصف قيمة
البارامتر قيمة معلمة المصادقة. سلسلة (مطلوب)

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 300
نظام اسم نظام المصادقة. سلسلة (مطلوب)

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 100

BackendCredentialsContractHeader

اسم وصف قيمة
{خاصية مخصصة} سلسلة[]

BackendCredentialsContractQuery

اسم وصف قيمة
{خاصية مخصصة} سلسلة[]

خصائص الخلفية

اسم وصف قيمة
serviceFabricCluster خصائص مجموعة نسيج الخدمة الخلفية BackendServiceFabricClusterProperties

خصائص الخوادم الخلفيةFabricCluperties

اسم وصف قيمة
clientCertificateId معرف شهادة العميل لنقطة نهاية الإدارة. خيط
clientCertificatethumbprint بصمة إبهام شهادة العميل لنقطة نهاية الإدارة. سيتم تجاهلها إذا تم توفير certificatesIds خيط
نقاط نهاية الإدارة نقطة نهاية إدارة نظام المجموعة. string[] (مطلوبة)
maxPartitionResolutionRetries الحد الأقصى لعدد مرات إعادة المحاولة أثناء محاولة حل القسم. الباحث
serverCertificateThumbprints بصمة الإبهام لخدمة إدارة نظام مجموعة الشهادات تستخدم لاتصال tls سلسلة[]
أسماء serverX509 مجموعة أسماء شهادات Server X509 X509CertificateName[]

X509CertificateName

اسم وصف قيمة
issuerCertificateThumbprint بصمة الإبهام لمصدر الشهادة. خيط
اسم الاسم الشائع للشهادة. خيط

BackendProxyContract

اسم وصف قيمة
شعار كلمة المرور للاتصال بخادم WebProxy خيط
url خاصية WebProxy Server AbsoluteUri التي تتضمن URI بأكمله المخزن في مثيل Uri، بما في ذلك جميع الأجزاء وسلاسل الاستعلام. سلسلة (مطلوب)

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 2000
اسم المستخدم اسم المستخدم للاتصال بخادم WebProxy خيط

خصائص الخلفية

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

تعريف مورد Terraform (موفر AzAPI)

يمكن نشر نوع مورد الخدمة/الخلفيات مع العمليات التي تستهدف:

  • مجموعات الموارد

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

تنسيق المورد

لإنشاء مورد Microsoft.ApiManagement/service/backends، أضف Terraform التالي إلى القالب الخاص بك.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/backends@2022-08-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      credentials = {
        authorization = {
          parameter = "string"
          scheme = "string"
        }
        certificate = [
          "string"
        ]
        certificateIds = [
          "string"
        ]
        header = {
          {customized property} = [
            "string"
          ]
        }
        query = {
          {customized property} = [
            "string"
          ]
        }
      }
      description = "string"
      properties = {
        serviceFabricCluster = {
          clientCertificateId = "string"
          clientCertificatethumbprint = "string"
          managementEndpoints = [
            "string"
          ]
          maxPartitionResolutionRetries = int
          serverCertificateThumbprints = [
            "string"
          ]
          serverX509Names = [
            {
              issuerCertificateThumbprint = "string"
              name = "string"
            }
          ]
        }
      }
      protocol = "string"
      proxy = {
        password = "string"
        url = "string"
        username = "string"
      }
      resourceId = "string"
      title = "string"
      tls = {
        validateCertificateChain = bool
        validateCertificateName = bool
      }
      url = "string"
    }
  })
}

قيم الخصائص

الخدمة/الخلفيات

اسم وصف قيمة
نوع نوع المورد "Microsoft.ApiManagement/service/backends@2022-08-01"
اسم اسم المورد سلسلة (مطلوب)

حد الحرف: 1-80

الأحرف الصالحة:
الأبجدية الرقمية والواصلات.

ابدأ بحرف وانتهي بالأبجدية الرقمية.
parent_id معرف المورد الأصل لهذا المورد. معرف المورد من النوع: خدمة
خصائص خصائص عقد كيان الواجهة الخلفية. BackendContractProperties

الخصائص الخلفية

اسم وصف قيمة
وثائق التفويض خصائص تعاقد بيانات اعتماد الواجهة الخلفية BackendCredentialsContract
وصف وصف الخلفية. خيط

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 2000
خصائص عقد خصائص الخلفية BackendProperties
بروتوكول بروتوكول الاتصال الخلفي. "http"
"soap" (مطلوب)
الوكيل خصائص عقد بوابة الواجهة الخلفية BackendProxyContract
معرف المورد إدارة Uri للمورد في النظام الخارجي. يمكن أن يكون عنوان URL هذا معرف مورد Arm لتطبيقات المنطق أو تطبيقات الوظائف أو تطبيقات واجهة برمجة التطبيقات. خيط

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 2000
عنوان عنوان الواجهة الخلفية. خيط

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 300
tls خصائص TLS الخلفية BackendTlsProperties
url عنوان URL لوقت التشغيل للواجهة الخلفية. سلسلة (مطلوب)

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 2000

تم التعاقد مع BackendCredentials

اسم وصف قيمة
إذن مصادقة عنوان التخويل BackendAuthorizationHeaderCredentials
شهادة قائمة بصمات إبهام شهادة العميل. سيتم تجاهلها إذا تم توفير certificatesIds. سلسلة[]

القيود:
الحد الأقصى للطول = 32
معرفات الشهادة قائمة معرفات شهادة العميل. سلسلة[]

القيود:
الحد الأقصى للطول = 32
راس وصف معلمة الرأس. BackendCredentialsContractHeader
استفسار وصف معلمة الاستعلام. BackendCredentialsContractQuery

BackendAuthorizationHeaderCredentials

اسم وصف قيمة
البارامتر قيمة معلمة المصادقة. سلسلة (مطلوب)

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 300
نظام اسم نظام المصادقة. سلسلة (مطلوب)

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 100

BackendCredentialsContractHeader

اسم وصف قيمة
{خاصية مخصصة} سلسلة[]

BackendCredentialsContractQuery

اسم وصف قيمة
{خاصية مخصصة} سلسلة[]

خصائص الخلفية

اسم وصف قيمة
serviceFabricCluster خصائص مجموعة نسيج الخدمة الخلفية BackendServiceFabricClusterProperties

خصائص الخوادم الخلفيةFabricCluperties

اسم وصف قيمة
clientCertificateId معرف شهادة العميل لنقطة نهاية الإدارة. خيط
clientCertificatethumbprint بصمة إبهام شهادة العميل لنقطة نهاية الإدارة. سيتم تجاهلها إذا تم توفير certificatesIds خيط
نقاط نهاية الإدارة نقطة نهاية إدارة نظام المجموعة. string[] (مطلوبة)
maxPartitionResolutionRetries الحد الأقصى لعدد مرات إعادة المحاولة أثناء محاولة حل القسم. الباحث
serverCertificateThumbprints بصمة الإبهام لخدمة إدارة نظام مجموعة الشهادات تستخدم لاتصال tls سلسلة[]
أسماء serverX509 مجموعة أسماء شهادات Server X509 X509CertificateName[]

X509CertificateName

اسم وصف قيمة
issuerCertificateThumbprint بصمة الإبهام لمصدر الشهادة. خيط
اسم الاسم الشائع للشهادة. خيط

BackendProxyContract

اسم وصف قيمة
شعار كلمة المرور للاتصال بخادم WebProxy خيط
url خاصية WebProxy Server AbsoluteUri التي تتضمن URI بأكمله المخزن في مثيل Uri، بما في ذلك جميع الأجزاء وسلاسل الاستعلام. سلسلة (مطلوب)

القيود:
الحد الأدنى للطول = 1
الحد الأقصى للطول = 2000
اسم المستخدم اسم المستخدم للاتصال بخادم WebProxy خيط

خصائص الخلفية

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