مشاركة عبر

عمليات نشر Microsoft.Resources 2022-09-01

  • مقالة

ملاحظات

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

تعريف مورد Bicep

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

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

تنسيق المورد

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

resource symbolicname 'Microsoft.Resources/deployments@2022-09-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(...)
      }
    }
    parametersLink: {
      contentVersion: 'string'
      uri: 'string'
    }
    template: any(...)
    templateLink: {
      contentVersion: 'string'
      id: 'string'
      queryString: 'string'
      relativePath: 'string'
      uri: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

قيم الخصائص

تصحيح الأخطاءالإعداد

اسم وصف قيمة
مستوى التفاصيل تحديد نوع المعلومات التي يجب تسجيلها لتصحيح الأخطاء. القيم المسموح بها هي none أو requestContent أو responseContent أو كل من requestContent و responseContent مفصولة بفاوصلة. الإعداد الافتراضي هو none. عند تعيين هذه القيمة، ضع في اعتبارك بعناية نوع المعلومات التي تمررها أثناء النشر. من خلال تسجيل معلومات حول الطلب أو الاستجابة، قد تعرض البيانات الحساسة التي يتم استردادها من خلال عمليات التوزيع. خيط

أداة توزيع المعلمة

اسم وصف قيمة
مرجع مرجع معلمة Azure Key Vault. KeyVaultParameterReference
قيمة قيمة الإدخال إلى المعلمة . أي

DeploymentPropertiesOrDeploymentPropertiesExtended

اسم وصف قيمة
تصحيح الأخطاءإعداد إعداد تتبع الأخطاء للتوزيع. DebugSetting
عمليات تقييم التعبير يحدد ما إذا كان يتم تقييم تعبيرات القالب ضمن نطاق القالب الأصل أو القالب المتداخل. ينطبق فقط على القوالب المتداخلة. إذا لم يتم تحديدها، تكون القيمة الافتراضية خارجية. ExpressionEvaluationOptions
طريقة الوضع المستخدم لنشر الموارد. يمكن أن تكون هذه القيمة إما تزايدية أو كاملة. في الوضع التزايدي، يتم نشر الموارد دون حذف الموارد الموجودة غير المضمنة في القالب. في وضع الإكمال، يتم نشر الموارد ويتم حذف الموارد الموجودة في مجموعة الموارد غير المضمنة في القالب. كن حذرا عند استخدام وضع الإكمال حيث يمكنك حذف الموارد عن غير قصد. "مكتمل"
"تزايدي" (مطلوب)
onErrorDeployment التوزيع على سلوك الخطأ. OnErrorDeploymentOrOnErrorDeploymentExtended
البارامترات أزواج الاسم والقيمة التي تحدد معلمات التوزيع للقالب. يمكنك استخدام هذا العنصر عندما تريد توفير قيم المعلمات مباشرة في الطلب بدلا من الارتباط بملف معلمة موجود. استخدم خاصية parametersLink أو خاصية المعلمات، ولكن ليس كليهما. يمكن أن يكون JObject أو سلسلة JSON جيدة التكوين. DeploymentPropertiesParameters
ارتباط المعلمات URI لملف المعلمات. يمكنك استخدام هذا العنصر للارتباط بملف معلمات موجود. استخدم خاصية parametersLink أو خاصية المعلمات، ولكن ليس كليهما. ربط المعلمات
قالب محتوى القالب. يمكنك استخدام هذا العنصر عندما تريد تمرير بناء جملة القالب مباشرة في الطلب بدلا من الارتباط بقالب موجود. يمكن أن يكون JObject أو سلسلة JSON جيدة التكوين. استخدم خاصية templateLink أو خاصية القالب، ولكن ليس كليهما. أي
ارتباط قالب URI للقالب. استخدم خاصية templateLink أو خاصية القالب، ولكن ليس كليهما. TemplateLink

معلمات خصائص التوزيع

اسم وصف قيمة

علامات التوزيع

اسم وصف قيمة

عمليات تقييم التعبير

اسم وصف قيمة
نطاق النطاق الذي سيتم استخدامه لتقييم المعلمات والمتغيرات والوظائف في قالب متداخل. "داخلي"
"غير محدد"
'الخارجي'

مرجع 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": "2022-09-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"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

قيم الخصائص

تصحيح الأخطاءالإعداد

اسم وصف قيمة
مستوى التفاصيل تحديد نوع المعلومات التي يجب تسجيلها لتصحيح الأخطاء. القيم المسموح بها هي none أو requestContent أو responseContent أو كل من requestContent و responseContent مفصولة بفاوصلة. الإعداد الافتراضي هو none. عند تعيين هذه القيمة، ضع في اعتبارك بعناية نوع المعلومات التي تمررها أثناء النشر. من خلال تسجيل معلومات حول الطلب أو الاستجابة، قد تعرض البيانات الحساسة التي يتم استردادها من خلال عمليات التوزيع. خيط

أداة توزيع المعلمة

اسم وصف قيمة
مرجع مرجع معلمة Azure Key Vault. KeyVaultParameterReference
قيمة قيمة الإدخال إلى المعلمة . أي

DeploymentPropertiesOrDeploymentPropertiesExtended

اسم وصف قيمة
تصحيح الأخطاءإعداد إعداد تتبع الأخطاء للتوزيع. DebugSetting
عمليات تقييم التعبير يحدد ما إذا كان يتم تقييم تعبيرات القالب ضمن نطاق القالب الأصل أو القالب المتداخل. ينطبق فقط على القوالب المتداخلة. إذا لم يتم تحديدها، تكون القيمة الافتراضية خارجية. ExpressionEvaluationOptions
طريقة الوضع المستخدم لنشر الموارد. يمكن أن تكون هذه القيمة إما تزايدية أو كاملة. في الوضع التزايدي، يتم نشر الموارد دون حذف الموارد الموجودة غير المضمنة في القالب. في وضع الإكمال، يتم نشر الموارد ويتم حذف الموارد الموجودة في مجموعة الموارد غير المضمنة في القالب. كن حذرا عند استخدام وضع الإكمال حيث يمكنك حذف الموارد عن غير قصد. "مكتمل"
"تزايدي" (مطلوب)
onErrorDeployment التوزيع على سلوك الخطأ. OnErrorDeploymentOrOnErrorDeploymentExtended
البارامترات أزواج الاسم والقيمة التي تحدد معلمات التوزيع للقالب. يمكنك استخدام هذا العنصر عندما تريد توفير قيم المعلمات مباشرة في الطلب بدلا من الارتباط بملف معلمة موجود. استخدم خاصية parametersLink أو خاصية المعلمات، ولكن ليس كليهما. يمكن أن يكون JObject أو سلسلة JSON جيدة التكوين. DeploymentPropertiesParameters
ارتباط المعلمات URI لملف المعلمات. يمكنك استخدام هذا العنصر للارتباط بملف معلمات موجود. استخدم خاصية parametersLink أو خاصية المعلمات، ولكن ليس كليهما. ربط المعلمات
قالب محتوى القالب. يمكنك استخدام هذا العنصر عندما تريد تمرير بناء جملة القالب مباشرة في الطلب بدلا من الارتباط بقالب موجود. يمكن أن يكون JObject أو سلسلة JSON جيدة التكوين. استخدم خاصية templateLink أو خاصية القالب، ولكن ليس كليهما. أي
ارتباط قالب URI للقالب. استخدم خاصية templateLink أو خاصية القالب، ولكن ليس كليهما. TemplateLink

معلمات خصائص التوزيع

اسم وصف قيمة

علامات التوزيع

اسم وصف قيمة

عمليات تقييم التعبير

اسم وصف قيمة
نطاق النطاق الذي سيتم استخدامه لتقييم المعلمات والمتغيرات والوظائف في قالب متداخل. "داخلي"
"غير محدد"
'الخارجي'

مرجع KeyVaultParameter

اسم وصف قيمة
keyVault مرجع Azure Key Vault. KeyVaultReference (مطلوب)
اسم السر الاسم السري ل Azure Key Vault. سلسلة (مطلوب)
إصدار سري الإصدار السري ل Azure Key Vault. خيط

مرجع KeyVault

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

Microsoft.Resources/deployments

اسم وصف قيمة
apiVersion إصدار واجهة برمجة التطبيقات '2022-09-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@2022-09-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"
      }
    }
  })
}

قيم الخصائص

تصحيح الأخطاءالإعداد

اسم وصف قيمة
مستوى التفاصيل تحديد نوع المعلومات التي يجب تسجيلها لتصحيح الأخطاء. القيم المسموح بها هي none أو requestContent أو responseContent أو كل من requestContent و responseContent مفصولة بفاوصلة. الإعداد الافتراضي هو none. عند تعيين هذه القيمة، ضع في اعتبارك بعناية نوع المعلومات التي تمررها أثناء النشر. من خلال تسجيل معلومات حول الطلب أو الاستجابة، قد تعرض البيانات الحساسة التي يتم استردادها من خلال عمليات التوزيع. خيط

أداة توزيع المعلمة

اسم وصف قيمة
مرجع مرجع معلمة Azure Key Vault. KeyVaultParameterReference
قيمة قيمة الإدخال إلى المعلمة . أي

DeploymentPropertiesOrDeploymentPropertiesExtended

اسم وصف قيمة
تصحيح الأخطاءإعداد إعداد تتبع الأخطاء للتوزيع. DebugSetting
عمليات تقييم التعبير يحدد ما إذا كان يتم تقييم تعبيرات القالب ضمن نطاق القالب الأصل أو القالب المتداخل. ينطبق فقط على القوالب المتداخلة. إذا لم يتم تحديدها، تكون القيمة الافتراضية خارجية. ExpressionEvaluationOptions
طريقة الوضع المستخدم لنشر الموارد. يمكن أن تكون هذه القيمة إما تزايدية أو كاملة. في الوضع التزايدي، يتم نشر الموارد دون حذف الموارد الموجودة غير المضمنة في القالب. في وضع الإكمال، يتم نشر الموارد ويتم حذف الموارد الموجودة في مجموعة الموارد غير المضمنة في القالب. كن حذرا عند استخدام وضع الإكمال حيث يمكنك حذف الموارد عن غير قصد. "مكتمل"
"تزايدي" (مطلوب)
onErrorDeployment التوزيع على سلوك الخطأ. OnErrorDeploymentOrOnErrorDeploymentExtended
البارامترات أزواج الاسم والقيمة التي تحدد معلمات التوزيع للقالب. يمكنك استخدام هذا العنصر عندما تريد توفير قيم المعلمات مباشرة في الطلب بدلا من الارتباط بملف معلمة موجود. استخدم خاصية parametersLink أو خاصية المعلمات، ولكن ليس كليهما. يمكن أن يكون JObject أو سلسلة JSON جيدة التكوين. DeploymentPropertiesParameters
ارتباط المعلمات URI لملف المعلمات. يمكنك استخدام هذا العنصر للارتباط بملف معلمات موجود. استخدم خاصية parametersLink أو خاصية المعلمات، ولكن ليس كليهما. ربط المعلمات
قالب محتوى القالب. يمكنك استخدام هذا العنصر عندما تريد تمرير بناء جملة القالب مباشرة في الطلب بدلا من الارتباط بقالب موجود. يمكن أن يكون JObject أو سلسلة JSON جيدة التكوين. استخدم خاصية templateLink أو خاصية القالب، ولكن ليس كليهما. أي
ارتباط قالب URI للقالب. استخدم خاصية templateLink أو خاصية القالب، ولكن ليس كليهما. TemplateLink

معلمات خصائص التوزيع

اسم وصف قيمة

علامات التوزيع

اسم وصف قيمة

عمليات تقييم التعبير

اسم وصف قيمة
نطاق النطاق الذي سيتم استخدامه لتقييم المعلمات والمتغيرات والوظائف في قالب متداخل. "داخلي"
"غير محدد"
'الخارجي'

مرجع 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@2022-09-01"

OnErrorDeploymentOrOnErrorDeploymentExtended

اسم وصف قيمة
اسم النشر التوزيع الذي سيتم استخدامه في حالة الخطأ. خيط
نوع التوزيع على نوع سلوك الخطأ. القيم المحتملة هي LastSuccessful و SpecificDeployment. "LastSuccessful"
"نشر محدد"
اسم وصف قيمة
إصدار المحتوى إذا تم تضمينه، يجب أن يتطابق مع ContentVersion في القالب. خيط
uri URI لملف المعلمات. سلسلة (مطلوب)
اسم وصف قيمة
إصدار المحتوى إذا تم تضمينه، يجب أن يتطابق مع ContentVersion في القالب. خيط
معرف معرف المورد لمواصفات القالب. استخدم إما الخاصية id أو uri، ولكن ليس كليهما. خيط
سلسلة الاستعلام سلسلة الاستعلام (على سبيل المثال، رمز SAS المميز) لاستخدامها مع templateLink URI. خيط
مسار نسبي يمكن استخدام الخاصية relativePath لنشر قالب مرتبط في موقع نسبة إلى الأصل. إذا تم ربط القالب الأصل ب TemplateSpec، فسيشير هذا إلى أداة في TemplateSpec. إذا كان الأصل مرتبطا ب URI، فسيكون النشر التابع مزيجا من معرفات URI الأصل والنسبية خيط
uri URI للقالب المراد نشره. استخدم إما الخاصية uri أو id، ولكن ليس كليهما. خيط