Devices - Create Or Update Group

Bir cihaz grubu oluşturun veya güncelleştirin.

PUT https://{accountEndpoint}/deviceupdate/{instanceId}/v2/management/groups/{groupId}

URI Parametreleri

Name In Required Type Description
accountEndpoint
path True
  • string

Hesap uç noktası.

groupId
path True
  • string

Grup tanımlayıcısı.

instanceId
path True
  • string

Hesap örneği tanımlayıcısı.

İstek Gövdesi

Name Required Type Description
createdDateTime True
  • string

Güncelleştirmenin oluşturulduğu tarih ve saat.

groupId True
  • string

Grup kimliği.

groupType True

Grup türü.

tags True
  • string[]

IoT Hub etiketleri.

deviceCount
  • integer

Gruptaki cihazların sayısı.

Yanıtlar

Name Type Description
200 OK

Grup Özellikleri.

400 Bad Request

Sorgu parametresindeki GroupID ve istek gövdesi eşleşmiyor.

404 Not Found

Bulunamadı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 akışı

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

Scopes

Name Description
user_impersonation Kullanıcı hesabınızın kimliğine bürün

Örnekler

Devices_CreateOrUpdateGroup

Sample Request

PUT https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/management/groups/MyGroup
{
  "groupId": "MyGroup",
  "groupType": "IoTHubTag",
  "tags": [
    "MyGroup"
  ],
  "createdDateTime": "2020-07-01T12:13:14.0000000Z"
}

Sample Response

{
  "groupId": "MyGroup",
  "groupType": "IoTHubTag",
  "tags": [
    "MyGroup"
  ],
  "createdDateTime": "2020-07-01T12:13:14.0000000Z"
}

Tanımlar

Group

Grup ayrıntıları.

GroupType

Desteklenen Grup türleri.

Group

Grup ayrıntıları.

Name Type Description
createdDateTime
  • string

Güncelleştirmenin oluşturulduğu tarih ve saat.

deviceCount
  • integer

Gruptaki cihazların sayısı.

groupId
  • string

Grup kimliği.

groupType

Grup türü.

tags
  • string[]

IoT Hub etiketleri.

GroupType

Desteklenen Grup türleri.

Name Type Description
IoTHubTag
  • string

Etiket tabanlı grubu IoT Hub.