Devices - Create Or Update Group

デバイスグループを作成または更新します。

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

URI パラメーター

Name In Required Type Description
accountEndpoint
path True
  • string

アカウントエンドポイント。

groupId
path True
  • string

グループ識別子。

instanceId
path True
  • string

アカウントインスタンス識別子。

要求本文

Name Required Type Description
createdDateTime True
  • string

更新プログラムが作成された日付と時刻。

groupId True
  • string

グループ id。

groupType True

グループの種類。

tags True
  • string[]

IoT Hub タグ。

deviceCount
  • integer

グループ内のデバイスの数。

応答

Name Type Description
200 OK

グループのプロパティ。

400 Bad Request

クエリパラメーターの GroupId と要求本文が一致しません。

404 Not Found

見つかりません。

セキュリティ

azure_auth

Azure Active DirectoryOAuth2 Flow

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

Scopes

Name Description
user_impersonation ユーザーアカウントの権限を借用する

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

定義

Group

グループの詳細。

GroupType

サポートされているグループの種類。

Group

グループの詳細。

Name Type Description
createdDateTime
  • string

更新プログラムが作成された日付と時刻。

deviceCount
  • integer

グループ内のデバイスの数。

groupId
  • string

グループ id。

groupType

グループの種類。

tags
  • string[]

IoT Hub タグ。

GroupType

サポートされているグループの種類。

Name Type Description
IoTHubTag
  • string

タグベースのグループを IoT Hub します。