대상 그룹 데이터 가져오기

  • 아티클
  • 읽는 데 4분 걸림

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

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

값 형식 Description
id 문자열 대상 그룹의 ID입니다. 배송 레이블에서 받거나 보낼 값입니다.
name 문자열 대상 그룹의 이름
description 문자열 대상 그룹에 대한 설명
audienceName 문자열 대상 그룹의 이름

요청

이 메서드에는 다음 구문이 있습니다.

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

요청 헤더

헤더 유형 Description
권한 부여 문자열 필수 요소. 전달자<토큰 형식의 Azure AD 액세스 토큰>입니다.
accept 문자열 (선택 사항) 콘텐츠의 형식을 지정합니다. 허용되는 값은 "application/json"입니다.

요청 매개 변수

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

요청 본문

이 메서드에 대한 요청 본문을 제공하지 않습니다.

요청 예제

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

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

응답

다음 예제에서는 조직에 적용되는 모든 대상 그룹에 대한 성공적인 요청으로 반환된 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 Audeince",
      "audienceName": "Test_Audeince_2"
    }
  ],
  "links": [
    {
      "href": "https://manage.devcenter..microsoft.com/api/v1/hardware/audiences",
      "rel": "self",
      "method": "GET"
    }
  ]
}

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

값 형식 Description
값 array 각 대상 그룹에 대한 정보를 포함하는 개체의 배열입니다. 각 개체의 데이터에 대한 자세한 내용은 대상 리소스를 참조하세요.
링크 array 포함하는 엔터티에 대한 유용한 링크가 있는 개체의 배열입니다. 자세한 내용은 Link 개체 를 참조하세요.

참고 항목