Apps - Create Or Update
IoT Central uygulamasının meta verilerini oluşturun veya güncelleştirin. Bir özelliği değiştirmek için her zamanki düzen, IoT Central uygulama meta verilerini ve güvenlik meta verilerini almak ve bunları yeni bir gövdedeki değiştirilmiş değerlerle birleştirerek IoT Central uygulamasını güncelleştirmektir.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}?api-version=2021-06-01
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
resource
|
path | True |
string |
IoT Central uygulamasını içeren kaynak grubunun adı. |
resource
|
path | True |
string |
IoT Central uygulamasının ARM kaynak adı. |
subscription
|
path | True |
string |
Abonelik tanımlayıcısı. |
api-version
|
query | True |
string |
API'nin sürümü. |
İstek Gövdesi
Name | Gerekli | Tür | Description |
---|---|---|---|
location | True |
string |
Kaynak konumu. |
sku | True |
Geçerli bir örnek SKU'su. |
|
identity |
IoT Central uygulaması için yönetilen kimlikler. |
||
properties.displayName |
string |
Uygulamanın görünen adı. |
|
properties.subdomain |
string |
Uygulamanın alt etki alanı. |
|
properties.template |
string |
Bir uygulamanın özelliklerini ve davranışlarını tanımlayan bir şema olan uygulama şablonunun kimliği. Isteğe bağlı; belirtilmezse, varsayılan olarak boş bir şemaya ayarlanır ve uygulamanın sıfırdan tanımlanmasına izin verir. |
|
tags |
object |
Kaynak etiketleri. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Bu, oluşturma veya güncelleştirme işlemi için durum yoklama isteğine yanıt olarak döndürülür. Gövde, geçişli sağlama durumunu gösteren kaynak gösterimini içerir. |
|
201 Created |
Bu, oluşturma veya güncelleştirme işlemi için durum yoklama isteğine yanıt olarak döndürülür. Gövde, geçişli sağlama durumunu gösteren kaynak gösterimini içerir. |
|
202 Accepted |
Kabul Edildi - İstek kabul edildi; işlemi zaman uyumsuz olarak tamamlanır. |
|
Other Status Codes |
DefaultErrorResponse |
Güvenlik
azure_auth
Azure Active Directory OAuth2 Flow
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
Name | Description |
---|---|
user_impersonation | kullanıcı hesabınızın kimliğine bürünme |
Örnekler
Apps_CreateOrUpdate
Örnek isteği
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.IoTCentral/iotApps/myIoTCentralApp?api-version=2021-06-01
{
"location": "westus",
"sku": {
"name": "ST2"
},
"properties": {
"displayName": "My IoT Central App",
"subdomain": "my-iot-central-app",
"template": "iotc-pnp-preview@1.0.0"
},
"identity": {
"type": "SystemAssigned"
}
}
Örnek yanıt
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.IoTCentral/IoTApps/myIoTCentralApp",
"name": "myIoTCentralApp",
"type": "Microsoft.IoTCentral/IoTApps",
"location": "westus",
"tags": {
"key": "value"
},
"properties": {
"applicationId": "6ebd8fd3-6e34-419e-908f-9be61ec6f6d6",
"displayName": "My IoT Central App 2",
"subdomain": "my-iot-central-app-2",
"template": "iotc-pnp-preview@1.0.0",
"state": "created"
},
"sku": {
"name": "ST2"
},
"identity": {
"type": "SystemAssigned",
"tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd",
"principalId": "8988ab15-3e7a-4586-8a1c-ed07a73a53e9"
}
}
code: 201
message: Created
target: ResourceHandler.ExecutePutRequest
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.IoTCentral/IoTApps/myIoTCentralApp",
"name": "myIoTCentralApp",
"type": "Microsoft.IoTCentral/IoTApps",
"location": "westus",
"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": "ST2"
},
"identity": {
"type": "SystemAssigned",
"tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd",
"principalId": "8988ab15-3e7a-4586-8a1c-ed07a73a53e9"
}
}
{
"error": {
"code": "Error code",
"message": "Error message",
"target": "Error target"
}
}
Tanımlar
Name | Description |
---|---|
App |
IoT Central uygulaması. |
App |
SKU'nun adı. |
App |
IoT Central uygulamasının SKU'su hakkında bilgi. |
App |
Uygulamanın geçerli durumu. |
Cloud |
Hata ayrıntıları. |
Cloud |
Hata yanıtının ayrıntıları. |
System |
Yönetilen hizmet kimliği (sistem tarafından atanmış veya yok) |
System |
Yönetilen hizmet kimliğinin türü (sistem tarafından atanmış veya yok). |
App
IoT Central uygulaması.
Name | Tür | Description |
---|---|---|
id |
string |
ARM kaynak tanımlayıcısı. |
identity |
IoT Central uygulaması için yönetilen kimlikler. |
|
location |
string |
Kaynak konumu. |
name |
string |
ARM kaynak adı. |
properties.applicationId |
string |
Uygulamanın kimliği. |
properties.displayName |
string |
Uygulamanın görünen adı. |
properties.state |
Uygulamanın geçerli durumu. |
|
properties.subdomain |
string |
Uygulamanın alt etki alanı. |
properties.template |
string |
Bir uygulamanın özelliklerini ve davranışlarını tanımlayan bir şema olan uygulama şablonunun kimliği. Isteğe bağlı; belirtilmezse, varsayılan olarak boş bir şemaya ayarlanır ve uygulamanın sıfırdan tanımlanmasına izin verir. |
sku |
Geçerli bir örnek SKU'su. |
|
tags |
object |
Kaynak etiketleri. |
type |
string |
Kaynak türü. |
AppSku
SKU'nun adı.
Name | Tür | Description |
---|---|---|
ST0 |
string |
|
ST1 |
string |
|
ST2 |
string |
AppSkuInfo
IoT Central uygulamasının SKU'su hakkında bilgi.
Name | Tür | Description |
---|---|---|
name |
SKU'nun adı. |
AppState
Uygulamanın geçerli durumu.
Name | Tür | Description |
---|---|---|
created |
string |
|
suspended |
string |
CloudError
Hata ayrıntıları.
Name | Tür | Description |
---|---|---|
error.code |
string |
Hata kodu. |
error.details |
Hatayla ilgili ek ayrıntıların listesi. |
|
error.message |
string |
Hata iletisi. |
error.target |
string |
Belirli bir hatanın hedefi. |
CloudErrorBody
Hata yanıtının ayrıntıları.
Name | Tür | Description |
---|---|---|
code |
string |
Hata kodu. |
details |
Hatayla ilgili ek ayrıntıların listesi. |
|
message |
string |
Hata iletisi. |
target |
string |
Belirli bir hatanın hedefi. |
SystemAssignedServiceIdentity
Yönetilen hizmet kimliği (sistem tarafından atanmış veya yok)
Name | Tür | Description |
---|---|---|
principalId |
string |
Sistem tarafından atanan kimliğin hizmet sorumlusu kimliği. Bu özellik yalnızca sistem tarafından atanan kimlik için sağlanacaktır. |
tenantId |
string |
Sistem tarafından atanan kimliğin kiracı kimliği. Bu özellik yalnızca sistem tarafından atanan kimlik için sağlanacaktır. |
type |
Yönetilen hizmet kimliğinin türü (sistem tarafından atanmış veya yok). |
SystemAssignedServiceIdentityType
Yönetilen hizmet kimliğinin türü (sistem tarafından atanmış veya yok).
Name | Tür | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |