Microsoft.ApiManagement service/backends
مقالة 01/18/2024
مساهم واحد
الملاحظات
في هذه المقالة
تعريف مورد Bicep
يمكن نشر نوع مورد الخدمة/الخلفيات مع العمليات التي تستهدف:
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .
لإنشاء مورد Microsoft.ApiManagement/service/backends، أضف Bicep التالي إلى القالب الخاص بك.
resource symbolicname 'Microsoft.ApiManagement/service/backends@2023-05-01-preview' = {
name: 'string'
parent: resourceSymbolicName
properties: {
circuitBreaker: {
rules: [
{
failureCondition: {
count: int
errorReasons: [
'string'
]
interval: 'string'
percentage: int
statusCodeRanges: [
{
max: int
min: int
}
]
}
name: 'string'
tripDuration: 'string'
}
]
}
credentials: {
authorization: {
parameter: 'string'
scheme: 'string'
}
certificate: [
'string'
]
certificateIds: [
'string'
]
header: {
{customized property}: [
'string'
]
}
query: {
{customized property}: [
'string'
]
}
}
description: 'string'
pool: {
services: [
{
id: '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
}
type: 'string'
url: 'string'
}
}
قيم Property
الخدمة/الخلفيات
الاسم
الوصف
القيمة
الاسم
اسم المورد تعرف على كيفية تعيين الأسماء والأنواع للموارد التابعة في Bicep .
سلسلة (مطلوب) حد الحرف: 1-80 أحرف صالحة: الأبجدية الرقمية والواصلات. يبدأ بالحرف وينتهي بالأبجدية الرقمية.
أصل
في Bicep، يمكنك تحديد المورد الأصل لمورد تابع. تحتاج فقط إلى إضافة هذه الخاصية عند الإعلان عن المورد التابع خارج المورد الأصل. لمزيد من المعلومات، راجع المورد التابع خارج المورد الأصل .
الاسم الرمزي للمورد من النوع: الخدمة
خصائص
خصائص عقد كيان الواجهة الخلفية.
BackendContractProperties
BackendContractProperties
الاسم
الوصف
القيمة
قاطع الدائرة
تكوين قاطع الدائرة الخلفية
BackendCircuitBreaker
بيانات الاعتماد
خصائص عقد بيانات الاعتماد الخلفية
BackendCredentialsContract
الوصف
وصف الواجهة الخلفية.
سلسلة
الفرقة
BackendBaseParametersPool
خصائص
عقد خصائص الواجهة الخلفية
الخصائص الخلفية
بروتوكول
بروتوكول الاتصال الخلفي.
'http' 'soap' (مطلوب)
الوكيل
خصائص عقد البوابة الخلفية
BackendProxyContract
resourceId
إدارة Uri للمورد في النظام الخارجي. يمكن أن يكون عنوان URL هذا معرف مورد Arm لتطبيقات المنطق أو تطبيقات الوظائف أو تطبيقات واجهة برمجة التطبيقات.
سلسلة
العنوان
عنوان الواجهة الخلفية.
سلسلة
Tls
خصائص TLS الخلفية
BackendTlsProperties
النوع
نوع الواجهة الخلفية. يمكن أن تكون الواجهة الخلفية إما مفردة أو تجمع.
"تجمع" "مفرد"
عنوان url
عنوان URL لوقت التشغيل للواجهة الخلفية.
سلسلة (مطلوب)
BackendCircuitBreaker
CircuitBreakerRule
الاسم
الوصف
القيمة
failureCondition
شروط التعثر في قاطع الدائرة.
CircuitBreakerFailureCondition
الاسم
اسم القاعدة.
سلسلة
tripDuration
المدة التي سيتم فرز الدائرة لها.
سلسلة
CircuitBreakerFailureCondition
الاسم
الوصف
القيمة
العدد
حد فتح الدائرة.
int
errorReasons
أسباب الخطأ التي تعتبر فشلا.
سلسلة []
الفاصل الزمني
الفاصل الزمني الذي يتم فيه حساب حالات الفشل.
سلسلة
نسبة مئوية
حد فتح الدائرة.
int
statusCodeRanges
نطاقات التعليمات البرمجية للحالة التي تعتبر فشلا.
FailureStatusCodeRange []
FailureStatusCodeRange
الاسم
الوصف
القيمة
حد أقصى
الحد الأقصى لرمز حالة http.
int
دقيقة
الحد الأدنى لرمز حالة http.
int
BackendCredentialsContract
الاسم
الوصف
القيمة
المعلمة
قيمة معلمة المصادقة.
سلسلة (مطلوب)
scheme
اسم نظام المصادقة.
سلسلة (مطلوب)
الاسم
الوصف
القيمة
{خاصية مخصصة}
سلسلة []
BackendCredentialsContractQuery
الاسم
الوصف
القيمة
{خاصية مخصصة}
سلسلة []
BackendBaseParametersPool
الاسم
الوصف
القيمة
services
قائمة الكيانات الخلفية التي تنتمي إلى تجمع.
BackendPoolItem []
BackendPoolItem
الاسم
الوصف
القيمة
المعرف
معرف ARM الفريد للكيان الخلفي. يجب أن يشير معرف ARM إلى كيان خلفية موجود بالفعل.
سلسلة (مطلوب)
الخصائص الخلفية
BackendServiceFabricClusterProperties
الاسم
الوصف
القيمة
clientCertificateId
معرف شهادة العميل لنقطة نهاية الإدارة.
سلسلة
clientCertificatethumbprint
بصمة إبهام شهادة العميل لنقطة نهاية الإدارة. سيتم تجاهل إذا تم توفير certificatesIds
سلسلة
نقاط نهاية الإدارة
نقطة نهاية إدارة نظام المجموعة.
string[] (مطلوب)
maxPartitionResolutionRetries
الحد الأقصى لعدد مرات إعادة المحاولة أثناء محاولة حل القسم.
int
serverCertificateThumbprints
بصمات الإبهام لخدمة إدارة نظام مجموعة الشهادات التي تستخدمها لاتصال tls
سلسلة []
serverX509Names
مجموعة أسماء شهادات Server X509
X509CertificateName []
X509CertificateName
الاسم
الوصف
القيمة
issuerCertificateThumbprint
بصمة الإبهام لمصدر الشهادة.
سلسلة
الاسم
الاسم الشائع للشهادة.
سلسلة
BackendProxyContract
الاسم
الوصف
القيمة
كلمة المرور
كلمة المرور للاتصال بخادم WebProxy
سلسلة
عنوان url
الخاصية WebProxy Server AbsoluteUri التي تتضمن URI بأكمله المخزن في مثيل Uri، بما في ذلك جميع الأجزاء وسلاسل الاستعلام.
سلسلة (مطلوب)
اسم المستخدم
اسم المستخدم للاتصال بخادم WebProxy
سلسلة
BackendTlsProperties
الاسم
الوصف
القيمة
التحقق من صحةCertificateChain
علامة تشير إلى ما إذا كان يجب التحقق من صحة سلسلة شهادات SSL عند استخدام الشهادات الموقعة ذاتيا لمضيف الواجهة الخلفية هذا.
Bool
التحقق من صحةCertificateName
علامة تشير إلى ما إذا كان يجب التحقق من صحة اسم شهادة SSL عند استخدام الشهادات الموقعة ذاتيا لمضيف الواجهة الخلفية هذا.
Bool
تعريف مورد قالب ARM
يمكن نشر نوع مورد الخدمة/الخلفيات مع العمليات التي تستهدف:
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .
لإنشاء مورد Microsoft.ApiManagement/service/backends، أضف JSON التالي إلى القالب الخاص بك.
{
"type": "Microsoft.ApiManagement/service/backends",
"apiVersion": "2023-05-01-preview",
"name": "string",
"properties": {
"circuitBreaker": {
"rules": [
{
"failureCondition": {
"count": "int",
"errorReasons": [ "string" ],
"interval": "string",
"percentage": "int",
"statusCodeRanges": [
{
"max": "int",
"min": "int"
}
]
},
"name": "string",
"tripDuration": "string"
}
]
},
"credentials": {
"authorization": {
"parameter": "string",
"scheme": "string"
},
"certificate": [ "string" ],
"certificateIds": [ "string" ],
"header": {
"{customized property}": [ "string" ]
},
"query": {
"{customized property}": [ "string" ]
}
},
"description": "string",
"pool": {
"services": [
{
"id": "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"
},
"type": "string",
"url": "string"
}
}
قيم Property
الخدمة/الخلفيات
الاسم
الوصف
القيمة
النوع
نوع المورد
'Microsoft.ApiManagement/service/backends'
apiVersion
إصدار واجهة برمجة تطبيقات المورد
'معاينة 2023-05-01'
الاسم
اسم المورد تعرف على كيفية تعيين الأسماء والأنواع للموارد التابعة في قوالب JSON ARM .
سلسلة (مطلوب) حد الحرف: 1-80 أحرف صالحة: الأبجدية الرقمية والواصلات. يبدأ بالحرف وينتهي بالأبجدية الرقمية.
خصائص
خصائص عقد كيان الواجهة الخلفية.
BackendContractProperties
BackendContractProperties
الاسم
الوصف
القيمة
قاطع الدائرة
تكوين قاطع الدائرة الخلفية
BackendCircuitBreaker
بيانات الاعتماد
خصائص عقد بيانات الاعتماد الخلفية
BackendCredentialsContract
الوصف
وصف الواجهة الخلفية.
سلسلة
الفرقة
BackendBaseParametersPool
خصائص
عقد خصائص الواجهة الخلفية
الخصائص الخلفية
بروتوكول
بروتوكول الاتصال الخلفي.
'http' 'soap' (مطلوب)
الوكيل
خصائص عقد بوابة الواجهة الخلفية
BackendProxyContract
resourceId
إدارة Uri للمورد في النظام الخارجي. يمكن أن يكون عنوان URL هذا معرف مورد Arm لتطبيقات المنطق أو تطبيقات الوظائف أو تطبيقات واجهة برمجة التطبيقات.
سلسلة
العنوان
عنوان الواجهة الخلفية.
سلسلة
Tls
خصائص TLS الخلفية
BackendTlsProperties
النوع
نوع الواجهة الخلفية. يمكن أن تكون الواجهة الخلفية إما مفردة أو تجمع.
"تجمع" "مفرد"
عنوان url
عنوان URL لوقت التشغيل للواجهة الخلفية.
سلسلة (مطلوبة)
BackendCircuitBreaker
CircuitBreakerRule
الاسم
الوصف
القيمة
فشلCondition
شروط التعثر في قاطع الدائرة.
CircuitBreakerFailureCondition
الاسم
اسم القاعدة.
سلسلة
tripDuration
المدة التي سيتم فرز الدائرة لها.
سلسلة
CircuitBreakerFailureCondition
الاسم
الوصف
القيمة
العدد
حد فتح الدائرة.
int
errorReasons
أسباب الخطأ التي تعتبر فشلا.
سلسلة []
الفاصل الزمني
الفاصل الزمني الذي يتم فيه حساب حالات الفشل.
سلسلة
نسبة مئوية
حد فتح الدائرة.
int
statusCodeRanges
نطاقات التعليمات البرمجية للحالة التي تعتبر فاشلة.
FailureStatusCodeRange []
FailureStatusCodeRange
الاسم
الوصف
القيمة
حد أقصى
الحد الأقصى لرمز حالة http.
int
دقيقة
الحد الأدنى لرمز حالة http.
int
BackendCredentialsContract
الاسم
الوصف
القيمة
المعلمة
قيمة معلمة المصادقة.
سلسلة (مطلوبة)
scheme
اسم نظام المصادقة.
سلسلة (مطلوبة)
الاسم
الوصف
القيمة
{خاصية مخصصة}
سلسلة []
BackendCredentialsContractQuery
الاسم
الوصف
القيمة
{خاصية مخصصة}
سلسلة []
BackendBaseParametersPool
الاسم
الوصف
القيمة
services
قائمة كيانات الواجهة الخلفية التي تنتمي إلى تجمع.
BackendPoolItem []
BackendPoolItem
الاسم
الوصف
القيمة
المعرف
معرف ARM الفريد للكيان الخلفي. يجب أن يشير معرف ARM إلى كيان خلفية موجود بالفعل.
سلسلة (مطلوبة)
الخصائص الخلفية
BackendServiceFabricClusterProperties
الاسم
الوصف
القيمة
clientCertificateId
معرف شهادة العميل لنقطة نهاية الإدارة.
سلسلة
clientCertificatethumbprint
بصمة إبهام شهادة العميل لنقطة نهاية الإدارة. سيتم تجاهلها إذا تم توفير certificatesIds
سلسلة
نقاط نهاية الإدارة
نقطة نهاية إدارة نظام المجموعة.
string[] (مطلوب)
maxPartitionResolutionRetries
الحد الأقصى لعدد مرات إعادة المحاولة أثناء محاولة حل القسم.
int
serverCertificateThumbprints
بصمات الإبهام لخدمة إدارة نظام مجموعة الشهادات التي تستخدمها لاتصال tls
سلسلة []
serverX509Names
مجموعة أسماء شهادات Server X509
X509CertificateName []
X509CertificateName
الاسم
الوصف
القيمة
issuerCertificateThumbprint
بصمة الإبهام لمصدر الشهادة.
سلسلة
الاسم
الاسم الشائع للشهادة.
سلسلة
BackendProxyContract
الاسم
الوصف
القيمة
كلمة المرور
كلمة المرور للاتصال بخادم WebProxy
سلسلة
عنوان url
خاصية WebProxy Server AbsoluteUri التي تتضمن URI بأكمله المخزن في مثيل Uri، بما في ذلك جميع الأجزاء وسلاسل الاستعلام.
سلسلة (مطلوبة)
اسم المستخدم
اسم المستخدم للاتصال بخادم WebProxy
سلسلة
BackendTlsProperties
الاسم
الوصف
القيمة
التحقق من صحةCertificateChain
علامة تشير إلى ما إذا كان يجب التحقق من صحة سلسلة شهادات SSL عند استخدام الشهادات الموقعة ذاتيا لمضيف الواجهة الخلفية هذا.
Bool
التحقق من صحةCertificateName
علامة تشير إلى ما إذا كان يجب التحقق من صحة اسم شهادة SSL عند استخدام الشهادات الموقعة ذاتيا لمضيف الواجهة الخلفية هذا.
Bool
يمكن توزيع نوع مورد الخدمة/الخلفيات مع العمليات التي تستهدف:
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .
لإنشاء مورد Microsoft.ApiManagement/service/backends، أضف Terraform التالي إلى القالب الخاص بك.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ApiManagement/service/backends@2023-05-01-preview"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
circuitBreaker = {
rules = [
{
failureCondition = {
count = int
errorReasons = [
"string"
]
interval = "string"
percentage = int
statusCodeRanges = [
{
max = int
min = int
}
]
}
name = "string"
tripDuration = "string"
}
]
}
credentials = {
authorization = {
parameter = "string"
scheme = "string"
}
certificate = [
"string"
]
certificateIds = [
"string"
]
header = {
{customized property} = [
"string"
]
}
query = {
{customized property} = [
"string"
]
}
}
description = "string"
pool = {
services = [
{
id = "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
}
type = "string"
url = "string"
}
})
}
قيم Property
الخدمة/الخلفيات
الاسم
الوصف
القيمة
النوع
نوع المورد
"Microsoft.ApiManagement/service/backends@2023-05-01-preview"
الاسم
اسم المورد
سلسلة (مطلوبة) حد الأحرف: 1-80 الأحرف الصالحة: الأبجدية الرقمية والواصلات. يبدأ بالحرف وينتهي بالأبجدية الرقمية.
parent_id
معرف المورد الأصل لهذا المورد.
معرف المورد من النوع: الخدمة
خصائص
خصائص عقد كيان الواجهة الخلفية.
الخصائص الخلفية
الخصائص الخلفية
الاسم
الوصف
القيمة
قاطع الدائرة
تكوين قاطع الدائرة الخلفية
BackendCircuitBreaker
بيانات الاعتماد
خصائص عقد بيانات اعتماد الواجهة الخلفية
BackendCredentialsContract
الوصف
وصف الواجهة الخلفية.
سلسلة
الفرقة
BackendBaseParametersPool
خصائص
عقد خصائص الواجهة الخلفية
الخصائص الخلفية
بروتوكول
بروتوكول الاتصال الخلفي.
"http" "soap" (مطلوب)
الوكيل
خصائص عقد بوابة الواجهة الخلفية
BackendProxyContract
resourceId
إدارة Uri للمورد في النظام الخارجي. يمكن أن يكون عنوان URL هذا معرف مورد Arm لتطبيقات المنطق أو تطبيقات الوظائف أو تطبيقات واجهة برمجة التطبيقات.
سلسلة
العنوان
عنوان الواجهة الخلفية.
سلسلة
Tls
خصائص TLS الخلفية
BackendTlsProperties
النوع
نوع الواجهة الخلفية. يمكن أن تكون الواجهة الخلفية إما مفردة أو تجمع.
"تجمع" "مفرد"
عنوان url
عنوان URL لوقت التشغيل للواجهة الخلفية.
سلسلة (مطلوبة)
BackendCircuitBreaker
CircuitBreakerRule
الاسم
الوصف
القيمة
فشلCondition
شروط التعثر في قاطع الدائرة.
CircuitBreakerFailureCondition
الاسم
اسم القاعدة.
سلسلة
tripDuration
المدة التي سيتم فرز الدائرة لها.
سلسلة
CircuitBreakerFailureCondition
الاسم
الوصف
القيمة
العدد
حد فتح الدائرة.
int
errorReasons
أسباب الخطأ التي تعتبر فشلا.
سلسلة []
الفاصل الزمني
الفاصل الزمني الذي يتم فيه حساب حالات الفشل.
سلسلة
نسبة مئوية
حد فتح الدائرة.
int
statusCodeRanges
نطاقات التعليمات البرمجية للحالة التي تعتبر فاشلة.
FailureStatusCodeRange []
FailureStatusCodeRange
الاسم
الوصف
القيمة
حد أقصى
الحد الأقصى لرمز حالة http.
int
دقيقة
الحد الأدنى لرمز حالة http.
int
BackendCredentialsContract
الاسم
الوصف
القيمة
المعلمة
قيمة معلمة المصادقة.
سلسلة (مطلوبة)
scheme
اسم نظام المصادقة.
سلسلة (مطلوبة)
الاسم
الوصف
القيمة
{خاصية مخصصة}
سلسلة []
BackendCredentialsContractQuery
الاسم
الوصف
القيمة
{خاصية مخصصة}
سلسلة []
BackendBaseParametersPool
الاسم
الوصف
القيمة
services
قائمة كيانات الواجهة الخلفية التي تنتمي إلى تجمع.
BackendPoolItem []
BackendPoolItem
الاسم
الوصف
القيمة
المعرف
معرف ARM الفريد للكيان الخلفي. يجب أن يشير معرف ARM إلى كيان خلفية موجود بالفعل.
سلسلة (مطلوبة)
الخصائص الخلفية
BackendServiceFabricClusterProperties
الاسم
الوصف
القيمة
clientCertificateId
معرف شهادة العميل لنقطة نهاية الإدارة.
سلسلة
clientCertificatethumbprint
بصمة إبهام شهادة العميل لنقطة نهاية الإدارة. سيتم تجاهلها إذا تم توفير certificatesIds
سلسلة
نقاط نهاية الإدارة
نقطة نهاية إدارة نظام المجموعة.
string[] (مطلوب)
maxPartitionResolutionRetries
الحد الأقصى لعدد مرات إعادة المحاولة أثناء محاولة حل القسم.
int
serverCertificateThumbprints
بصمات الإبهام لخدمة إدارة نظام مجموعة الشهادات التي تستخدمها لاتصال tls
سلسلة []
serverX509Names
مجموعة أسماء شهادات Server X509
X509CertificateName []
X509CertificateName
الاسم
الوصف
القيمة
issuerCertificateThumbprint
بصمة الإبهام لمصدر الشهادة.
سلسلة
الاسم
الاسم الشائع للشهادة.
سلسلة
BackendProxyContract
الاسم
الوصف
القيمة
كلمة المرور
كلمة المرور للاتصال بخادم WebProxy
سلسلة
عنوان url
الخاصية WebProxy Server AbsoluteUri التي تتضمن URI بأكمله المخزن في مثيل Uri، بما في ذلك جميع الأجزاء وسلاسل الاستعلام.
سلسلة (مطلوب)
اسم المستخدم
اسم المستخدم للاتصال بخادم WebProxy
سلسلة
BackendTlsProperties
الاسم
الوصف
القيمة
التحقق من صحةCertificateChain
علامة تشير إلى ما إذا كان يجب التحقق من صحة سلسلة شهادات SSL عند استخدام الشهادات الموقعة ذاتيا لمضيف الواجهة الخلفية هذا.
Bool
التحقق من صحةCertificateName
علامة تشير إلى ما إذا كان يجب التحقق من صحة اسم شهادة SSL عند استخدام الشهادات الموقعة ذاتيا لمضيف الواجهة الخلفية هذا.
Bool