Microsoft. نشر الموارد 2025-04-01

• أحدث
• 2025-04-01
• 2025-03-01
• 2024-11-01
• 2024-07-01
• 2024-03-01
• 2023-07-01
• 2022-09-01
• 2021-04-01
• 2021-01-01
• 2020-10-01
• 2020-08-01
• 2020-06-01
• 2019-10-01
• 2019-08-01
• 2019-07-01
• 2019-05-10
• 2019-05-01
• 2019-03-01
• 2018-05-01
• 2018-02-01
• 2017-05-10
• 2016-09-01
• 2016-07-01
• 2016-02-01
• 2015-11-01

ملاحظات

بالنسبة ل 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

اسم	وصف	قيمة
نوع	نوع الهوية.	"بلا" "UserAssigned" (مطلوب)
معرفات تعيين المستخدم	مجموعة الهويات المعينة من قبل المستخدم المقترنة بالمورد.	DeploymentIdentityUserAssignedIdentities

DeploymentIdentityUserAssignedIdentities

اسم	وصف	قيمة

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

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

DeploymentPropertiesExtensionConfigs

اسم	وصف	قيمة

DeploymentPropertiesExternalInputDefinitions

اسم	وصف	قيمة

DeploymentPropertiesExternalInputs

اسم	وصف	قيمة

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.	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، ولكن ليس كليهما.	خيط

معرف تعيين المستخدم

اسم	وصف	قيمة

أمثلة الاستخدام

عينات Bicep

مثال أساسي لنشر نشر القالب.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource deployment 'Microsoft.Resources/deployments@2020-06-01' = {
  name: resourceName
  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: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
          location: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
          name: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
          properties: {
            accountType: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
          }
          type: 'Microsoft.Storage/storageAccounts'
        }
        {
          apiVersion: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
          location: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
          name: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
          properties: {
            dnsSettings: {
              domainNameLabel: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
            }
            publicIPAllocationMethod: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
          }
          type: 'Microsoft.Network/publicIPAddresses'
        }
      ]
      variables: {
        apiVersion: '2015-06-15'
        dnsLabelPrefix: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
        location: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
        publicIPAddressName: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
        publicIPAddressType: 'Dynamic'
        storageAccountName: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
      }
    }
  }
}

تعريف مورد قالب 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

اسم	وصف	قيمة
نوع	نوع الهوية.	"بلا" "UserAssigned" (مطلوب)
معرفات تعيين المستخدم	مجموعة الهويات المعينة من قبل المستخدم المقترنة بالمورد.	DeploymentIdentityUserAssignedIdentities

DeploymentIdentityUserAssignedIdentities

اسم	وصف	قيمة

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

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

DeploymentPropertiesExtensionConfigs

اسم	وصف	قيمة

DeploymentPropertiesExternalInputDefinitions

اسم	وصف	قيمة

DeploymentPropertiesExternalInputs

اسم	وصف	قيمة

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.	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 (موفر AzAPI)

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

• المستأجر* مجموعات* الإدارةالاشتراك* مجموعات الموارد

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

تنسيق المورد

لإنشاء 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

اسم	وصف	قيمة
نوع	نوع الهوية.	"بلا" "UserAssigned" (مطلوب)
معرفات تعيين المستخدم	مجموعة الهويات المعينة من قبل المستخدم المقترنة بالمورد.	DeploymentIdentityUserAssignedIdentities

DeploymentIdentityUserAssignedIdentities

اسم	وصف	قيمة

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

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

DeploymentPropertiesExtensionConfigs

اسم	وصف	قيمة

DeploymentPropertiesExternalInputDefinitions

اسم	وصف	قيمة

DeploymentPropertiesExternalInputs

اسم	وصف	قيمة

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.	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

مثال أساسي لنشر نشر القالب.

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    = ["*"]
}