取得對象數據

發行項
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	字串	對象的識別碼。這是將在出貨標籤中接收或傳送的值。
NAME	字串	物件的易記名稱
description	字串	物件的描述
audienceName	字串	物件名稱

Request

此方法具有下列語法。

方法	要求 URI
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/audience`

要求標頭

標題	類型	描述
授權	字串	必要。 Microsoft持有人*<令牌形式的* Entra ID 存取令牌。>
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 Audience",
      "audienceName": "Test_Audeince_2"
    }
  ],
  "links": [
    {
      "href": "https://manage.devcenter..microsoft.com/api/v1/hardware/audiences",
      "rel": "self",
      "method": "GET"
    }
  ]
}