Apps - Get

참조

서비스:: IoT Central

API 버전:: 2021-06-01

IoT Central 애플리케이션의 메타데이터를 가져옵니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string	IoT Central 애플리케이션을 포함하는 리소스 그룹의 이름입니다.
resourceName	path	True	string	IoT Central 애플리케이션의 ARM 리소스 이름입니다.
subscriptionId	path	True	string	구독 식별자입니다.
api-version	query	True	string	API 버전입니다.

응답

Name	형식	Description
200 OK	App	본문에는 IoT Central 애플리케이션의 모든 비보안 속성이 포함됩니다. 보안 관련 속성은 null로 설정됩니다.
Other Status Codes	CloudError	기본 오류 응답

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Apps_Get

샘플 요청

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

import com.azure.core.util.Context;

/** Samples for Apps GetByResourceGroup. */
public final class Main {
    /*
     * x-ms-original-file: specification/iotcentral/resource-manager/Microsoft.IoTCentral/stable/2021-06-01/examples/Apps_Get.json
     */
    /**
     * Sample code: Apps_Get.
     *
     * @param manager Entry point to IotCentralManager.
     */
    public static void appsGet(com.azure.resourcemanager.iotcentral.IotCentralManager manager) {
        manager.apps().getByResourceGroupWithResponse("resRg", "myIoTCentralApp", Context.NONE);
    }
}

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

from azure.identity import DefaultAzureCredential
from azure.mgmt.iotcentral import IotCentralClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-iotcentral
# USAGE
    python apps_get.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 = IotCentralClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.apps.get(
        resource_group_name="resRg",
        resource_name="myIoTCentralApp",
    )
    print(response)


# x-ms-original-file: specification/iotcentral/resource-manager/Microsoft.IoTCentral/stable/2021-06-01/examples/Apps_Get.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

package armiotcentral_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/iotcentral/armiotcentral"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/d55b8005f05b040b852c15e74a0f3e36494a15e1/specification/iotcentral/resource-manager/Microsoft.IoTCentral/stable/2021-06-01/examples/Apps_Get.json
func ExampleAppsClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armiotcentral.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewAppsClient().Get(ctx, "resRg", "myIoTCentralApp", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.App = armiotcentral.App{
	// 	Name: to.Ptr("myIoTCentralApp"),
	// 	Type: to.Ptr("Microsoft.IoTCentral/IoTApps"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.IoTCentral/iotApps/myIoTCentralApp"),
	// 	Location: to.Ptr("westus"),
	// 	Tags: map[string]*string{
	// 		"key": to.Ptr("value"),
	// 	},
	// 	Identity: &armiotcentral.SystemAssignedServiceIdentity{
	// 		Type: to.Ptr(armiotcentral.SystemAssignedServiceIdentityTypeSystemAssigned),
	// 		PrincipalID: to.Ptr("8988ab15-3e7a-4586-8a1c-ed07a73a53e9"),
	// 		TenantID: to.Ptr("f686d426-8d16-42db-81b7-ab578e110ccd"),
	// 	},
	// 	Properties: &armiotcentral.AppProperties{
	// 		ApplicationID: to.Ptr("6ebd8fd3-6e34-419e-908f-9be61ec6f6d6"),
	// 		DisplayName: to.Ptr("My IoT Central App"),
	// 		State: to.Ptr(armiotcentral.AppStateCreated),
	// 		Subdomain: to.Ptr("my-iot-central-app"),
	// 		Template: to.Ptr("iotc-pnp-preview@1.0.0"),
	// 	},
	// 	SKU: &armiotcentral.AppSKUInfo{
	// 		Name: to.Ptr(armiotcentral.AppSKU("F1")),
	// 	},
	// }
}

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

샘플 응답

상태 코드:: 200

code: 200

{
  "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"
  }
}

상태 코드:: default

{
  "error": {
    "code": "Error code",
    "message": "Error message",
    "target": "Error target"
  }
}

정의

Name	Description
App	IoT Central 애플리케이션.
AppSku	SKU의 이름입니다.
AppSkuInfo	IoT Central 애플리케이션의 SKU에 대한 정보입니다.
AppState	애플리케이션의 현재 상태입니다.
CloudError	오류 세부 정보입니다.
CloudErrorBody	오류 응답에 대한 세부 정보입니다.
SystemAssignedServiceIdentity	관리 서비스 ID(시스템이 할당되었거나 없음)
SystemAssignedServiceIdentityType	관리 서비스 ID 유형(시스템이 할당되었거나 없음)입니다.

App

IoT Central 애플리케이션.

Name	형식	Description
id	string	ARM 리소스 식별자입니다.
identity	SystemAssignedServiceIdentity	IoT Central 애플리케이션의 관리 ID입니다.
location	string	리소스 위치입니다.
name	string	ARM 리소스 이름입니다.
properties.applicationId	string	애플리케이션의 ID입니다.
properties.displayName	string	애플리케이션의 표시 이름입니다.
properties.state	AppState	애플리케이션의 현재 상태입니다.
properties.subdomain	string	애플리케이션의 하위 도메인입니다.
properties.template	string	애플리케이션의 특성과 동작을 정의하는 청사진인 애플리케이션 템플릿의 ID입니다. 선택적; 지정하지 않으면 기본값은 빈 청사진으로 설정되며 애플리케이션을 처음부터 정의할 수 있습니다.
sku	AppSkuInfo	유효한 instance SKU입니다.
tags	object	리소스 태그입니다.
type	string	리소스 종류입니다.

AppSku

SKU의 이름입니다.

Name	형식	Description
ST0	string
ST1	string
ST2	string

AppSkuInfo

IoT Central 애플리케이션의 SKU에 대한 정보입니다.

Name	형식	Description
name	AppSku	SKU의 이름입니다.

AppState

애플리케이션의 현재 상태입니다.

Name	형식	Description
created	string
suspended	string

CloudError

오류 세부 정보입니다.

Name	형식	Description
error.code	string	오류 코드입니다.
error.details	CloudErrorBody[]	오류에 대한 추가 세부 정보 목록입니다.
error.message	string	오류 메시지입니다.
error.target	string	특정 오류의 대상입니다.

CloudErrorBody

오류 응답에 대한 세부 정보입니다.

Name	형식	Description
code	string	오류 코드입니다.
details	CloudErrorBody[]	오류에 대한 추가 세부 정보 목록입니다.
message	string	오류 메시지입니다.
target	string	특정 오류의 대상입니다.

SystemAssignedServiceIdentity

관리 서비스 ID(시스템이 할당되었거나 없음)

Name	형식	Description
principalId	string	시스템 할당 ID의 서비스 주체 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.
tenantId	string	시스템 할당 ID의 테넌트 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.
type	SystemAssignedServiceIdentityType	관리 서비스 ID 유형(시스템이 할당되었거나 없음)입니다.

SystemAssignedServiceIdentityType

관리 서비스 ID 유형(시스템이 할당되었거나 없음)입니다.

Name	형식	Description
None	string
SystemAssigned	string

다음을 통해 공유

Apps - Get

URI 매개 변수

응답

보안

azure_auth

범위

예제

Apps_Get

샘플 요청

샘플 응답

정의

App

AppSku

AppSkuInfo

AppState

CloudError

CloudErrorBody

SystemAssignedServiceIdentity

SystemAssignedServiceIdentityType

추가 리소스