تعريف مورد Bicep
يمكن نشر نوع مورد الملحقات مع العمليات التي تستهدف:
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .
أمثلة الاستخدام
عينات Bicep
مثال أساسي على نشر ملحق نظام مجموعة Kubernetes.
param resourceName string = 'acctest0001'
param location string = 'westeurope'
resource managedCluster 'Microsoft.ContainerService/managedClusters@2023-04-02-preview' = {
name: resourceName
location: location
properties: {
agentPoolProfiles: [
{
count: 1
mode: 'System'
name: 'default'
vmSize: 'Standard_DS2_v2'
}
]
dnsPrefix: resourceName
}
}
resource extension 'Microsoft.KubernetesConfiguration/extensions@2022-11-01' = {
name: resourceName
scope: managedCluster
properties: {
autoUpgradeMinorVersion: true
extensionType: 'microsoft.flux'
}
}
الوحدات النمطية التي تم التحقق منها من Azure
يمكن استخدام الوحدات النمطية Azure Verified لنشر نوع المورد هذا.
| الوحده النمطيه |
وصف |
|
ملحق تكوين Kubernetes |
وحدة موارد AVM لملحق تكوين Kubernetes |
لإنشاء مورد Microsoft.KubernetesConfiguration/extensions، أضف Bicep التالي إلى القالب الخاص بك.
resource symbolicname 'Microsoft.KubernetesConfiguration/extensions@2023-05-01' = {
scope: resourceSymbolicName or scope
identity: {
type: 'SystemAssigned'
}
name: 'string'
plan: {
name: 'string'
product: 'string'
promotionCode: 'string'
publisher: 'string'
version: 'string'
}
properties: {
aksAssignedIdentity: {
type: 'string'
}
autoUpgradeMinorVersion: bool
configurationProtectedSettings: {
{customized property}: 'string'
}
configurationSettings: {
{customized property}: 'string'
}
extensionType: 'string'
releaseTrain: 'string'
scope: {
cluster: {
releaseNamespace: 'string'
}
namespace: {
targetNamespace: 'string'
}
}
statuses: [
{
code: 'string'
displayStatus: 'string'
level: 'string'
message: 'string'
time: 'string'
}
]
version: 'string'
}
}
قيم الخصائص
Microsoft.KubernetesConfiguration/extensions
| اسم |
وصف |
قيمة |
| الهوية |
هوية مورد الملحق |
الهوية |
| اسم |
اسم المورد |
سلسلة (مطلوب) |
| خطة |
معلومات الخطة. |
خطة |
| خصائص |
خصائص مورد ملحق |
ExtensionProperties |
| نطاق |
استخدم عند إنشاء مورد في نطاق مختلف عن نطاق النشر. |
قم بتعيين هذه الخاصية إلى الاسم الرمزي لمورد لتطبيق مورد ملحق . |
خصائص الملحقات
| اسم |
وصف |
قيمة |
| aksAssignedIdentity |
هوية مورد الملحق في نظام مجموعة AKS |
ExtensionPropertiesAksAssignedIdentity |
| AutoUpgradeMinorVersion |
ضع علامة لملاحظة ما إذا كان هذا الملحق يشارك في الترقية التلقائية للإصدار الثانوي، أم لا. |
قيمة منطقية |
| إعدادات التكوين المحمية |
إعدادات التكوين الحساسة، كأزواج قيمة الاسم لتكوين هذا الملحق. |
ExtensionPropertiesConfigurationProtectedSettings |
| إعدادات التكوين |
إعدادات التكوين، كأزواج اسم-قيمة لتكوين هذا الملحق. |
إعدادات تكوين خصائص الملحقات |
| نوع الملحق |
نوع الملحق، الذي يمثل هذا المورد مثيلا له. يجب أن يكون أحد أنواع الملحقات المسجلة مع Microsoft.KubernetesConfiguration بواسطة ناشر الملحق. |
خيط |
| إصدار التدريب |
ReleaseTrain يشارك هذا الملحق للترقية التلقائية (على سبيل المثال، ثابت، معاينة، وما إلى ذلك) - فقط إذا كان autoUpgradeMinorVersion هو "صحيح". |
خيط |
| نطاق |
النطاق الذي تم تثبيت الملحق فيه. |
نطاق |
| حالات |
الحالة من هذا الملحق. |
ExtensionStatus [] |
| الإصدار |
الإصدار المحدد من قبل المستخدم من الملحق لهذا الملحق إلى "pin". لاستخدام 'version'، يجب أن يكون autoUpgradeMinorVersion 'false'. |
خيط |
ExtensionPropertiesAksAssignedIdentity
| اسم |
وصف |
قيمة |
| نوع |
نوع الهوية. |
"تم تعيين النظام" "تعيين المستخدم" |
ExtensionPropertiesConfigurationProtectedSettings
إعدادات تكوين خصائص الملحقات
إحصائيات الملحقات
| اسم |
وصف |
قيمة |
| رمز |
رمز الحالة الذي يوفره الملحق |
خيط |
| displayStatus |
وصف مختصر لحالة الملحق. |
خيط |
| مستوى |
مستوى الحالة. |
"خطأ" "معلومات" "تحذير" |
| رسالة |
رسالة مفصلة للحالة من الملحق. |
خيط |
| الوقت |
DateLiteral (لكل ISO8601) يشير إلى وقت حالة التثبيت. |
خيط |
الهوية
| اسم |
وصف |
قيمة |
| نوع |
نوع الهوية. |
"تم تعيين النظام" |
خطة
| اسم |
وصف |
قيمة |
| اسم |
اسم معرف من قبل المستخدم لأداة الطرف الثالث التي يتم شراؤها. |
سلسلة (مطلوب) |
| حاصل الضرب |
أداة الطرف الثالث التي يتم شراؤها. على سبيل المثال NewRelic. يتم تعيين المنتج إلى OfferID المحدد للبيانات الاصطناعية في وقت إلحاق سوق البيانات. |
سلسلة (مطلوب) |
| رمز الترقية |
قدم ناشر رمز الترويج كما هو متوفر في سوق البيانات للمنتج/البيانات الاصطناعية المذكورة. |
خيط |
| ناشر |
ناشر أداة الطرف الثالث التي يتم شراؤها. على سبيل المثال NewRelic |
سلسلة (مطلوب) |
| الإصدار |
إصدار المنتج/البيانات الاصطناعية المطلوبة. |
خيط |
نطاق
| اسم |
وصف |
قيمة |
| عنقود |
تحديد أن نطاق الملحق هو نظام المجموعة |
ScopeCluster |
| Namespace |
تحديد أن نطاق الملحق هو Namespace |
ScopeNamespace |
ScopeCluster
| اسم |
وصف |
قيمة |
| مساحة اسم الإصدار |
مساحة الاسم حيث يجب وضع إصدار الملحق، لملحق نطاق نظام المجموعة. إذا لم تكن مساحة الاسم هذه موجودة، إنشاؤها |
خيط |
مساحة اسم النطاق
| اسم |
وصف |
قيمة |
| targetNamespace |
مساحة الاسم حيث سيتم إنشاء الملحق لملحق نطاق مساحة الاسم. إذا لم تكن مساحة الاسم هذه موجودة، إنشاؤها |
خيط |
تعريف مورد قالب ARM
يمكن نشر نوع مورد الملحقات مع العمليات التي تستهدف:
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .
أمثلة الاستخدام
لإنشاء مورد Microsoft.KubernetesConfiguration/extensions، أضف JSON التالي إلى القالب الخاص بك.
{
"type": "Microsoft.KubernetesConfiguration/extensions",
"apiVersion": "2023-05-01",
"name": "string",
"identity": {
"type": "SystemAssigned"
},
"plan": {
"name": "string",
"product": "string",
"promotionCode": "string",
"publisher": "string",
"version": "string"
},
"properties": {
"aksAssignedIdentity": {
"type": "string"
},
"autoUpgradeMinorVersion": "bool",
"configurationProtectedSettings": {
"{customized property}": "string"
},
"configurationSettings": {
"{customized property}": "string"
},
"extensionType": "string",
"releaseTrain": "string",
"scope": {
"cluster": {
"releaseNamespace": "string"
},
"namespace": {
"targetNamespace": "string"
}
},
"statuses": [
{
"code": "string",
"displayStatus": "string",
"level": "string",
"message": "string",
"time": "string"
}
],
"version": "string"
}
}
قيم الخصائص
Microsoft.KubernetesConfiguration/extensions
| اسم |
وصف |
قيمة |
| apiVersion |
إصدار واجهة برمجة التطبيقات |
'2023-05-01' |
| الهوية |
هوية مورد الملحق |
الهوية |
| اسم |
اسم المورد |
سلسلة (مطلوب) |
| خطة |
معلومات الخطة. |
خطة |
| خصائص |
خصائص مورد ملحق |
ExtensionProperties |
| نوع |
نوع المورد |
"Microsoft.KubernetesConfiguration/extensions" |
خصائص الملحقات
| اسم |
وصف |
قيمة |
| aksAssignedIdentity |
هوية مورد الملحق في نظام مجموعة AKS |
ExtensionPropertiesAksAssignedIdentity |
| AutoUpgradeMinorVersion |
ضع علامة لملاحظة ما إذا كان هذا الملحق يشارك في الترقية التلقائية للإصدار الثانوي، أم لا. |
قيمة منطقية |
| إعدادات التكوين المحمية |
إعدادات التكوين الحساسة، كأزواج قيمة الاسم لتكوين هذا الملحق. |
ExtensionPropertiesConfigurationProtectedSettings |
| إعدادات التكوين |
إعدادات التكوين، كأزواج اسم-قيمة لتكوين هذا الملحق. |
إعدادات تكوين خصائص الملحقات |
| نوع الملحق |
نوع الملحق، الذي يمثل هذا المورد مثيلا له. يجب أن يكون أحد أنواع الملحقات المسجلة مع Microsoft.KubernetesConfiguration بواسطة ناشر الملحق. |
خيط |
| إصدار التدريب |
ReleaseTrain يشارك هذا الملحق للترقية التلقائية (على سبيل المثال، ثابت، معاينة، وما إلى ذلك) - فقط إذا كان autoUpgradeMinorVersion هو "صحيح". |
خيط |
| نطاق |
النطاق الذي تم تثبيت الملحق فيه. |
نطاق |
| حالات |
الحالة من هذا الملحق. |
ExtensionStatus [] |
| الإصدار |
الإصدار المحدد من قبل المستخدم من الملحق لهذا الملحق إلى "pin". لاستخدام 'version'، يجب أن يكون autoUpgradeMinorVersion 'false'. |
خيط |
ExtensionPropertiesAksAssignedIdentity
| اسم |
وصف |
قيمة |
| نوع |
نوع الهوية. |
"تم تعيين النظام" "تعيين المستخدم" |
ExtensionPropertiesConfigurationProtectedSettings
إعدادات تكوين خصائص الملحقات
إحصائيات الملحقات
| اسم |
وصف |
قيمة |
| رمز |
رمز الحالة الذي يوفره الملحق |
خيط |
| displayStatus |
وصف مختصر لحالة الملحق. |
خيط |
| مستوى |
مستوى الحالة. |
"خطأ" "معلومات" "تحذير" |
| رسالة |
رسالة مفصلة للحالة من الملحق. |
خيط |
| الوقت |
DateLiteral (لكل ISO8601) يشير إلى وقت حالة التثبيت. |
خيط |
الهوية
| اسم |
وصف |
قيمة |
| نوع |
نوع الهوية. |
"تم تعيين النظام" |
خطة
| اسم |
وصف |
قيمة |
| اسم |
اسم معرف من قبل المستخدم لأداة الطرف الثالث التي يتم شراؤها. |
سلسلة (مطلوب) |
| حاصل الضرب |
أداة الطرف الثالث التي يتم شراؤها. على سبيل المثال NewRelic. يتم تعيين المنتج إلى OfferID المحدد للبيانات الاصطناعية في وقت إلحاق سوق البيانات. |
سلسلة (مطلوب) |
| رمز الترقية |
قدم ناشر رمز الترويج كما هو متوفر في سوق البيانات للمنتج/البيانات الاصطناعية المذكورة. |
خيط |
| ناشر |
ناشر أداة الطرف الثالث التي يتم شراؤها. على سبيل المثال NewRelic |
سلسلة (مطلوب) |
| الإصدار |
إصدار المنتج/البيانات الاصطناعية المطلوبة. |
خيط |
نطاق
| اسم |
وصف |
قيمة |
| عنقود |
تحديد أن نطاق الملحق هو نظام المجموعة |
ScopeCluster |
| Namespace |
تحديد أن نطاق الملحق هو Namespace |
ScopeNamespace |
ScopeCluster
| اسم |
وصف |
قيمة |
| مساحة اسم الإصدار |
مساحة الاسم حيث يجب وضع إصدار الملحق، لملحق نطاق نظام المجموعة. إذا لم تكن مساحة الاسم هذه موجودة، إنشاؤها |
خيط |
مساحة اسم النطاق
| اسم |
وصف |
قيمة |
| targetNamespace |
مساحة الاسم حيث سيتم إنشاء الملحق لملحق نطاق مساحة الاسم. إذا لم تكن مساحة الاسم هذه موجودة، إنشاؤها |
خيط |
يمكن نشر نوع مورد الملحقات مع العمليات التي تستهدف:
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .
أمثلة الاستخدام
مثال أساسي على نشر ملحق نظام مجموعة Kubernetes.
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" "managedCluster" {
type = "Microsoft.ContainerService/managedClusters@2023-04-02-preview"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
identity {
type = "SystemAssigned"
identity_ids = []
}
body = {
properties = {
agentPoolProfiles = [
{
count = 1
mode = "System"
name = "default"
vmSize = "Standard_DS2_v2"
},
]
dnsPrefix = var.resource_name
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
resource "azapi_resource" "extension" {
type = "Microsoft.KubernetesConfiguration/extensions@2022-11-01"
parent_id = azapi_resource.managedCluster.id
name = var.resource_name
body = {
properties = {
autoUpgradeMinorVersion = true
extensionType = "microsoft.flux"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
لإنشاء مورد Microsoft.KubernetesConfiguration/extensions، أضف Terraform التالي إلى القالب الخاص بك.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.KubernetesConfiguration/extensions@2023-05-01"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
body = {
plan = {
name = "string"
product = "string"
promotionCode = "string"
publisher = "string"
version = "string"
}
properties = {
aksAssignedIdentity = {
type = "string"
}
autoUpgradeMinorVersion = bool
configurationProtectedSettings = {
{customized property} = "string"
}
configurationSettings = {
{customized property} = "string"
}
extensionType = "string"
releaseTrain = "string"
scope = {
cluster = {
releaseNamespace = "string"
}
namespace = {
targetNamespace = "string"
}
}
statuses = [
{
code = "string"
displayStatus = "string"
level = "string"
message = "string"
time = "string"
}
]
version = "string"
}
}
}
قيم الخصائص
Microsoft.KubernetesConfiguration/extensions
| اسم |
وصف |
قيمة |
| الهوية |
هوية مورد الملحق |
الهوية |
| اسم |
اسم المورد |
سلسلة (مطلوب) |
| parent_id |
معرف المورد لتطبيق مورد الملحق هذا عليه. |
سلسلة (مطلوب) |
| خطة |
معلومات الخطة. |
خطة |
| خصائص |
خصائص مورد ملحق |
ExtensionProperties |
| نوع |
نوع المورد |
"Microsoft.KubernetesConfiguration/extensions@2023-05-01" |
خصائص الملحقات
| اسم |
وصف |
قيمة |
| aksAssignedIdentity |
هوية مورد الملحق في نظام مجموعة AKS |
ExtensionPropertiesAksAssignedIdentity |
| AutoUpgradeMinorVersion |
ضع علامة لملاحظة ما إذا كان هذا الملحق يشارك في الترقية التلقائية للإصدار الثانوي، أم لا. |
قيمة منطقية |
| إعدادات التكوين المحمية |
إعدادات التكوين الحساسة، كأزواج قيمة الاسم لتكوين هذا الملحق. |
ExtensionPropertiesConfigurationProtectedSettings |
| إعدادات التكوين |
إعدادات التكوين، كأزواج اسم-قيمة لتكوين هذا الملحق. |
إعدادات تكوين خصائص الملحقات |
| نوع الملحق |
نوع الملحق، الذي يمثل هذا المورد مثيلا له. يجب أن يكون أحد أنواع الملحقات المسجلة مع Microsoft.KubernetesConfiguration بواسطة ناشر الملحق. |
خيط |
| إصدار التدريب |
ReleaseTrain يشارك هذا الملحق للترقية التلقائية (على سبيل المثال، ثابت، معاينة، وما إلى ذلك) - فقط إذا كان autoUpgradeMinorVersion هو "صحيح". |
خيط |
| نطاق |
النطاق الذي تم تثبيت الملحق فيه. |
نطاق |
| حالات |
الحالة من هذا الملحق. |
ExtensionStatus [] |
| الإصدار |
الإصدار المحدد من قبل المستخدم من الملحق لهذا الملحق إلى "pin". لاستخدام 'version'، يجب أن يكون autoUpgradeMinorVersion 'false'. |
خيط |
ExtensionPropertiesAksAssignedIdentity
| اسم |
وصف |
قيمة |
| نوع |
نوع الهوية. |
"تم تعيين النظام" "تعيين المستخدم" |
ExtensionPropertiesConfigurationProtectedSettings
إعدادات تكوين خصائص الملحقات
إحصائيات الملحقات
| اسم |
وصف |
قيمة |
| رمز |
رمز الحالة الذي يوفره الملحق |
خيط |
| displayStatus |
وصف مختصر لحالة الملحق. |
خيط |
| مستوى |
مستوى الحالة. |
"خطأ" "معلومات" "تحذير" |
| رسالة |
رسالة مفصلة للحالة من الملحق. |
خيط |
| الوقت |
DateLiteral (لكل ISO8601) يشير إلى وقت حالة التثبيت. |
خيط |
الهوية
| اسم |
وصف |
قيمة |
| نوع |
نوع الهوية. |
"تم تعيين النظام" |
خطة
| اسم |
وصف |
قيمة |
| اسم |
اسم معرف من قبل المستخدم لأداة الطرف الثالث التي يتم شراؤها. |
سلسلة (مطلوب) |
| حاصل الضرب |
أداة الطرف الثالث التي يتم شراؤها. على سبيل المثال NewRelic. يتم تعيين المنتج إلى OfferID المحدد للبيانات الاصطناعية في وقت إلحاق سوق البيانات. |
سلسلة (مطلوب) |
| رمز الترقية |
قدم ناشر رمز الترويج كما هو متوفر في سوق البيانات للمنتج/البيانات الاصطناعية المذكورة. |
خيط |
| ناشر |
ناشر أداة الطرف الثالث التي يتم شراؤها. على سبيل المثال NewRelic |
سلسلة (مطلوب) |
| الإصدار |
إصدار المنتج/البيانات الاصطناعية المطلوبة. |
خيط |
نطاق
| اسم |
وصف |
قيمة |
| عنقود |
تحديد أن نطاق الملحق هو نظام المجموعة |
ScopeCluster |
| Namespace |
تحديد أن نطاق الملحق هو Namespace |
ScopeNamespace |
ScopeCluster
| اسم |
وصف |
قيمة |
| مساحة اسم الإصدار |
مساحة الاسم حيث يجب وضع إصدار الملحق، لملحق نطاق نظام المجموعة. إذا لم تكن مساحة الاسم هذه موجودة، إنشاؤها |
خيط |
مساحة اسم النطاق
| اسم |
وصف |
قيمة |
| targetNamespace |
مساحة الاسم حيث سيتم إنشاء الملحق لملحق نطاق مساحة الاسم. إذا لم تكن مساحة الاسم هذه موجودة، إنشاؤها |
خيط |