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

Apps - List By Resource Group

获取资源组中的所有 IoT Central 应用程序。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps?api-version=2021-06-01

URI 参数

名称 必需 类型 说明
resourceGroupName
path True

string

包含 IoT Central 应用程序的资源组的名称。

subscriptionId
path True

string

订阅标识符。

api-version
query True

string

API 的版本。

响应

名称 类型 说明
200 OK

AppListResult

这是一个同步操作。 正文包含资源组中所有 IoT Central 应用程序的元数据的 JSON 序列化数组。

Other Status Codes

CloudError

DefaultErrorResponse

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

Apps_ListByResourceGroup

示例请求

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.IoTCentral/iotApps?api-version=2021-06-01

示例响应

code: 200
{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.IoTCentral/iotApps/myIoTCentralApp",
      "location": "westus",
      "type": "Microsoft.IoTCentral/IoTApps",
      "name": "myIoTCentralApp",
      "tags": {
        "key": "value"
      },
      "properties": {
        "applicationId": "6ebd8fd3-6e34-419e-908f-9be61ec6f6d6",
        "displayName": "My IoT Central App",
        "subdomain": "my-iot-central-app",
        "template": "iotc-pnp-preview@1.0.0",
        "state": "created"
      },
      "sku": {
        "name": "F1"
      },
      "identity": {
        "type": "SystemAssigned",
        "tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd",
        "principalId": "8988ab15-3e7a-4586-8a1c-ed07a73a53e9"
      }
    }
  ],
  "nextLink": null
}
{
  "error": {
    "code": "Error code",
    "message": "Error message",
    "target": "Error target"
  }
}

定义

名称 说明
App

IoT Central 应用程序。

AppListResult

包含下一个链接的 IoT Central 应用程序列表。

AppSku

SKU 的名称。

AppSkuInfo

有关 IoT Central 应用程序的 SKU 的信息。

AppState

应用程序的当前状态。

CloudError

错误详细信息。

CloudErrorBody

错误响应的详细信息。

SystemAssignedServiceIdentity

托管服务标识 (系统分配或无)

SystemAssignedServiceIdentityType

托管服务标识的类型 (系统分配或无) 。

App

IoT Central 应用程序。

名称 类型 说明
id

string

ARM 资源标识符。

identity

SystemAssignedServiceIdentity

IoT Central 应用程序的托管标识。

location

string

资源位置。

name

string

ARM 资源名称。

properties.applicationId

string

应用程序的 ID。

properties.displayName

string

应用程序的显示名称。

properties.state

AppState

应用程序的当前状态。

properties.subdomain

string

应用程序的子域。

properties.template

string

应用程序模板的 ID,它是定义应用程序的特征和行为的蓝图。 选;如果未指定,则默认为空白蓝图,并允许从头开始定义应用程序。

sku

AppSkuInfo

有效的实例 SKU。

tags

object

资源标记。

type

string

资源类型。

AppListResult

包含下一个链接的 IoT Central 应用程序列表。

名称 类型 说明
nextLink

string

用于获取 IoT Central 应用程序的下一页的链接。

value

App[]

IoT Central 应用程序的列表。

AppSku

SKU 的名称。

名称 类型 说明
ST0

string

ST1

string

ST2

string

AppSkuInfo

有关 IoT Central 应用程序的 SKU 的信息。

名称 类型 说明
name

AppSku

SKU 的名称。

AppState

应用程序的当前状态。

名称 类型 说明
created

string

suspended

string

CloudError

错误详细信息。

名称 类型 说明
error.code

string

错误代码。

error.details

CloudErrorBody[]

有关错误的其他详细信息的列表。

error.message

string

错误消息。

error.target

string

特定错误的目标。

CloudErrorBody

错误响应的详细信息。

名称 类型 说明
code

string

错误代码。

details

CloudErrorBody[]

有关错误的其他详细信息的列表。

message

string

错误消息。

target

string

特定错误的目标。

SystemAssignedServiceIdentity

托管服务标识 (系统分配或无)

名称 类型 说明
principalId

string

系统分配的标识的服务主体 ID。 此属性仅针对系统分配的标识提供。

tenantId

string

系统分配的标识的租户 ID。 此属性仅针对系统分配的标识提供。

type

SystemAssignedServiceIdentityType

托管服务标识的类型 (系统分配或无) 。

SystemAssignedServiceIdentityType

托管服务标识的类型 (系统分配或无) 。

名称 类型 说明
None

string

SystemAssigned

string