Compartilhar via


Device Groups - Get

Obter um DeviceGroup. '.default' e '.unassigned' são valores definidos pelo sistema e não podem ser usados para o nome do grupo de produtos ou dispositivos.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/products/{productName}/deviceGroups/{deviceGroupName}?api-version=2024-04-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
catalogName
path True

string

Nome do catálogo

Padrão Regex: ^[A-Za-z0-9_-]{1,50}$

deviceGroupName
path True

string

Nome do grupo de dispositivos.

Padrão Regex: ^[A-Za-z0-9]{1,2}$|^[A-Za-z0-9][A-Za-z0-9\s]{1,48}[A-Za-z0-9]$|^\.default$|^\.unassigned$

productName
path True

string

Nome do produto.

Padrão Regex: ^[\w][\w\s]{1,48}[\w]$|^\.default$|^\.unassigned$

resourceGroupName
path True

string

O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas.

subscriptionId
path True

string

A ID da assinatura de destino.

api-version
query True

string

A versão da API a ser usada para esta operação.

Respostas

Nome Tipo Description
200 OK

DeviceGroup

Operação do Azure concluída com êxito.

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

DeviceGroups_Get

Solicitação de exemplo

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup1/providers/Microsoft.AzureSphere/catalogs/MyCatalog1/products/MyProduct1/deviceGroups/MyDeviceGroup1?api-version=2024-04-01

Resposta de exemplo

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup1/providers/Microsoft.AzureSphere/catalogs/MyCatalog1/products/MyProduct1/devicegroups/MyDeviceGroup1",
  "type": "microsoft.azureSphere/catalogs/products/devicegroups",
  "properties": {
    "description": "The description of MyDeviceGroup1",
    "osFeedType": "Retail",
    "updatePolicy": "UpdateAll"
  }
}

Definições

Nome Description
AllowCrashDumpCollection

Permitir valores de despejos de memória.

createdByType

O tipo de identidade que criou o recurso.

DeviceGroup

Um recurso de grupo de dispositivos pertencente a um recurso de produto.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

Os detalhes do erro.

ErrorResponse

Resposta de erro

OSFeedType

Valores de tipo de feed do sistema operacional.

ProvisioningState

Estado de provisionamento do recurso.

RegionalDataBoundary

Valores de limite de dados regionais.

systemData

Metadados relativos à criação e à última modificação do recurso.

UpdatePolicy

Atualizar valores de política.

AllowCrashDumpCollection

Permitir valores de despejos de memória.

Nome Tipo Description
Disabled

string

Coleta de despejo de memória desabilitada

Enabled

string

Coleta de despejo de memória habilitada

createdByType

O tipo de identidade que criou o recurso.

Nome Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

DeviceGroup

Um recurso de grupo de dispositivos pertencente a um recurso de produto.

Nome Tipo Description
id

string

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

O nome do recurso

properties.allowCrashDumpsCollection

AllowCrashDumpCollection

Sinalizador para definir se o usuário permite a coleta de despejo de memória.

properties.description

string

Descrição do grupo de dispositivos.

properties.hasDeployment

boolean

Status da implantação do grupo de dispositivos.

properties.osFeedType

OSFeedType

Tipo de feed do sistema operacional do grupo de dispositivos.

properties.provisioningState

ProvisioningState

O status da última operação.

properties.regionalDataBoundary

RegionalDataBoundary

Limite de dados regionais para o grupo de dispositivos.

properties.updatePolicy

UpdatePolicy

Atualizar a política do grupo de dispositivos.

systemData

systemData

Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy.

type

string

Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

Os detalhes do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

OSFeedType

Valores de tipo de feed do sistema operacional.

Nome Tipo Description
Retail

string

Tipo de feed do sistema operacional de varejo.

RetailEval

string

Tipo de feed do sistema operacional de avaliação de varejo.

ProvisioningState

Estado de provisionamento do recurso.

Nome Tipo Description
Accepted

string

A solicitação de criação de recurso foi aceita

Canceled

string

A criação do recurso foi cancelada.

Deleting

string

O recurso está sendo excluído

Failed

string

Falha na criação de recursos.

Provisioning

string

O recurso está sendo provisionado

Succeeded

string

O recurso foi criado.

Updating

string

O recurso está sendo atualizado

RegionalDataBoundary

Valores de limite de dados regionais.

Nome Tipo Description
EU

string

Limite de dados da UE

None

string

Nenhum limite de dados

systemData

Metadados relativos à criação e à última modificação do recurso.

Nome Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.

UpdatePolicy

Atualizar valores de política.

Nome Tipo Description
No3rdPartyAppUpdates

string

Nenhuma atualização para a política de aplicativo de terceiros.

UpdateAll

string

Atualize todas as políticas.