بالنسبة ل Bicep، فكر في using modules بدلا من هذا النوع من الموارد.
تعريف موارد Bicep
يمكن نشر نوع مورد عمليات التوزيع مع العمليات التي تستهدف:
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .
لإنشاء Microsoft. موارد الموارد/النشرات، أضف Bicep التالي إلى قالبك.
resource symbolicname 'Microsoft.Resources/deployments@2025-04-01' = {
scope: resourceSymbolicName or scope
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
debugSetting: {
detailLevel: 'string'
}
expressionEvaluationOptions: {
scope: 'string'
}
extensionConfigs: {
{customized property}: {
{customized property}: {
keyVaultReference: {
keyVault: {
id: 'string'
}
secretName: 'string'
secretVersion: 'string'
}
value: any(...)
}
}
}
externalInputDefinitions: {
{customized property}: {
config: any(...)
kind: 'string'
}
}
externalInputs: {
{customized property}: {
value: any(...)
}
}
mode: 'string'
onErrorDeployment: {
deploymentName: 'string'
type: 'string'
}
parameters: {
{customized property}: {
expression: 'string'
reference: {
keyVault: {
id: 'string'
}
secretName: 'string'
secretVersion: 'string'
}
value: any(...)
}
}
parametersLink: {
contentVersion: 'string'
uri: 'string'
}
template: any(...)
templateLink: {
contentVersion: 'string'
id: 'string'
queryString: 'string'
relativePath: 'string'
uri: 'string'
}
validationLevel: 'string'
}
tags: {
{customized property}: 'string'
}
}
قيم الخصائص
Microsoft. الموارد/النشرات
| اسم |
الوصف |
القيمة |
| الهوية |
تكوين الهوية المدارة للنشر. |
DeploymentIdentity |
| مكان |
موقع تخزين بيانات النشر. |
سلسلة |
| اسم |
اسم المورد |
خيط
القيود: الحد الأدنى للطول = 1 الحد الأقصى للطول = 64 النمط = ^[-\w\._\(\)]+$ (مطلوب) |
| خصائص |
خصائص التوزيع. |
DeploymentPropertiesOrDeploymentPropertiesExtended (مطلوب) |
| نطاق |
استخدم عند إنشاء مورد في نطاق مختلف عن نطاق النشر. |
قم بتعيين هذه الخاصية إلى الاسم الرمزي لمورد لتطبيق مورد ملحق . |
| العلامات |
علامات الموارد |
قاموس أسماء العلامات والقيم. راجع العلامات في القوالب |
تصحيح الأخطاءالإعداد
| اسم |
الوصف |
القيمة |
| مستوى التفاصيل |
تحديد نوع المعلومات التي يجب تسجيلها لتصحيح الأخطاء. القيم المسموح بها هي none أو requestContent أو responseContent أو كل من requestContent و responseContent مفصولة بفاوصلة. الإعداد الافتراضي هو none. عند تعيين هذه القيمة، ضع في اعتبارك بعناية نوع المعلومات التي تمررها أثناء النشر. من خلال تسجيل معلومات حول الطلب أو الاستجابة، قد تعرض البيانات الحساسة التي يتم استردادها من خلال عمليات التوزيع. |
سلسلة |
DeploymentExtensionConfigItem
| اسم |
الوصف |
القيمة |
| مرجع keyVault |
المرجع المستخدم في Azure Key Vault لاسترجاع القيمة السرية لخاصية تكوين الإضافة. |
KeyVaultParameterReference |
| قيمة |
قيمة خاصية تكوين الملحق. |
أي |
DeploymentExternalInput
| اسم |
الوصف |
القيمة |
| قيمة |
قيمة الإدخال الخارجي. |
أي (مطلوب) |
النشر ExternalInputDefinition
| اسم |
الوصف |
القيمة |
| التكوين |
تكوين المدخلات الخارجية. |
أي |
| نوع |
نوع المدخلات الخارجية. |
سلسلة (مطلوب) |
DeploymentIdentity
DeploymentIdentityUserAssignedIdentities
أداة توزيع المعلمة
| اسم |
الوصف |
القيمة |
| تعبير |
إدخال التعبير إلى المعلمة. |
سلسلة |
| مرجع |
Azure Key Vault parameter reference. |
KeyVaultParameterReference |
| قيمة |
قيمة الإدخال إلى المعلمة . |
أي |
DeploymentPropertiesExtensionConfigs
DeploymentPropertiesOrDeploymentPropertiesExtended
| اسم |
الوصف |
القيمة |
| تصحيح الأخطاءإعداد |
إعداد تتبع الأخطاء للتوزيع. |
تصحيح الأخطاءالإعداد |
| عمليات تقييم التعبير |
يحدد ما إذا كان يتم تقييم تعبيرات القالب ضمن نطاق القالب الأصل أو القالب المتداخل. ينطبق فقط على القوالب المتداخلة. إذا لم يتم تحديدها، تكون القيمة الافتراضية خارجية. |
ExpressionEvaluationOptions |
| تكوينات الملحق |
التكوينات التي يجب استخدامها لملحقات التوزيع. مفاتيح هذا الكائن هي أسماء مستعارة لملحق التوزيع كما هو محدد في قالب النشر. |
DeploymentPropertiesExtensionConfigs |
| تعريفات خارجية |
تعريفات الإدخال الخارجي، التي تستخدمها الأدوات الخارجية لتحديد قيم الإدخال الخارجية المتوقعة. |
DeploymentPropertiesExternalInputDefinitions |
| المدخلات الخارجية |
قيم الإدخال الخارجية ، التي تستخدمها الأدوات الخارجية لتقييم المعلمات. |
DeploymentPropertiesExternalInputs |
| طريقة |
الوضع المستخدم لنشر الموارد. يمكن أن تكون هذه القيمة إما تزايدية أو كاملة. في الوضع التزايدي، يتم نشر الموارد دون حذف الموارد الموجودة غير المضمنة في القالب. في وضع الإكمال، يتم نشر الموارد ويتم حذف الموارد الموجودة في مجموعة الموارد غير المضمنة في القالب. كن حذرا عند استخدام وضع الإكمال حيث يمكنك حذف الموارد عن غير قصد. |
"مكتمل" "تزايدي" (مطلوب) |
| onErrorDeployment |
التوزيع على سلوك الخطأ. |
OnErrorDeploymentOrOnErrorDeploymentExtended |
| البارامترات |
أزواج الاسم والقيمة التي تحدد معلمات التوزيع للقالب. يمكنك استخدام هذا العنصر عندما تريد توفير قيم المعلمات مباشرة في الطلب بدلا من الارتباط بملف معلمة موجود. استخدم خاصية parametersLink أو خاصية المعلمات، ولكن ليس كليهما. يمكن أن يكون JObject أو سلسلة JSON جيدة التكوين. |
DeploymentPropertiesParameters |
| ارتباط المعلمات |
URI لملف المعلمات. يمكنك استخدام هذا العنصر للارتباط بملف معلمات موجود. استخدم خاصية parametersLink أو خاصية المعلمات، ولكن ليس كليهما. |
ارتباط المعلمات |
| قالب |
محتوى القالب. يمكنك استخدام هذا العنصر عندما تريد تمرير بناء جملة القالب مباشرة في الطلب بدلا من الارتباط بقالب موجود. يمكن أن يكون JObject أو سلسلة JSON جيدة التكوين. استخدم خاصية templateLink أو خاصية القالب، ولكن ليس كليهما. |
أي |
| ارتباط قالب |
URI للقالب. استخدم خاصية templateLink أو خاصية القالب، ولكن ليس كليهما. |
ارتباط قالب |
| مستوى التحقق من الصحة |
مستوى التحقق من صحة النشر |
"الموفر" "ProviderNoRbac" "قالب" |
معلمات خصائص التوزيع
DictionaryOfDeploymentExtensionConfigItem
عمليات تقييم التعبير
| اسم |
الوصف |
القيمة |
| نطاق |
النطاق الذي سيتم استخدامه لتقييم المعلمات والمتغيرات والوظائف في قالب متداخل. |
"داخلي" "غير محدد" 'الخارجي' |
مرجع KeyVaultParameter
| اسم |
الوصف |
القيمة |
| keyVault |
Azure Key Vault reference. |
KeyVaultReference (مطلوب) |
| اسم السر |
Azure Key Vault secret name. |
سلسلة (مطلوب) |
| إصدار سري |
Azure Key Vault secret version. |
سلسلة |
مرجع KeyVault
| اسم |
الوصف |
القيمة |
| معرف |
Azure Key Vault resource id. |
سلسلة (مطلوب) |
OnErrorDeploymentOrOnErrorDeploymentExtended
| اسم |
الوصف |
القيمة |
| اسم النشر |
التوزيع الذي سيتم استخدامه في حالة الخطأ. |
سلسلة |
| نوع |
التوزيع على نوع سلوك الخطأ. القيم المحتملة هي LastSuccessful و SpecificDeployment. |
"LastSuccessful" "نشر محدد" |
ارتباط المعلمات
| اسم |
الوصف |
القيمة |
| إصدار المحتوى |
إذا تم تضمينه، يجب أن يتطابق مع ContentVersion في القالب. |
سلسلة |
| URI |
URI لملف المعلمات. |
سلسلة (مطلوب) |
ارتباط قالب
| اسم |
الوصف |
القيمة |
| إصدار المحتوى |
إذا تم تضمينه، يجب أن يتطابق مع ContentVersion في القالب. |
سلسلة |
| معرف |
معرف المورد لمواصفات القالب. استخدم إما الخاصية id أو uri، ولكن ليس كليهما. |
سلسلة |
| سلسلة الاستعلام |
سلسلة الاستعلام (على سبيل المثال، رمز SAS المميز) لاستخدامها مع templateLink URI. |
سلسلة |
| مسار نسبي |
يمكن استخدام الخاصية relativePath لنشر قالب مرتبط في موقع نسبة إلى الأصل. إذا تم ربط القالب الأصل ب TemplateSpec، فسيشير هذا إلى أداة في TemplateSpec. إذا كان الأصل مرتبطا ب URI، فسيكون النشر التابع مزيجا من معرفات URI الأصل والنسبية |
سلسلة |
| URI |
URI للقالب المراد نشره. استخدم إما الخاصية uri أو id، ولكن ليس كليهما. |
سلسلة |
معرف تعيين المستخدم
تعريف مورد قالب ARM
يمكن نشر نوع مورد عمليات التوزيع مع العمليات التي تستهدف:
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .
لإنشاء Microsoft. موارد الموارد/النشرات، أضف ملف JSON التالي إلى قالبك.
{
"type": "Microsoft.Resources/deployments",
"apiVersion": "2025-04-01",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"debugSetting": {
"detailLevel": "string"
},
"expressionEvaluationOptions": {
"scope": "string"
},
"extensionConfigs": {
"{customized property}": {
"{customized property}": {
"keyVaultReference": {
"keyVault": {
"id": "string"
},
"secretName": "string",
"secretVersion": "string"
},
"value": {}
}
}
},
"externalInputDefinitions": {
"{customized property}": {
"config": {},
"kind": "string"
}
},
"externalInputs": {
"{customized property}": {
"value": {}
}
},
"mode": "string",
"onErrorDeployment": {
"deploymentName": "string",
"type": "string"
},
"parameters": {
"{customized property}": {
"expression": "string",
"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"
}
}
قيم الخصائص
Microsoft. الموارد/النشرات
| اسم |
الوصف |
القيمة |
| apiVersion |
إصدار واجهة برمجة التطبيقات |
'2025-04-01' |
| الهوية |
تكوين الهوية المدارة للنشر. |
DeploymentIdentity |
| مكان |
موقع تخزين بيانات النشر. |
سلسلة |
| اسم |
اسم المورد |
خيط
القيود: الحد الأدنى للطول = 1 الحد الأقصى للطول = 64 النمط = ^[-\w\._\(\)]+$ (مطلوب) |
| خصائص |
خصائص التوزيع. |
DeploymentPropertiesOrDeploymentPropertiesExtended (مطلوب) |
| العلامات |
علامات الموارد |
قاموس أسماء العلامات والقيم. راجع العلامات في القوالب |
| نوع |
نوع المورد |
'Microsoft. الموارد/النشرات' |
تصحيح الأخطاءالإعداد
| اسم |
الوصف |
القيمة |
| مستوى التفاصيل |
تحديد نوع المعلومات التي يجب تسجيلها لتصحيح الأخطاء. القيم المسموح بها هي none أو requestContent أو responseContent أو كل من requestContent و responseContent مفصولة بفاوصلة. الإعداد الافتراضي هو none. عند تعيين هذه القيمة، ضع في اعتبارك بعناية نوع المعلومات التي تمررها أثناء النشر. من خلال تسجيل معلومات حول الطلب أو الاستجابة، قد تعرض البيانات الحساسة التي يتم استردادها من خلال عمليات التوزيع. |
سلسلة |
DeploymentExtensionConfigItem
| اسم |
الوصف |
القيمة |
| مرجع keyVault |
المرجع المستخدم في Azure Key Vault لاسترجاع القيمة السرية لخاصية تكوين الإضافة. |
KeyVaultParameterReference |
| قيمة |
قيمة خاصية تكوين الملحق. |
أي |
DeploymentExternalInput
| اسم |
الوصف |
القيمة |
| قيمة |
قيمة الإدخال الخارجي. |
أي (مطلوب) |
النشر ExternalInputDefinition
| اسم |
الوصف |
القيمة |
| التكوين |
تكوين المدخلات الخارجية. |
أي |
| نوع |
نوع المدخلات الخارجية. |
سلسلة (مطلوب) |
DeploymentIdentity
DeploymentIdentityUserAssignedIdentities
أداة توزيع المعلمة
| اسم |
الوصف |
القيمة |
| تعبير |
إدخال التعبير إلى المعلمة. |
سلسلة |
| مرجع |
Azure Key Vault parameter reference. |
KeyVaultParameterReference |
| قيمة |
قيمة الإدخال إلى المعلمة . |
أي |
DeploymentPropertiesExtensionConfigs
DeploymentPropertiesOrDeploymentPropertiesExtended
| اسم |
الوصف |
القيمة |
| تصحيح الأخطاءإعداد |
إعداد تتبع الأخطاء للتوزيع. |
تصحيح الأخطاءالإعداد |
| عمليات تقييم التعبير |
يحدد ما إذا كان يتم تقييم تعبيرات القالب ضمن نطاق القالب الأصل أو القالب المتداخل. ينطبق فقط على القوالب المتداخلة. إذا لم يتم تحديدها، تكون القيمة الافتراضية خارجية. |
ExpressionEvaluationOptions |
| تكوينات الملحق |
التكوينات التي يجب استخدامها لملحقات التوزيع. مفاتيح هذا الكائن هي أسماء مستعارة لملحق التوزيع كما هو محدد في قالب النشر. |
DeploymentPropertiesExtensionConfigs |
| تعريفات خارجية |
تعريفات الإدخال الخارجي، التي تستخدمها الأدوات الخارجية لتحديد قيم الإدخال الخارجية المتوقعة. |
DeploymentPropertiesExternalInputDefinitions |
| المدخلات الخارجية |
قيم الإدخال الخارجية ، التي تستخدمها الأدوات الخارجية لتقييم المعلمات. |
DeploymentPropertiesExternalInputs |
| طريقة |
الوضع المستخدم لنشر الموارد. يمكن أن تكون هذه القيمة إما تزايدية أو كاملة. في الوضع التزايدي، يتم نشر الموارد دون حذف الموارد الموجودة غير المضمنة في القالب. في وضع الإكمال، يتم نشر الموارد ويتم حذف الموارد الموجودة في مجموعة الموارد غير المضمنة في القالب. كن حذرا عند استخدام وضع الإكمال حيث يمكنك حذف الموارد عن غير قصد. |
"مكتمل" "تزايدي" (مطلوب) |
| onErrorDeployment |
التوزيع على سلوك الخطأ. |
OnErrorDeploymentOrOnErrorDeploymentExtended |
| البارامترات |
أزواج الاسم والقيمة التي تحدد معلمات التوزيع للقالب. يمكنك استخدام هذا العنصر عندما تريد توفير قيم المعلمات مباشرة في الطلب بدلا من الارتباط بملف معلمة موجود. استخدم خاصية parametersLink أو خاصية المعلمات، ولكن ليس كليهما. يمكن أن يكون JObject أو سلسلة JSON جيدة التكوين. |
DeploymentPropertiesParameters |
| ارتباط المعلمات |
URI لملف المعلمات. يمكنك استخدام هذا العنصر للارتباط بملف معلمات موجود. استخدم خاصية parametersLink أو خاصية المعلمات، ولكن ليس كليهما. |
ارتباط المعلمات |
| قالب |
محتوى القالب. يمكنك استخدام هذا العنصر عندما تريد تمرير بناء جملة القالب مباشرة في الطلب بدلا من الارتباط بقالب موجود. يمكن أن يكون JObject أو سلسلة JSON جيدة التكوين. استخدم خاصية templateLink أو خاصية القالب، ولكن ليس كليهما. |
أي |
| ارتباط قالب |
URI للقالب. استخدم خاصية templateLink أو خاصية القالب، ولكن ليس كليهما. |
ارتباط قالب |
| مستوى التحقق من الصحة |
مستوى التحقق من صحة النشر |
"الموفر" "ProviderNoRbac" "قالب" |
معلمات خصائص التوزيع
DictionaryOfDeploymentExtensionConfigItem
عمليات تقييم التعبير
| اسم |
الوصف |
القيمة |
| نطاق |
النطاق الذي سيتم استخدامه لتقييم المعلمات والمتغيرات والوظائف في قالب متداخل. |
"داخلي" "غير محدد" 'الخارجي' |
مرجع KeyVaultParameter
| اسم |
الوصف |
القيمة |
| keyVault |
Azure Key Vault reference. |
KeyVaultReference (مطلوب) |
| اسم السر |
Azure Key Vault secret name. |
سلسلة (مطلوب) |
| إصدار سري |
Azure Key Vault secret version. |
سلسلة |
مرجع KeyVault
| اسم |
الوصف |
القيمة |
| معرف |
Azure Key Vault resource id. |
سلسلة (مطلوب) |
OnErrorDeploymentOrOnErrorDeploymentExtended
| اسم |
الوصف |
القيمة |
| اسم النشر |
التوزيع الذي سيتم استخدامه في حالة الخطأ. |
سلسلة |
| نوع |
التوزيع على نوع سلوك الخطأ. القيم المحتملة هي LastSuccessful و SpecificDeployment. |
"LastSuccessful" "نشر محدد" |
ارتباط المعلمات
| اسم |
الوصف |
القيمة |
| إصدار المحتوى |
إذا تم تضمينه، يجب أن يتطابق مع ContentVersion في القالب. |
سلسلة |
| URI |
URI لملف المعلمات. |
سلسلة (مطلوب) |
ارتباط قالب
| اسم |
الوصف |
القيمة |
| إصدار المحتوى |
إذا تم تضمينه، يجب أن يتطابق مع ContentVersion في القالب. |
سلسلة |
| معرف |
معرف المورد لمواصفات القالب. استخدم إما الخاصية id أو uri، ولكن ليس كليهما. |
سلسلة |
| سلسلة الاستعلام |
سلسلة الاستعلام (على سبيل المثال، رمز SAS المميز) لاستخدامها مع templateLink URI. |
سلسلة |
| مسار نسبي |
يمكن استخدام الخاصية relativePath لنشر قالب مرتبط في موقع نسبة إلى الأصل. إذا تم ربط القالب الأصل ب TemplateSpec، فسيشير هذا إلى أداة في TemplateSpec. إذا كان الأصل مرتبطا ب URI، فسيكون النشر التابع مزيجا من معرفات URI الأصل والنسبية |
سلسلة |
| URI |
URI للقالب المراد نشره. استخدم إما الخاصية uri أو id، ولكن ليس كليهما. |
سلسلة |
معرف تعيين المستخدم
أمثلة الاستخدام
يمكن نشر نوع مورد عمليات التوزيع مع العمليات التي تستهدف:
-
المستأجر* مجموعات* الإدارةالاشتراك* مجموعات الموارد
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .
لإنشاء Microsoft. موارد الموارد/النشرات، أضف النموذج التيرافوري التالي إلى قالبك.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Resources/deployments@2025-04-01"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
debugSetting = {
detailLevel = "string"
}
expressionEvaluationOptions = {
scope = "string"
}
extensionConfigs = {
{customized property} = {
{customized property} = {
keyVaultReference = {
keyVault = {
id = "string"
}
secretName = "string"
secretVersion = "string"
}
value = ?
}
}
}
externalInputDefinitions = {
{customized property} = {
config = ?
kind = "string"
}
}
externalInputs = {
{customized property} = {
value = ?
}
}
mode = "string"
onErrorDeployment = {
deploymentName = "string"
type = "string"
}
parameters = {
{customized property} = {
expression = "string"
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"
}
}
}
قيم الخصائص
Microsoft. الموارد/النشرات
| اسم |
الوصف |
القيمة |
| الهوية |
تكوين الهوية المدارة للنشر. |
DeploymentIdentity |
| مكان |
موقع تخزين بيانات النشر. |
سلسلة |
| اسم |
اسم المورد |
خيط
القيود: الحد الأدنى للطول = 1 الحد الأقصى للطول = 64 النمط = ^[-\w\._\(\)]+$ (مطلوب) |
| parent_id |
معرف المورد لتطبيق مورد الملحق هذا عليه. |
سلسلة (مطلوب) |
| خصائص |
خصائص التوزيع. |
DeploymentPropertiesOrDeploymentPropertiesExtended (مطلوب) |
| العلامات |
علامات الموارد |
قاموس أسماء العلامات والقيم. |
| نوع |
نوع المورد |
"Microsoft. الموارد/deployments@2025-04-01" |
تصحيح الأخطاءالإعداد
| اسم |
الوصف |
القيمة |
| مستوى التفاصيل |
تحديد نوع المعلومات التي يجب تسجيلها لتصحيح الأخطاء. القيم المسموح بها هي none أو requestContent أو responseContent أو كل من requestContent و responseContent مفصولة بفاوصلة. الإعداد الافتراضي هو none. عند تعيين هذه القيمة، ضع في اعتبارك بعناية نوع المعلومات التي تمررها أثناء النشر. من خلال تسجيل معلومات حول الطلب أو الاستجابة، قد تعرض البيانات الحساسة التي يتم استردادها من خلال عمليات التوزيع. |
سلسلة |
DeploymentExtensionConfigItem
| اسم |
الوصف |
القيمة |
| مرجع keyVault |
المرجع المستخدم في Azure Key Vault لاسترجاع القيمة السرية لخاصية تكوين الإضافة. |
KeyVaultParameterReference |
| قيمة |
قيمة خاصية تكوين الملحق. |
أي |
DeploymentExternalInput
| اسم |
الوصف |
القيمة |
| قيمة |
قيمة الإدخال الخارجي. |
أي (مطلوب) |
النشر ExternalInputDefinition
| اسم |
الوصف |
القيمة |
| التكوين |
تكوين المدخلات الخارجية. |
أي |
| نوع |
نوع المدخلات الخارجية. |
سلسلة (مطلوب) |
DeploymentIdentity
DeploymentIdentityUserAssignedIdentities
أداة توزيع المعلمة
| اسم |
الوصف |
القيمة |
| تعبير |
إدخال التعبير إلى المعلمة. |
سلسلة |
| مرجع |
Azure Key Vault parameter reference. |
KeyVaultParameterReference |
| قيمة |
قيمة الإدخال إلى المعلمة . |
أي |
DeploymentPropertiesExtensionConfigs
DeploymentPropertiesOrDeploymentPropertiesExtended
| اسم |
الوصف |
القيمة |
| تصحيح الأخطاءإعداد |
إعداد تتبع الأخطاء للتوزيع. |
تصحيح الأخطاءالإعداد |
| عمليات تقييم التعبير |
يحدد ما إذا كان يتم تقييم تعبيرات القالب ضمن نطاق القالب الأصل أو القالب المتداخل. ينطبق فقط على القوالب المتداخلة. إذا لم يتم تحديدها، تكون القيمة الافتراضية خارجية. |
ExpressionEvaluationOptions |
| تكوينات الملحق |
التكوينات التي يجب استخدامها لملحقات التوزيع. مفاتيح هذا الكائن هي أسماء مستعارة لملحق التوزيع كما هو محدد في قالب النشر. |
DeploymentPropertiesExtensionConfigs |
| تعريفات خارجية |
تعريفات الإدخال الخارجي، التي تستخدمها الأدوات الخارجية لتحديد قيم الإدخال الخارجية المتوقعة. |
DeploymentPropertiesExternalInputDefinitions |
| المدخلات الخارجية |
قيم الإدخال الخارجية ، التي تستخدمها الأدوات الخارجية لتقييم المعلمات. |
DeploymentPropertiesExternalInputs |
| طريقة |
الوضع المستخدم لنشر الموارد. يمكن أن تكون هذه القيمة إما تزايدية أو كاملة. في الوضع التزايدي، يتم نشر الموارد دون حذف الموارد الموجودة غير المضمنة في القالب. في وضع الإكمال، يتم نشر الموارد ويتم حذف الموارد الموجودة في مجموعة الموارد غير المضمنة في القالب. كن حذرا عند استخدام وضع الإكمال حيث يمكنك حذف الموارد عن غير قصد. |
"مكتمل" "تزايدي" (مطلوب) |
| onErrorDeployment |
التوزيع على سلوك الخطأ. |
OnErrorDeploymentOrOnErrorDeploymentExtended |
| البارامترات |
أزواج الاسم والقيمة التي تحدد معلمات التوزيع للقالب. يمكنك استخدام هذا العنصر عندما تريد توفير قيم المعلمات مباشرة في الطلب بدلا من الارتباط بملف معلمة موجود. استخدم خاصية parametersLink أو خاصية المعلمات، ولكن ليس كليهما. يمكن أن يكون JObject أو سلسلة JSON جيدة التكوين. |
DeploymentPropertiesParameters |
| ارتباط المعلمات |
URI لملف المعلمات. يمكنك استخدام هذا العنصر للارتباط بملف معلمات موجود. استخدم خاصية parametersLink أو خاصية المعلمات، ولكن ليس كليهما. |
ارتباط المعلمات |
| قالب |
محتوى القالب. يمكنك استخدام هذا العنصر عندما تريد تمرير بناء جملة القالب مباشرة في الطلب بدلا من الارتباط بقالب موجود. يمكن أن يكون JObject أو سلسلة JSON جيدة التكوين. استخدم خاصية templateLink أو خاصية القالب، ولكن ليس كليهما. |
أي |
| ارتباط قالب |
URI للقالب. استخدم خاصية templateLink أو خاصية القالب، ولكن ليس كليهما. |
ارتباط قالب |
| مستوى التحقق من الصحة |
مستوى التحقق من صحة النشر |
"الموفر" "ProviderNoRbac" "قالب" |
معلمات خصائص التوزيع
DictionaryOfDeploymentExtensionConfigItem
عمليات تقييم التعبير
| اسم |
الوصف |
القيمة |
| نطاق |
النطاق الذي سيتم استخدامه لتقييم المعلمات والمتغيرات والوظائف في قالب متداخل. |
"داخلي" "غير محدد" 'الخارجي' |
مرجع KeyVaultParameter
| اسم |
الوصف |
القيمة |
| keyVault |
Azure Key Vault reference. |
KeyVaultReference (مطلوب) |
| اسم السر |
Azure Key Vault secret name. |
سلسلة (مطلوب) |
| إصدار سري |
Azure Key Vault secret version. |
سلسلة |
مرجع KeyVault
| اسم |
الوصف |
القيمة |
| معرف |
Azure Key Vault resource id. |
سلسلة (مطلوب) |
OnErrorDeploymentOrOnErrorDeploymentExtended
| اسم |
الوصف |
القيمة |
| اسم النشر |
التوزيع الذي سيتم استخدامه في حالة الخطأ. |
سلسلة |
| نوع |
التوزيع على نوع سلوك الخطأ. القيم المحتملة هي LastSuccessful و SpecificDeployment. |
"LastSuccessful" "نشر محدد" |
ارتباط المعلمات
| اسم |
الوصف |
القيمة |
| إصدار المحتوى |
إذا تم تضمينه، يجب أن يتطابق مع ContentVersion في القالب. |
سلسلة |
| URI |
URI لملف المعلمات. |
سلسلة (مطلوب) |
ارتباط قالب
| اسم |
الوصف |
القيمة |
| إصدار المحتوى |
إذا تم تضمينه، يجب أن يتطابق مع ContentVersion في القالب. |
سلسلة |
| معرف |
معرف المورد لمواصفات القالب. استخدم إما الخاصية id أو uri، ولكن ليس كليهما. |
سلسلة |
| سلسلة الاستعلام |
سلسلة الاستعلام (على سبيل المثال، رمز SAS المميز) لاستخدامها مع templateLink URI. |
سلسلة |
| مسار نسبي |
يمكن استخدام الخاصية relativePath لنشر قالب مرتبط في موقع نسبة إلى الأصل. إذا تم ربط القالب الأصل ب TemplateSpec، فسيشير هذا إلى أداة في TemplateSpec. إذا كان الأصل مرتبطا ب URI، فسيكون النشر التابع مزيجا من معرفات URI الأصل والنسبية |
سلسلة |
| URI |
URI للقالب المراد نشره. استخدم إما الخاصية uri أو id، ولكن ليس كليهما. |
سلسلة |
معرف تعيين المستخدم
أمثلة الاستخدام
مثال أساسي لنشر نشر القالب.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "deployment" {
type = "Microsoft.Resources/deployments@2020-06-01"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
body = {
properties = {
mode = "Complete"
template = {
"$schema" = "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#"
contentVersion = "1.0.0.0"
parameters = {
storageAccountType = {
allowedValues = [
"Standard_LRS",
"Standard_GRS",
"Standard_ZRS",
]
defaultValue = "Standard_LRS"
metadata = {
description = "Storage Account type"
}
type = "string"
}
}
resources = [
{
apiVersion = "[variables('apiVersion')]"
location = "[variables('location')]"
name = "[variables('storageAccountName')]"
properties = {
accountType = "[parameters('storageAccountType')]"
}
type = "Microsoft.Storage/storageAccounts"
},
{
apiVersion = "[variables('apiVersion')]"
location = "[variables('location')]"
name = "[variables('publicIPAddressName')]"
properties = {
dnsSettings = {
domainNameLabel = "[variables('dnsLabelPrefix')]"
}
publicIPAllocationMethod = "[variables('publicIPAddressType')]"
}
type = "Microsoft.Network/publicIPAddresses"
},
]
variables = {
apiVersion = "2015-06-15"
dnsLabelPrefix = "[concat('terraform-tdacctest', uniquestring(resourceGroup().id))]"
location = "[resourceGroup().location]"
publicIPAddressName = "[concat('myPublicIp', uniquestring(resourceGroup().id))]"
publicIPAddressType = "Dynamic"
storageAccountName = "[concat(uniquestring(resourceGroup().id), 'storage')]"
}
}
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}