你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
使用自定义资源提供程序扩展资源
在本教程中，将自定义资源提供程序部署到 Azure，该提供程序使用 Microsoft.CustomProviders/associations 资源类型扩展 Azure 资源管理器 API。 本教程介绍如何扩展自定义提供程序实例所在的资源组之外的现有资源。 在本教程中，自定义资源提供程序由 Azure 逻辑应用提供支持，但你可以使用任何公共 API 终结点。
先决条件
若要完成本教程，请确保符合以下条件：
- Azure 自定义资源提供程序的功能。
- 有关使用自定义资源提供程序进行资源加入的基本信息。
资源载入入门
在本教程中，需要部署两个部分：“自定义资源提供程序”和“关联”。 若要使此过程更加轻松，可以选择使用单一模板来部署这两种方法。
该模板将使用以下资源：
- Microsoft.CustomProviders/resourceProviders
- Microsoft.Logic/workflows
- Microsoft.CustomProviders/associations
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"location": {
"type": "string",
"allowedValues": [
"australiaeast",
"eastus",
"westeurope"
],
"metadata": {
"description": "Location for the resources."
}
},
"logicAppName": {
"type": "string",
"defaultValue": "[uniqueString(resourceGroup().id)]",
"metadata": {
"description": "Name of the logic app to be created."
}
},
"customResourceProviderName": {
"type": "string",
"defaultValue": "[uniqueString(resourceGroup().id)]",
"metadata": {
"description": "Name of the custom resource provider to be created."
}
},
"customResourceProviderId": {
"type": "string",
"defaultValue": "",
"metadata": {
"description": "The resource ID of an existing custom resource provider. Provide this to skip deployment of new logic app and custom resource provider."
}
},
"associationName": {
"type": "string",
"defaultValue": "myAssociationResource",
"metadata": {
"description": "Name of the custom resource that is being created."
}
}
},
"resources": [
{
"type": "Microsoft.Resources/deployments",
"apiVersion": "2021-04-01",
"condition": "[empty(parameters('customResourceProviderId'))]",
"name": "customProviderInfrastructureTemplate",
"properties": {
"mode": "Incremental",
"template": {
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"logicAppName": {
"type": "string",
"defaultValue": "[parameters('logicAppName')]"
}
},
"resources": [
{
"type": "Microsoft.Logic/workflows",
"apiVersion": "2019-05-01",
"name": "[parameters('logicAppName')]",
"location": "[parameters('location')]",
"properties": {
"state": "Enabled",
"definition": {
"$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
"actions": {
"Switch": {
"cases": {
"Case": {
"actions": {
"CreateCustomResource": {
"inputs": {
"body": {
"properties": "@addProperty(triggerBody().Body['properties'], 'myDynamicProperty', 'myDynamicValue')"
},
"statusCode": 200
},
"kind": "Http",
"type": "Response"
}
},
"case": "CREATE"
}
},
"default": {
"actions": {
"DefaultHttpResponse": {
"inputs": {
"statusCode": 200
},
"kind": "Http",
"type": "Response"
}
}
},
"expression": "@triggerBody().operationType",
"type": "Switch"
}
},
"contentVersion": "1.0.0.0",
"outputs": {},
"parameters": {},
"triggers": {
"CustomProviderWebhook": {
"inputs": {
"schema": {}
},
"kind": "Http",
"type": "Request"
}
}
}
}
},
{
"type": "Microsoft.CustomProviders/resourceProviders",
"apiVersion": "2018-09-01-preview",
"name": "[parameters('customResourceProviderName')]",
"location": "[parameters('location')]",
"properties": {
"resourceTypes": [
{
"name": "associations",
"mode": "Secure",
"routingType": "Webhook,Cache,Extension",
"endpoint": "[[listCallbackURL(concat(resourceId('Microsoft.Logic/workflows', parameters('logicAppName')), '/triggers/CustomProviderWebhook'), '2019-05-01').value]"
}
]
}
}
],
"outputs": {
"customProviderResourceId": {
"type": "string",
"value": "[resourceId('Microsoft.CustomProviders/resourceProviders', parameters('customResourceProviderName'))]"
}
}
}
}
},
{
"type": "Microsoft.CustomProviders/associations",
"apiVersion": "2018-09-01-preview",
"name": "[parameters('associationName')]",
"location": "global",
"properties": {
"targetResourceId": "[if(empty(parameters('customResourceProviderId')), reference('customProviderInfrastructureTemplate').outputs.customProviderResourceId.value, parameters('customResourceProviderId'))]",
"myCustomInputProperty": "myCustomInputValue",
"myCustomInputObject": {
"Property1": "Value1"
}
}
}
],
"outputs": {
"associationResource": {
"type": "object",
"value": "[reference(parameters('associationName'), '2018-09-01-preview', 'Full')]"
}
}
}
部署自定义资源提供程序基础结构
模板的第一部分部署自定义资源提供程序基础结构。 此基础结构定义关联资源的影响。 如果不熟悉自定义资源提供程序，请参阅 Azure 自定义资源提供程序概述。
让我们来部署自定义资源提供程序基础结构。 复制、保存并部署上述模板，或使用 Microsoft Azure 门户然后按照说明操作并部署基础结构。
转到 Azure 门户。
在“所有服务”中或使用主搜索框搜索“模板”：
在“模板”窗格中，选择“添加”：
在“常规”下，输入新模板的“名称”和“说明”：
通过在本文的“资源载入入门”部分中复制 JSON 模板来创建资源管理器模板：
选择“添加”以创建模板。 如果未显示新模板，请选择“刷新”。
选择新创建的模板，然后选择“部署”：
输入必填字段的设置，然后选择订阅和资源组。 可以将“自定义资源提供程序 ID”框留空。
设置名 必需？ 说明 位置 是 模板中资源的位置。 逻辑应用名称 否 逻辑应用的名称。 自定义资源提供程序名称 否 自定义资源提供程序的名称。 自定义资源提供程序 ID 否 支持关联资源的现有自定义资源提供程序。 如果在此处指定一个值，将跳过逻辑应用和自定义资源提供程序部署。 关联名称 否 关联资源的名称。 示例参数：
转到部署，等待部署完成。 应当会看到类似以下屏幕截图的内容。 应当会看到新的关联资源作为输出：
下面是资源组，其中选择了“显示隐藏的类型”：
浏览逻辑应用的“运行历史记录”选项卡，查看对关联创建的调用：
部署其他关联
设置自定义资源提供程序基础结构后，可以轻松地部署更多关联。 其他关联的资源组不必与部署自定义资源提供程序基础结构的资源组相同。 若要创建关联，需要对指定的自定义资源提供程序 ID 具有 Microsoft.CustomProviders/resourceproviders/write 权限。
转到上一个部署的资源组中的自定义资源提供程序 Microsoft.CustomProviders/resourceProviders 资源。 需要选中“显示隐藏的类型”复选框：
复制自定义资源提供程序的资源 ID 属性。
在“所有服务”中或使用主搜索框搜索“模板”：
选择以前创建的模板，然后选择“部署”：
输入必填字段的设置，然后选择订阅和其他资源组。 对于“自定义资源提供程序 ID”设置，输入从之前部署的自定义资源提供程序中复制的资源 ID。
转到部署，等待部署完成。 它现在应仅部署新的关联资源：
可以返回到逻辑应用的“运行历史记录”，查看是否对逻辑应用进行了另一次调用。 可以更新逻辑应用，为每个已创建的关联增加额外的功能。
后续步骤
在本文中，将自定义资源提供程序部署到 Azure，该提供程序使用 Microsoft.CustomProviders/associations 资源类型扩展 Azure 资源管理器 API。 若要继续了解自定义资源提供程序，请参阅：
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈