Apps - Get

Référence

Service:: IoT Central

Version d'API:: 2021-06-01

Obtenir les métadonnées d’une application IoT Central.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient l’application IoT Central.
resourceName	path	True	string	Nom de la ressource ARM de l’application IoT Central.
subscriptionId	path	True	string	Identificateur de l’abonnement.
api-version	query	True	string	Version de l’API.

Réponses

Nom	Type	Description
200 OK	App	Le corps contient toutes les propriétés non liées à la sécurité de l’application IoT Central. Les propriétés liées à la sécurité ont la valeur Null.
Other Status Codes	CloudError	Réponse d’erreur par défaut

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

Apps_Get

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
  }
}

Code d’état:: default

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

Définitions

Nom	Description
App	Application IoT Central.
AppSku	Nom de la référence SKU.
AppSkuInfo	Informations sur la référence SKU de l’application IoT Central.
AppState	État actuel de l’application.
CloudError	Détails de l’erreur.
CloudErrorBody	Détails de la réponse d’erreur.
SystemAssignedServiceIdentity	Identité de service managée (affectée par le système ou aucune)
SystemAssignedServiceIdentityType	Type d’identité de service managé (affecté par le système ou aucun).

App

Application IoT Central.

Nom	Type	Description
id	string	Identificateur de ressource ARM.
identity	SystemAssignedServiceIdentity	Identités managées pour l’application IoT Central.
location	string	Emplacement de la ressource.
name	string	Nom de la ressource ARM.
properties.applicationId	string	ID de l’application.
properties.displayName	string	Nom d’affichage de l’application.
properties.state	AppState	État actuel de l’application.
properties.subdomain	string	Sous-domaine de l’application.
properties.template	string	ID du modèle d’application, qui est un blueprint qui définit les caractéristiques et les comportements d’une application. Optionnel; si elle n’est pas spécifiée, utilise par défaut un blueprint vide et permet de définir l’application à partir de zéro.
sku	AppSkuInfo	Référence SKU instance valide.
tags	object	Étiquettes de la ressource.
type	string	Type de ressource.

AppSku

Nom de la référence SKU.

Nom	Type	Description
ST0	string
ST1	string
ST2	string

AppSkuInfo

Informations sur la référence SKU de l’application IoT Central.

Nom	Type	Description
name	AppSku	Nom de la référence SKU.

AppState

État actuel de l’application.

Nom	Type	Description
created	string
suspended	string

CloudError

Détails de l’erreur.

Nom	Type	Description
error.code	string	Code d'erreur.
error.details	CloudErrorBody[]	Liste de détails supplémentaires sur l’erreur.
error.message	string	Message d’erreur.
error.target	string	Cible de l’erreur particulière.

CloudErrorBody

Détails de la réponse d’erreur.

Nom	Type	Description
code	string	Code d'erreur.
details	CloudErrorBody[]	Liste de détails supplémentaires sur l’erreur.
message	string	Message d’erreur.
target	string	Cible de l’erreur particulière.

SystemAssignedServiceIdentity

Identité de service managée (affectée par le système ou aucune)

Nom	Type	Description
principalId	string	ID de principal de service de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.
tenantId	string	ID de locataire de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.
type	SystemAssignedServiceIdentityType	Type d’identité de service managé (affecté par le système ou aucun).

SystemAssignedServiceIdentityType

Type d’identité de service managé (affecté par le système ou aucun).

Nom	Type	Description
None	string
SystemAssigned	string

Partager via

Apps - Get

Paramètres URI

Réponses

Sécurité

azure_auth

Étendues

Exemples

Apps_Get

Exemple de requête

Exemple de réponse

Définitions

App

AppSku

AppSkuInfo

AppState

CloudError

CloudErrorBody

SystemAssignedServiceIdentity

SystemAssignedServiceIdentityType

Ressources supplémentaires