대상 그룹 데이터 가져오기

아티클
07/08/2024

Microsoft 하드웨어 API에서 다음 방법을 사용하여 조직에 적용 가능한 대상 그룹을 가져옵니다. 대상 그룹을 사용하면 게시를 특정 구성의 컴퓨터로 제한할 수 있습니다. 예를 들어 테스트 배포는 특정 레지스트리 키가 설치된 클라이언트에만 배달할 수 있습니다.

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

이러한 메서드를 사용하려면 먼저 제품 및 제출이 개발자 센터 계정에 이미 있어야 합니다. 제품에 대한 제출을 만들거나 관리하려면 제품 제출 관리의 방법을 참조하세요.

설명	메서드	URI
조직에 적용할 수 있는 대상 그룹 목록을 가져옵니다.	GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/audiences`

필수 조건

아직 수행하지 않은 경우 이러한 메서드를 사용하기 전에 Microsoft 하드웨어 API에 대한 모든 필수 구성 요소를 완료합니다.

데이터 리소스

배송 레이블 데이터를 가져오기 위한 Microsoft 하드웨어 API 메서드는 다음 JSON 데이터 리소스를 사용합니다.

대상 그룹 리소스

이 리소스는 조직에 적용할 수 있는 대상 그룹을 나타냅니다.

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

이 리소스의 값은 다음과 같습니다.

값	형식	설명
id	string	대상 그룹의 ID입니다. 이는 배송 레이블에서 수신되거나 전송되는 값입니다.
name	string	대상 그룹의 이름
description	string	대상 그룹에 대한 설명
audienceName	string	대상 그룹의 이름

요청

이 메서드의 구문은 다음과 같습니다.

메서드	요청 URI
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/audience`

요청 헤더

헤더	형식	설명
권한 부여	string	필수입니다. 전달자 *<토큰 형식*의 Microsoft Entra ID 액세스 토큰>입니다.
동의	string	선택 사항. 콘텐츠 형식을 지정합니다. 허용되는 값은 "application/json"입니다.

요청 매개 변수

이 메서드에 대한 요청 매개 변수를 제공하지 마세요.

요청 본문

이 메서드에 대한 요청 본문을 제공하지 마세요.

요청 예제

다음 예제에서는 조직에 적용할 수 있는 대상 그룹에 대한 정보를 검색하는 방법을 보여 줍니다.

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

Response

다음 예제에서는 조직에 적용할 수 있는 모든 대상 그룹에 대한 성공적인 요청에 의해 반환된 JSON 응답 본문을 보여 줍니다. 응답 본문의 값에 대한 세부 정보는 예제 다음 표에 표시됩니다.

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