Delen via


Device Groups - Get

Haal een DeviceGroup op. '.default' en '.unassigned' zijn door het systeem gedefinieerde waarden en kunnen niet worden gebruikt voor product- of apparaatgroepnaam.

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

URI-parameters

Name In Vereist Type Description
catalogName
path True

string

Naam van catalogus

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

deviceGroupName
path True

string

Naam van apparaatgroep.

Regex-patroon: ^[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

Naam van product.

Regex-patroon: ^[\w][\w\s]{1,48}[\w]$|^\.default$|^\.unassigned$

resourceGroupName
path True

string

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

subscriptionId
path True

string

De id van het doelabonnement.

api-version
query True

string

De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name Type Description
200 OK

DeviceGroup

De Azure-bewerking is voltooid.

Other Status Codes

ErrorResponse

Een onverwacht foutbericht.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

DeviceGroups_Get

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
AllowCrashDumpCollection

Sta waarden voor crashdumps toe.

createdByType

Het type identiteit waarmee de resource is gemaakt.

DeviceGroup

Een apparaatgroepresource die deel uitmaakt van een productresource.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

OSFeedType

Waarden van het type besturingssysteemfeed.

ProvisioningState

Inrichtingsstatus van resource.

RegionalDataBoundary

Grenswaarden voor regionale gegevens.

systemData

Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

UpdatePolicy

Beleidswaarden bijwerken.

AllowCrashDumpCollection

Sta waarden voor crashdumps toe.

Name Type Description
Disabled

string

Crashdumpverzameling uitgeschakeld

Enabled

string

Crashdumpverzameling ingeschakeld

createdByType

Het type identiteit waarmee de resource is gemaakt.

Name Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

DeviceGroup

Een apparaatgroepresource die deel uitmaakt van een productresource.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

De naam van de resource

properties.allowCrashDumpsCollection

AllowCrashDumpCollection

Vlag om te definiƫren of de gebruiker het verzamelen van crashdumps toestaat.

properties.description

string

Beschrijving van de apparaatgroep.

properties.hasDeployment

boolean

Implementatiestatus voor de apparaatgroep.

properties.osFeedType

OSFeedType

Type besturingssysteemfeed van de apparaatgroep.

properties.provisioningState

ProvisioningState

De status van de laatste bewerking.

properties.regionalDataBoundary

RegionalDataBoundary

Regionale gegevensgrens voor de apparaatgroep.

properties.updatePolicy

UpdatePolicy

Beleid van de apparaatgroep bijwerken.

systemData

systemData

Azure Resource Manager-metagegevens met informatie over createdBy en modifiedBy.

type

string

Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

OSFeedType

Waarden van het type besturingssysteemfeed.

Name Type Description
Retail

string

Feedtype retail-besturingssysteem.

RetailEval

string

Type besturingssysteemfeed voor retailevaluatie.

ProvisioningState

Inrichtingsstatus van resource.

Name Type Description
Accepted

string

De aanvraag voor het maken van resources is geaccepteerd

Canceled

string

Het maken van resources is geannuleerd.

Deleting

string

De resource wordt verwijderd

Failed

string

Het maken van resources is mislukt.

Provisioning

string

De resource wordt ingericht

Succeeded

string

De resource is gemaakt.

Updating

string

De resource wordt bijgewerkt

RegionalDataBoundary

Grenswaarden voor regionale gegevens.

Name Type Description
EU

string

EU-gegevensgrens

None

string

Geen gegevensgrens

systemData

Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

Name Type Description
createdAt

string

De tijdstempel van het maken van resources (UTC).

createdBy

string

De identiteit die de resource heeft gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.

lastModifiedAt

string

Het tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

De identiteit die de resource het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource het laatst heeft gewijzigd.

UpdatePolicy

Beleidswaarden bijwerken.

Name Type Description
No3rdPartyAppUpdates

string

Geen update voor app-beleid van derden.

UpdateAll

string

Alle beleidsregels bijwerken.