你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Application Definitions - List By Resource Group

Service:

Managed Applications

API Version:

2019-07-01

Lists资源组中的托管应用程序定义。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/applicationDefinitions?api-version=2019-07-01

URI 参数

名称	在	必需	类型	说明
resourceGroupName	path	True	string	资源组的名称。 此名称不区分大小写。 Regex pattern: ^[-\w\._\(\)]+$
subscriptionId	path	True	string	目标订阅的 ID。
api-version	query	True	string	要用于此操作的 API 版本。

响应

名称	类型	说明
200 OK	ApplicationDefinitionListResult	正常 - 返回托管应用程序定义的数组。
Other Status Codes	ErrorResponse	描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名称	说明
user_impersonation	模拟用户帐户

示例

List managed application definitions

Sample Request

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Solutions/applicationDefinitions?api-version=2019-07-01

Python

from azure.identity import DefaultAzureCredential
from azure.mgmt.resource import ApplicationClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-resource
# USAGE
    python list_application_definitions_by_resource_group.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ApplicationClient(
        credential=DefaultAzureCredential(),
        subscription_id="subid",
    )

    response = client.application_definitions.list_by_resource_group(
        resource_group_name="rg",
    )
    for item in response:
        print(item)


# x-ms-original-file: specification/resources/resource-manager/Microsoft.Solutions/stable/2019-07-01/examples/listApplicationDefinitionsByResourceGroup.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Resources.Models;

// Generated from example definition: specification/resources/resource-manager/Microsoft.Solutions/stable/2019-07-01/examples/listApplicationDefinitionsByResourceGroup.json
// this example is just showing the usage of "ApplicationDefinitions_ListByResourceGroup" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "subid";
string resourceGroupName = "rg";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this ArmApplicationDefinitionResource
ArmApplicationDefinitionCollection collection = resourceGroupResource.GetArmApplicationDefinitions();

// invoke the operation and iterate over the result
await foreach (ArmApplicationDefinitionResource item in collection.GetAllAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    ArmApplicationDefinitionData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine($"Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "value": [
    {
      "name": "myManagedApplicationDef",
      "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Solutions/applicationDefinitions/myManagedApplicationDef",
      "type": "Microsoft.Solutions/applicationDefinitions",
      "location": "East US 2",
      "managedBy": null,
      "tags": null,
      "sku": null,
      "properties": {
        "artifacts": [
          {
            "name": "CreateUiDefinition",
            "type": "Custom",
            "uri": "https://path/to/managedApplicationCreateUiDefinition.json"
          },
          {
            "name": "ApplicationResourceTemplate",
            "type": "Template",
            "uri": "https://path/to/mainTemplate.json"
          }
        ],
        "authorizations": [
          {
            "principalId": "validprincipalguid",
            "roleDefinitionId": "validroleguid"
          }
        ],
        "description": "myManagedApplicationDef description",
        "displayName": "myManagedApplicationDef",
        "lockLevel": "None",
        "packageFileUri": "https://path/to/packagezipfile"
      }
    },
    {
      "name": "myManagedApplicationDef2",
      "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Solutions/applicationDefinitions/myManagedApplicationDef2",
      "type": "Microsoft.Solutions/applicationDefinitions",
      "location": "West US",
      "managedBy": null,
      "tags": null,
      "sku": null,
      "properties": {
        "artifacts": [
          {
            "name": "CreateUiDefinition",
            "type": "Custom",
            "uri": "https://path/to/managedApplicationCreateUiDefinition.json"
          },
          {
            "name": "ApplicationResourceTemplate",
            "type": "Template",
            "uri": "https://path/to/mainTemplate.json"
          }
        ],
        "authorizations": [
          {
            "principalId": "validprincipalguid",
            "roleDefinitionId": "validroleguid"
          }
        ],
        "description": "myManagedApplicationDef2 description",
        "displayName": "myManagedApplicationDef2",
        "lockLevel": "None",
        "packageFileUri": "https://path/to/packagezipfile"
      }
    }
  ]
}

定义

名称	说明
ApplicationArtifactType	托管应用程序项目类型。
ApplicationAuthorization	托管应用程序提供程序授权。
ApplicationDefinition	有关托管应用程序定义的信息。
ApplicationDefinitionArtifact	应用程序定义项目。
ApplicationDefinitionArtifactName	托管应用程序项目名称。
ApplicationDefinitionListResult	托管应用程序定义列表。
ApplicationDeploymentPolicy	托管应用程序部署策略。
ApplicationLockLevel	托管应用程序锁定级别。
ApplicationManagementMode	管理模式。
ApplicationManagementPolicy	托管应用程序管理策略。
ApplicationNotificationEndpoint	托管应用程序通知终结点。
ApplicationNotificationPolicy	托管应用程序通知策略。
ApplicationPackageLockingPolicyDefinition	托管应用程序锁定策略。
ApplicationPolicy	托管应用程序策略。
DeploymentMode	部署模式。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
Sku	资源的 SKU。

ApplicationArtifactType

托管应用程序项目类型。

名称	类型	说明
Custom	string
NotSpecified	string
Template	string

ApplicationAuthorization

托管应用程序提供程序授权。

名称	类型	说明
principalId	string	提供程序的主体标识符。 这是提供程序将用来调用 ARM 来管理托管应用程序资源的标识。
roleDefinitionId	string	提供程序的角色定义标识符。 此角色将定义提供程序必须对托管应用程序的容器资源组拥有的所有权限。 此角色定义不能具有删除资源组的权限。

ApplicationDefinition

有关托管应用程序定义的信息。

名称	类型	说明
id	string	资源 ID
location	string	资源位置
managedBy	string	管理此资源的资源的 ID。
name	string	资源名称
properties.artifacts	ApplicationDefinitionArtifact[]	托管应用程序项目的集合。 门户将使用指定为项目的文件来构造从托管应用程序定义创建托管应用程序的用户体验。
properties.authorizations	ApplicationAuthorization[]	托管应用程序提供程序授权。
properties.createUiDefinition	object	包含 Microsoft.Solutions/applications 资源的后备模板的 createUiDefinition json。 它可以是 JObject 或格式正确的 JSON 字符串。
properties.deploymentPolicy	ApplicationDeploymentPolicy	托管应用程序部署策略。
properties.description	string	托管应用程序定义说明。
properties.displayName	string	托管应用程序定义显示名称。
properties.isEnabled	boolean	一个值，该值指示是否启用包。
properties.lockLevel	ApplicationLockLevel	托管应用程序锁定级别。
properties.lockingPolicy	ApplicationPackageLockingPolicyDefinition	托管应用程序锁定策略。
properties.mainTemplate	object	内联main模板 json，其中包含要预配的资源。 它可以是 JObject 或格式正确的 JSON 字符串。
properties.managementPolicy	ApplicationManagementPolicy	确定发布者对托管资源组的访问权限的托管应用程序管理策略。
properties.notificationPolicy	ApplicationNotificationPolicy	托管应用程序通知策略。
properties.packageFileUri	string	托管应用程序定义包文件 URI。 使用此元素
properties.policies	ApplicationPolicy[]	托管应用程序提供程序策略。
sku	Sku	资源的 SKU。
tags	object	资源标记
type	string	资源类型

ApplicationDefinitionArtifact

应用程序定义项目。

名称	类型	说明
name	ApplicationDefinitionArtifactName	托管应用程序定义项目名称。
type	ApplicationArtifactType	托管应用程序定义项目类型。
uri	string	托管应用程序定义项目 blob URI。

ApplicationDefinitionArtifactName

托管应用程序项目名称。

名称	类型	说明
ApplicationResourceTemplate	string
CreateUiDefinition	string
MainTemplateParameters	string
NotSpecified	string

ApplicationDefinitionListResult

托管应用程序定义列表。

名称	类型	说明
nextLink	string	用于获取下一组结果的 URL。
value	ApplicationDefinition[]	托管应用程序定义的数组。

ApplicationDeploymentPolicy

托管应用程序部署策略。

名称	类型	说明
deploymentMode	DeploymentMode	托管应用程序部署模式。

ApplicationLockLevel

托管应用程序锁定级别。

名称	类型	说明
CanNotDelete	string
None	string
ReadOnly	string

ApplicationManagementMode

管理模式。

名称	类型	说明
Managed	string
NotSpecified	string
Unmanaged	string

ApplicationManagementPolicy

托管应用程序管理策略。

名称	类型	说明
mode	ApplicationManagementMode	托管应用程序管理模式。

ApplicationNotificationEndpoint

托管应用程序通知终结点。

名称	类型	说明
uri	string	托管应用程序通知终结点 URI。

ApplicationNotificationPolicy

托管应用程序通知策略。

名称	类型	说明
notificationEndpoints	ApplicationNotificationEndpoint[]	托管应用程序通知终结点。

ApplicationPackageLockingPolicyDefinition

托管应用程序锁定策略。

名称	类型	说明
allowedActions	string[]	拒绝分配排除的操作。
allowedDataActions	string[]	拒绝分配排除的数据操作。

ApplicationPolicy

托管应用程序策略。

名称	类型	说明
name	string	策略名称
parameters	string	策略参数。
policyDefinitionId	string	策略定义 ID。

DeploymentMode

部署模式。

名称	类型	说明
Complete	string
Incremental	string
NotSpecified	string

ErrorAdditionalInfo

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

Sku

资源的 SKU。

名称	类型	说明
capacity	integer	SKU 容量。
family	string	SKU 系列。
model	string	SKU 模型。
name	string	SKU 名称。
size	string	SKU 大小。
tier	string	SKU 层。