Ottenere i dati del gruppo di destinatari

Articolo
07/08/2024

Usare il metodo seguente nelle API hardware Microsoft per ottenere i destinatari applicabili all'organizzazione. I gruppi di destinatari consentono di limitare una pubblicazione ai computer con una configurazione specifica. Ad esempio, una distribuzione di test può essere distribuita solo ai client con una determinata chiave del Registro di sistema installata.

https://manage.devcenter.microsoft.com/v2.0/my/hardware/audiences

Prima di poter usare questi metodi, il prodotto e l'invio devono esistere già nel tuo account Dev Center. Per creare o gestire gli invii per i prodotti, vedi i metodi in Gestire gli invii di prodotti.

Descrizione	Method	URI
Ottenere un elenco di gruppi di destinatari applicabili all'organizzazione.	GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/audiences`

Prerequisiti

Se non è già stato fatto, completare tutti i prerequisiti per le API hardware Microsoft prima di provare a usare uno di questi metodi.

Risorse dati

I metodi delle API hardware Microsoft per ottenere i dati delle etichette di spedizione usano le risorse di dati JSON seguenti.

Risorsa gruppo di destinatari

Questa risorsa rappresenta un gruppo di destinatari applicabile all'organizzazione.

{
  "id": "9f4f44d8-bfec-48c6-a02c-2d9ea220f6e2",
  "name": "My Custom Audience",
  "description": "Matches machines that have the following registry key: HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\FOO-BAR",
  "audienceName": "Sample_Audience_Key"
}

Questa risorsa ha i valori seguenti

Valore	Tipo	Descrizione
id	string	ID del gruppo di destinatari. Si tratta del valore che verrà ricevuto o inviato nell'etichetta di spedizione.
name	string	Nome descrittivo del pubblico
description	stringa	Descrizione del gruppo di destinatari
audienceName	string	Nome del gruppo di destinatari

Richiedi

Questo metodo ha la sintassi seguente.

metodo	URI della richiesta
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/audience`

Intestazione della richiesta

Intestazione	Type	Descrizione
Autorizzazione	stringa	Obbligatorio. Token di accesso microsoft Entra ID nel formato token> di connessione<.
accept	string	Facoltativo. Specifica il tipo di contenuto. Il valore consentito è "application/json"

Parametri della richiesta

Non specificare parametri di richiesta per questo metodo.

Corpo della richiesta

Non fornire un corpo della richiesta per questo metodo.

Esempi di richiesta

L'esempio seguente illustra come recuperare informazioni sui gruppi di destinatari applicabili all'organizzazione.

GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/audience HTTP/1.1
Authorization: Bearer <your access token>

Response

L'esempio seguente illustra il corpo della risposta JSON restituito da una richiesta riuscita per tutti i destinatari applicabili all'organizzazione. I dettagli sui valori nel corpo della risposta vengono visualizzati nella tabella che segue l'esempio.

{
  "value": [
    {
      "id": "9f4f44d8-bfec-48c6-a02c-2d9ea220f6e2",
      "name": "Test Registry Key",
      "description": "Matches machines that have the following registry key: HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\Test Drivers - use at own risk",
      "audienceName": "Test_Registry_Key"
    },
    {
      "id": "10415bba-3572-421b-a3de-d0d347bace5f",
      "name": "Test Audience 2",
      "description": "Additional Audience",
      "audienceName": "Test_Audeince_2"
    }
  ],
  "links": [
    {
      "href": "https://manage.devcenter..microsoft.com/api/v1/hardware/audiences",
      "rel": "self",
      "method": "GET"
    }
  ]
}