deviceTemplate 所有者の一覧表示
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
deviceTemplate オブジェクトの所有者の一覧を取得します。 所有者は、 サービス プリンシパル、 ユーザー、または アプリケーションとして表すことができます。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | DeviceTemplate.Read | DeviceTemplate.Read.All、DeviceTemplate.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | DeviceTemplate.Read.All | DeviceTemplate.ReadWrite.All |
重要
職場または学校アカウントを使用した委任されたシナリオでは、サインインしているユーザーに、サポートされているMicrosoft Entraロールまたはサポートされているロールのアクセス許可を持つカスタム ロールを割り当てる必要があります。 この操作では、次の最小特権ロールがサポートされています。
- クラウド デバイス管理者
- IoT デバイス管理者
- ユーザー - デバイス テンプレート オブジェクトの所有者
手記： ユーザーは オブジェクトの所有者である必要があります。
HTTP 要求
GET /directory/templates/deviceTemplates/{id}/owners
手記：要求 URL の
{id}は、deviceTemplate の id プロパティの値です。
オプションのクエリ パラメーター
このメソッドは、応答のカスタマイズに役立つ OData クエリ パラメーターの $select と $top をサポートします。
$top結果のページ サイズは、1 から 999 までの範囲です。 一般的な情報については、「OData クエリ パラメーター」を参照してください。
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
要求
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは、200 OK応答コードと、ディレクトリ オブジェクトの種類を示すコレクション内の各オブジェクトの @odata.type プロパティを使用して、応答本文の directoryObject オブジェクトのコレクションを返します。 デバイス テンプレートの所有者にできるのは、 サービス プリンシパル、 ユーザー、または アプリケーション だけです。
詳細については、「 Microsoft Graph のエラー応答とリソースの種類」を参照してください。
例
要求
次の例は要求を示しています。
GET https://graph.microsoft.com/beta/directory/templates/deviceTemplates/00f1e7a4-de6d-4070-84df-8aab629c4d1e/owners
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects",
"value": [
{
"@odata.type": "#microsoft.graph.servicePrincipal",
"id": "4vfaf3ac-5122-4a25-98d8-b32c091f441f",
"accountEnabled": true,
"alternativeNames": [],
"createdDateTime": "2024-09-11T21:21:25Z",
"appDisplayName": "test",
"appId": "00001111-aaaa-2222-bbbb-3333cccc4444",
"appOwnerOrganizationId": "0a0a0a0a-1111-bbbb-2222-3c3c3c3c3c3c",
"appRoleAssignmentRequired": false,
"displayName": "test",
"isAuthorizationServiceEnabled": false,
"notificationEmailAddresses": [],
"publisherName": "Workplace Join Android",
"samlSLOBindingType": "httpRedirect",
"servicePrincipalNames": [
"00001111-aaaa-2222-bbbb-3333cccc4444"
],
"servicePrincipalType": "Application",
"signInAudience": "AzureADMyOrg",
"tags": [
"HideApp",
"WindowsAzureActiveDirectoryIntegratedApp"
]
}
]
}