Devices - Create Or Update Group

Criar ou atualizar um grupo de dispositivos.

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

Parâmetros de URI

Name In Required Type Description
accountEndpoint
path True
  • string

Ponto de extremidade da conta.

groupId
path True
  • string

Identificador de grupo.

instanceId
path True
  • string

Identificador de instância de conta.

Corpo da solicitação

Name Required Type Description
createdDateTime True
  • string

Data e hora em que a atualização foi criada.

groupId True
  • string

Identidade do grupo.

groupType True

Tipo de grupo.

tags True
  • string[]

Marcas do Hub IoT.

deviceCount
  • integer

O número de dispositivos no grupo.

Respostas

Name Type Description
200 OK

As propriedades do grupo.

400 Bad Request

GroupId no parâmetro de consulta e no corpo da solicitação não são encontrados.

404 Not Found

Não encontrado.

Segurança

azure_auth

Azure Active Directory fluxo OAuth2

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

Scopes

Name Description
user_impersonation representar sua conta de usuário

Exemplos

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

Definições

Group

Detalhes do grupo.

GroupType

Tipos de grupo com suporte.

Group

Detalhes do grupo.

Name Type Description
createdDateTime
  • string

Data e hora em que a atualização foi criada.

deviceCount
  • integer

O número de dispositivos no grupo.

groupId
  • string

Identidade do grupo.

groupType

Tipo de grupo.

tags
  • string[]

Marcas do Hub IoT.

GroupType

Tipos de grupo com suporte.

Name Type Description
IoTHubTag
  • string

Grupo baseado em marca do Hub IoT.