عمليات نشر Microsoft.Resources
ملاحظات
بالنسبة إلى Bicep، ضع في اعتبارك باستخدام الوحدات النمطية بدلا من نوع المورد هذا.
تعريف مورد Bicep
يمكن نشر نوع مورد عمليات التوزيع مع العمليات التي تستهدف:
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .
تنسيق المورد
لإنشاء مورد Microsoft.Resources/deployments، أضف Bicep التالي إلى القالب الخاص بك.
resource symbolicname 'Microsoft.Resources/deployments@2024-11-01' = {
scope: resourceSymbolicName or scope
location: 'string'
name: 'string'
properties: {
debugSetting: {
detailLevel: 'string'
}
expressionEvaluationOptions: {
scope: 'string'
}
mode: 'string'
onErrorDeployment: {
deploymentName: 'string'
type: 'string'
}
parameters: {
{customized property}: {
reference: {
keyVault: {
id: 'string'
}
secretName: 'string'
secretVersion: 'string'
}
value: any(Azure.Bicep.Types.Concrete.AnyType)
}
}
parametersLink: {
contentVersion: 'string'
uri: 'string'
}
template: any(Azure.Bicep.Types.Concrete.AnyType)
templateLink: {
contentVersion: 'string'
id: 'string'
queryString: 'string'
relativePath: 'string'
uri: 'string'
}
validationLevel: 'string'
}
tags: {
{customized property}: 'string'
}
}
قيم الخصائص
تصحيح الأخطاءالإعداد
| اسم | وصف | قيمة |
|---|---|---|
| مستوى التفاصيل | تحديد نوع المعلومات التي يجب تسجيلها لتصحيح الأخطاء. القيم المسموح بها هي none أو requestContent أو responseContent أو كل من requestContent و responseContent مفصولة بفاوصلة. الإعداد الافتراضي هو none. عند تعيين هذه القيمة، ضع في اعتبارك بعناية نوع المعلومات التي تمررها أثناء النشر. من خلال تسجيل معلومات حول الطلب أو الاستجابة، قد تعرض البيانات الحساسة التي يتم استردادها من خلال عمليات التوزيع. | خيط |
أداة توزيع المعلمة
| اسم | وصف | قيمة |
|---|---|---|
| مرجع | مرجع معلمة Azure Key Vault. | KeyVaultParameterReference |
| قيمة | قيمة الإدخال إلى المعلمة . | أي |
DeploymentPropertiesOrDeploymentPropertiesExtended
| اسم | وصف | قيمة |
|---|---|---|
| تصحيح الأخطاءإعداد | إعداد تتبع الأخطاء للتوزيع. | |
| عمليات تقييم التعبير | يحدد ما إذا كان يتم تقييم تعبيرات القالب ضمن نطاق القالب الأصل أو القالب المتداخل. ينطبق فقط على القوالب المتداخلة. إذا لم يتم تحديدها، تكون القيمة الافتراضية خارجية. | |
| طريقة | الوضع المستخدم لنشر الموارد. يمكن أن تكون هذه القيمة إما تزايدية أو كاملة. في الوضع التزايدي، يتم نشر الموارد دون حذف الموارد الموجودة غير المضمنة في القالب. في وضع الإكمال، يتم نشر الموارد ويتم حذف الموارد الموجودة في مجموعة الموارد غير المضمنة في القالب. كن حذرا عند استخدام وضع الإكمال حيث يمكنك حذف الموارد عن غير قصد. | "مكتمل" "تزايدي" (مطلوب) |
| onErrorDeployment | التوزيع على سلوك الخطأ. | OnErrorDeploymentOrOnErrorDeploymentExtended |
| البارامترات | أزواج الاسم والقيمة التي تحدد معلمات التوزيع للقالب. يمكنك استخدام هذا العنصر عندما تريد توفير قيم المعلمات مباشرة في الطلب بدلا من الارتباط بملف معلمة موجود. استخدم خاصية parametersLink أو خاصية المعلمات، ولكن ليس كليهما. يمكن أن يكون JObject أو سلسلة JSON جيدة التكوين. | DeploymentPropertiesParameters |
| ارتباط المعلمات | URI لملف المعلمات. يمكنك استخدام هذا العنصر للارتباط بملف معلمات موجود. استخدم خاصية parametersLink أو خاصية المعلمات، ولكن ليس كليهما. | ربط المعلمات |
| قالب | محتوى القالب. يمكنك استخدام هذا العنصر عندما تريد تمرير بناء جملة القالب مباشرة في الطلب بدلا من الارتباط بقالب موجود. يمكن أن يكون JObject أو سلسلة JSON جيدة التكوين. استخدم خاصية templateLink أو خاصية القالب، ولكن ليس كليهما. | أي |
| ارتباط قالب | URI للقالب. استخدم خاصية templateLink أو خاصية القالب، ولكن ليس كليهما. | |
| مستوى التحقق من الصحة | مستوى التحقق من صحة النشر | "الموفر" "ProviderNoRbac" "قالب" |
معلمات خصائص التوزيع
| اسم | وصف | قيمة |
|---|
علامات التوزيع
| اسم | وصف | قيمة |
|---|
عمليات تقييم التعبير
| اسم | وصف | قيمة |
|---|---|---|
| نطاق | النطاق الذي سيتم استخدامه لتقييم المعلمات والمتغيرات والوظائف في قالب متداخل. | "داخلي" "غير محدد" 'الخارجي' |
مرجع KeyVaultParameter
| اسم | وصف | قيمة |
|---|---|---|
| keyVault | مرجع Azure Key Vault. | KeyVaultReference (مطلوب) |
| اسم السر | الاسم السري ل Azure Key Vault. | سلسلة (مطلوب) |
| إصدار سري | الإصدار السري ل Azure Key Vault. | خيط |
مرجع KeyVault
| اسم | وصف | قيمة |
|---|---|---|
| معرف | معرف مورد Azure Key Vault. | سلسلة (مطلوب) |
Microsoft.Resources/deployments
| اسم | وصف | قيمة |
|---|---|---|
| مكان | موقع تخزين بيانات النشر. | خيط |
| اسم | اسم المورد | خيط القيود: الحد الأدنى للطول = 1 الحد الأقصى للطول = 64 النمط = ^[-\w\._\(\)]+$ (مطلوب) |
| خصائص | خصائص التوزيع. | DeploymentPropertiesOrDeploymentPropertiesExtended (مطلوب) |
| نطاق | استخدم عند إنشاء مورد في نطاق مختلف عن نطاق النشر. | قم بتعيين هذه الخاصية إلى الاسم الرمزي لمورد لتطبيق مورد ملحق . |
| العلامات | علامات المورد | قاموس أسماء العلامات والقيم. راجع العلامات في القوالب |
OnErrorDeploymentOrOnErrorDeploymentExtended
| اسم | وصف | قيمة |
|---|---|---|
| اسم النشر | التوزيع الذي سيتم استخدامه في حالة الخطأ. | خيط |
| نوع | التوزيع على نوع سلوك الخطأ. القيم المحتملة هي LastSuccessful و SpecificDeployment. | "LastSuccessful" "نشر محدد" |
ارتباط المعلمات
| اسم | وصف | قيمة |
|---|---|---|
| إصدار المحتوى | إذا تم تضمينه، يجب أن يتطابق مع ContentVersion في القالب. | خيط |
| uri | URI لملف المعلمات. | سلسلة (مطلوب) |
ارتباط قالب
| اسم | وصف | قيمة |
|---|---|---|
| إصدار المحتوى | إذا تم تضمينه، يجب أن يتطابق مع ContentVersion في القالب. | خيط |
| معرف | معرف المورد لمواصفات القالب. استخدم إما الخاصية id أو uri، ولكن ليس كليهما. | خيط |
| سلسلة الاستعلام | سلسلة الاستعلام (على سبيل المثال، رمز SAS المميز) لاستخدامها مع templateLink URI. | خيط |
| مسار نسبي | يمكن استخدام الخاصية relativePath لنشر قالب مرتبط في موقع نسبة إلى الأصل. إذا تم ربط القالب الأصل ب TemplateSpec، فسيشير هذا إلى أداة في TemplateSpec. إذا كان الأصل مرتبطا ب URI، فسيكون النشر التابع مزيجا من معرفات URI الأصل والنسبية | خيط |
| uri | URI للقالب المراد نشره. استخدم إما الخاصية uri أو id، ولكن ليس كليهما. | خيط |
تعريف مورد قالب ARM
يمكن نشر نوع مورد عمليات التوزيع مع العمليات التي تستهدف:
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .
تنسيق المورد
لإنشاء مورد Microsoft.Resources/deployments، أضف JSON التالي إلى القالب الخاص بك.
{
"type": "Microsoft.Resources/deployments",
"apiVersion": "2024-11-01",
"name": "string",
"location": "string",
"properties": {
"debugSetting": {
"detailLevel": "string"
},
"expressionEvaluationOptions": {
"scope": "string"
},
"mode": "string",
"onErrorDeployment": {
"deploymentName": "string",
"type": "string"
},
"parameters": {
"{customized property}": {
"reference": {
"keyVault": {
"id": "string"
},
"secretName": "string",
"secretVersion": "string"
},
"value": {}
}
},
"parametersLink": {
"contentVersion": "string",
"uri": "string"
},
"template": {},
"templateLink": {
"contentVersion": "string",
"id": "string",
"queryString": "string",
"relativePath": "string",
"uri": "string"
},
"validationLevel": "string"
},
"tags": {
"{customized property}": "string"
}
}
قيم الخصائص
تصحيح الأخطاءالإعداد
| اسم | وصف | قيمة |
|---|---|---|
| مستوى التفاصيل | تحديد نوع المعلومات التي يجب تسجيلها لتصحيح الأخطاء. القيم المسموح بها هي none أو requestContent أو responseContent أو كل من requestContent و responseContent مفصولة بفاوصلة. الإعداد الافتراضي هو none. عند تعيين هذه القيمة، ضع في اعتبارك بعناية نوع المعلومات التي تمررها أثناء النشر. من خلال تسجيل معلومات حول الطلب أو الاستجابة، قد تعرض البيانات الحساسة التي يتم استردادها من خلال عمليات التوزيع. | خيط |
أداة توزيع المعلمة
| اسم | وصف | قيمة |
|---|---|---|
| مرجع | مرجع معلمة Azure Key Vault. | KeyVaultParameterReference |
| قيمة | قيمة الإدخال إلى المعلمة . | أي |
DeploymentPropertiesOrDeploymentPropertiesExtended
| اسم | وصف | قيمة |
|---|---|---|
| تصحيح الأخطاءإعداد | إعداد تتبع الأخطاء للتوزيع. | |
| عمليات تقييم التعبير | يحدد ما إذا كان يتم تقييم تعبيرات القالب ضمن نطاق القالب الأصل أو القالب المتداخل. ينطبق فقط على القوالب المتداخلة. إذا لم يتم تحديدها، تكون القيمة الافتراضية خارجية. | |
| طريقة | الوضع المستخدم لنشر الموارد. يمكن أن تكون هذه القيمة إما تزايدية أو كاملة. في الوضع التزايدي، يتم نشر الموارد دون حذف الموارد الموجودة غير المضمنة في القالب. في وضع الإكمال، يتم نشر الموارد ويتم حذف الموارد الموجودة في مجموعة الموارد غير المضمنة في القالب. كن حذرا عند استخدام وضع الإكمال حيث يمكنك حذف الموارد عن غير قصد. | "مكتمل" "تزايدي" (مطلوب) |
| onErrorDeployment | التوزيع على سلوك الخطأ. | OnErrorDeploymentOrOnErrorDeploymentExtended |
| البارامترات | أزواج الاسم والقيمة التي تحدد معلمات التوزيع للقالب. يمكنك استخدام هذا العنصر عندما تريد توفير قيم المعلمات مباشرة في الطلب بدلا من الارتباط بملف معلمة موجود. استخدم خاصية parametersLink أو خاصية المعلمات، ولكن ليس كليهما. يمكن أن يكون JObject أو سلسلة JSON جيدة التكوين. | DeploymentPropertiesParameters |
| ارتباط المعلمات | URI لملف المعلمات. يمكنك استخدام هذا العنصر للارتباط بملف معلمات موجود. استخدم خاصية parametersLink أو خاصية المعلمات، ولكن ليس كليهما. | ربط المعلمات |
| قالب | محتوى القالب. يمكنك استخدام هذا العنصر عندما تريد تمرير بناء جملة القالب مباشرة في الطلب بدلا من الارتباط بقالب موجود. يمكن أن يكون JObject أو سلسلة JSON جيدة التكوين. استخدم خاصية templateLink أو خاصية القالب، ولكن ليس كليهما. | أي |
| ارتباط قالب | URI للقالب. استخدم خاصية templateLink أو خاصية القالب، ولكن ليس كليهما. | |
| مستوى التحقق من الصحة | مستوى التحقق من صحة النشر | "الموفر" "ProviderNoRbac" "قالب" |
معلمات خصائص التوزيع
| اسم | وصف | قيمة |
|---|
علامات التوزيع
| اسم | وصف | قيمة |
|---|
عمليات تقييم التعبير
| اسم | وصف | قيمة |
|---|---|---|
| نطاق | النطاق الذي سيتم استخدامه لتقييم المعلمات والمتغيرات والوظائف في قالب متداخل. | "داخلي" "غير محدد" 'الخارجي' |
مرجع KeyVaultParameter
| اسم | وصف | قيمة |
|---|---|---|
| keyVault | مرجع Azure Key Vault. | KeyVaultReference (مطلوب) |
| اسم السر | الاسم السري ل Azure Key Vault. | سلسلة (مطلوب) |
| إصدار سري | الإصدار السري ل Azure Key Vault. | خيط |
مرجع KeyVault
| اسم | وصف | قيمة |
|---|---|---|
| معرف | معرف مورد Azure Key Vault. | سلسلة (مطلوب) |
Microsoft.Resources/deployments
| اسم | وصف | قيمة |
|---|---|---|
| apiVersion | إصدار واجهة برمجة التطبيقات | '2024-11-01' |
| مكان | موقع تخزين بيانات النشر. | خيط |
| اسم | اسم المورد | خيط القيود: الحد الأدنى للطول = 1 الحد الأقصى للطول = 64 النمط = ^[-\w\._\(\)]+$ (مطلوب) |
| خصائص | خصائص التوزيع. | DeploymentPropertiesOrDeploymentPropertiesExtended (مطلوب) |
| العلامات | علامات المورد | قاموس أسماء العلامات والقيم. راجع العلامات في القوالب |
| نوع | نوع المورد | "Microsoft.Resources/deployments" |
OnErrorDeploymentOrOnErrorDeploymentExtended
| اسم | وصف | قيمة |
|---|---|---|
| اسم النشر | التوزيع الذي سيتم استخدامه في حالة الخطأ. | خيط |
| نوع | التوزيع على نوع سلوك الخطأ. القيم المحتملة هي LastSuccessful و SpecificDeployment. | "LastSuccessful" "نشر محدد" |
ارتباط المعلمات
| اسم | وصف | قيمة |
|---|---|---|
| إصدار المحتوى | إذا تم تضمينه، يجب أن يتطابق مع ContentVersion في القالب. | خيط |
| uri | URI لملف المعلمات. | سلسلة (مطلوب) |
ارتباط قالب
| اسم | وصف | قيمة |
|---|---|---|
| إصدار المحتوى | إذا تم تضمينه، يجب أن يتطابق مع ContentVersion في القالب. | خيط |
| معرف | معرف المورد لمواصفات القالب. استخدم إما الخاصية id أو uri، ولكن ليس كليهما. | خيط |
| سلسلة الاستعلام | سلسلة الاستعلام (على سبيل المثال، رمز SAS المميز) لاستخدامها مع templateLink URI. | خيط |
| مسار نسبي | يمكن استخدام الخاصية relativePath لنشر قالب مرتبط في موقع نسبة إلى الأصل. إذا تم ربط القالب الأصل ب TemplateSpec، فسيشير هذا إلى أداة في TemplateSpec. إذا كان الأصل مرتبطا ب URI، فسيكون النشر التابع مزيجا من معرفات URI الأصل والنسبية | خيط |
| uri | URI للقالب المراد نشره. استخدم إما الخاصية uri أو id، ولكن ليس كليهما. | خيط |
تعريف مورد Terraform (موفر AzAPI)
يمكن نشر نوع مورد عمليات التوزيع مع العمليات التي تستهدف:
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .
تنسيق المورد
لإنشاء مورد Microsoft.Resources/deployments، أضف Terraform التالي إلى القالب الخاص بك.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Resources/deployments@2024-11-01"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
debugSetting = {
detailLevel = "string"
}
expressionEvaluationOptions = {
scope = "string"
}
mode = "string"
onErrorDeployment = {
deploymentName = "string"
type = "string"
}
parameters = {
{customized property} = {
reference = {
keyVault = {
id = "string"
}
secretName = "string"
secretVersion = "string"
}
value = ?
}
}
parametersLink = {
contentVersion = "string"
uri = "string"
}
template = ?
templateLink = {
contentVersion = "string"
id = "string"
queryString = "string"
relativePath = "string"
uri = "string"
}
validationLevel = "string"
}
})
}
قيم الخصائص
تصحيح الأخطاءالإعداد
| اسم | وصف | قيمة |
|---|---|---|
| مستوى التفاصيل | تحديد نوع المعلومات التي يجب تسجيلها لتصحيح الأخطاء. القيم المسموح بها هي none أو requestContent أو responseContent أو كل من requestContent و responseContent مفصولة بفاوصلة. الإعداد الافتراضي هو none. عند تعيين هذه القيمة، ضع في اعتبارك بعناية نوع المعلومات التي تمررها أثناء النشر. من خلال تسجيل معلومات حول الطلب أو الاستجابة، قد تعرض البيانات الحساسة التي يتم استردادها من خلال عمليات التوزيع. | خيط |
أداة توزيع المعلمة
| اسم | وصف | قيمة |
|---|---|---|
| مرجع | مرجع معلمة Azure Key Vault. | KeyVaultParameterReference |
| قيمة | قيمة الإدخال إلى المعلمة . | أي |
DeploymentPropertiesOrDeploymentPropertiesExtended
| اسم | وصف | قيمة |
|---|---|---|
| تصحيح الأخطاءإعداد | إعداد تتبع الأخطاء للتوزيع. | |
| عمليات تقييم التعبير | يحدد ما إذا كان يتم تقييم تعبيرات القالب ضمن نطاق القالب الأصل أو القالب المتداخل. ينطبق فقط على القوالب المتداخلة. إذا لم يتم تحديدها، تكون القيمة الافتراضية خارجية. | |
| طريقة | الوضع المستخدم لنشر الموارد. يمكن أن تكون هذه القيمة إما تزايدية أو كاملة. في الوضع التزايدي، يتم نشر الموارد دون حذف الموارد الموجودة غير المضمنة في القالب. في وضع الإكمال، يتم نشر الموارد ويتم حذف الموارد الموجودة في مجموعة الموارد غير المضمنة في القالب. كن حذرا عند استخدام وضع الإكمال حيث يمكنك حذف الموارد عن غير قصد. | "مكتمل" "تزايدي" (مطلوب) |
| onErrorDeployment | التوزيع على سلوك الخطأ. | OnErrorDeploymentOrOnErrorDeploymentExtended |
| البارامترات | أزواج الاسم والقيمة التي تحدد معلمات التوزيع للقالب. يمكنك استخدام هذا العنصر عندما تريد توفير قيم المعلمات مباشرة في الطلب بدلا من الارتباط بملف معلمة موجود. استخدم خاصية parametersLink أو خاصية المعلمات، ولكن ليس كليهما. يمكن أن يكون JObject أو سلسلة JSON جيدة التكوين. | DeploymentPropertiesParameters |
| ارتباط المعلمات | URI لملف المعلمات. يمكنك استخدام هذا العنصر للارتباط بملف معلمات موجود. استخدم خاصية parametersLink أو خاصية المعلمات، ولكن ليس كليهما. | ربط المعلمات |
| قالب | محتوى القالب. يمكنك استخدام هذا العنصر عندما تريد تمرير بناء جملة القالب مباشرة في الطلب بدلا من الارتباط بقالب موجود. يمكن أن يكون JObject أو سلسلة JSON جيدة التكوين. استخدم خاصية templateLink أو خاصية القالب، ولكن ليس كليهما. | أي |
| ارتباط قالب | URI للقالب. استخدم خاصية templateLink أو خاصية القالب، ولكن ليس كليهما. | |
| مستوى التحقق من الصحة | مستوى التحقق من صحة النشر | "الموفر" "ProviderNoRbac" "قالب" |
معلمات خصائص التوزيع
| اسم | وصف | قيمة |
|---|
علامات التوزيع
| اسم | وصف | قيمة |
|---|
عمليات تقييم التعبير
| اسم | وصف | قيمة |
|---|---|---|
| نطاق | النطاق الذي سيتم استخدامه لتقييم المعلمات والمتغيرات والوظائف في قالب متداخل. | "داخلي" "غير محدد" 'الخارجي' |
مرجع KeyVaultParameter
| اسم | وصف | قيمة |
|---|---|---|
| keyVault | مرجع Azure Key Vault. | KeyVaultReference (مطلوب) |
| اسم السر | الاسم السري ل Azure Key Vault. | سلسلة (مطلوب) |
| إصدار سري | الإصدار السري ل Azure Key Vault. | خيط |
مرجع KeyVault
| اسم | وصف | قيمة |
|---|---|---|
| معرف | معرف مورد Azure Key Vault. | سلسلة (مطلوب) |
Microsoft.Resources/deployments
| اسم | وصف | قيمة |
|---|---|---|
| مكان | موقع تخزين بيانات النشر. | خيط |
| اسم | اسم المورد | خيط القيود: الحد الأدنى للطول = 1 الحد الأقصى للطول = 64 النمط = ^[-\w\._\(\)]+$ (مطلوب) |
| parent_id | معرف المورد لتطبيق مورد الملحق هذا عليه. | سلسلة (مطلوب) |
| خصائص | خصائص التوزيع. | DeploymentPropertiesOrDeploymentPropertiesExtended (مطلوب) |
| العلامات | علامات المورد | قاموس أسماء العلامات والقيم. |
| نوع | نوع المورد | "Microsoft.Resources/deployments@2024-11-01" |
OnErrorDeploymentOrOnErrorDeploymentExtended
| اسم | وصف | قيمة |
|---|---|---|
| اسم النشر | التوزيع الذي سيتم استخدامه في حالة الخطأ. | خيط |
| نوع | التوزيع على نوع سلوك الخطأ. القيم المحتملة هي LastSuccessful و SpecificDeployment. | "LastSuccessful" "نشر محدد" |
ارتباط المعلمات
| اسم | وصف | قيمة |
|---|---|---|
| إصدار المحتوى | إذا تم تضمينه، يجب أن يتطابق مع ContentVersion في القالب. | خيط |
| uri | URI لملف المعلمات. | سلسلة (مطلوب) |
ارتباط قالب
| اسم | وصف | قيمة |
|---|---|---|
| إصدار المحتوى | إذا تم تضمينه، يجب أن يتطابق مع ContentVersion في القالب. | خيط |
| معرف | معرف المورد لمواصفات القالب. استخدم إما الخاصية id أو uri، ولكن ليس كليهما. | خيط |
| سلسلة الاستعلام | سلسلة الاستعلام (على سبيل المثال، رمز SAS المميز) لاستخدامها مع templateLink URI. | خيط |
| مسار نسبي | يمكن استخدام الخاصية relativePath لنشر قالب مرتبط في موقع نسبة إلى الأصل. إذا تم ربط القالب الأصل ب TemplateSpec، فسيشير هذا إلى أداة في TemplateSpec. إذا كان الأصل مرتبطا ب URI، فسيكون النشر التابع مزيجا من معرفات URI الأصل والنسبية | خيط |
| uri | URI للقالب المراد نشره. استخدم إما الخاصية uri أو id، ولكن ليس كليهما. | خيط |