deviceLocalCredentialInfo を一覧表示する
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
deviceLocalCredentialInfo オブジェクトとそのプロパティ (資格情報を除く) の一覧を取得します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | DeviceLocalCredential.ReadBasic.All | DeviceLocalCredential.Read.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | DeviceLocalCredential.ReadBasic.All | DeviceLocalCredential.Read.All |
職場または学校アカウントを使用した委任されたシナリオでは、サインインしているユーザーに、サポートされている Microsoft Entra ロール またはサポートされているロールのアクセス許可を持つカスタム ロールを割り当てる必要があります。 この操作では、次の最小特権ロールがサポートされています。
- クラウド デバイス管理者
- ヘルプデスク管理者
- Intune サービス管理者
- セキュリティ管理者
- セキュリティ閲覧者
- グローバル閲覧者
HTTP 要求
テナント内の deviceLocalCredentialInfo の一覧を取得するには、
注意
GET /deviceLocalCredentials エンドポイントは、2023 年 12 月 31 日に非推奨となる予定です。 代わりに、 GET /directory/deviceLocalCredentials エンドポイントを使用します。
GET /directory/deviceLocalCredentials
GET /deviceLocalCredentials
オプションのクエリ パラメーター
このメソッドは、 $select、 $filter、 $search、 $orderby、 $top、 $count 、 $skiptoken OData クエリ パラメーターをサポートし、応答をカスタマイズします。
応答には、結果セットをページングするために使用できる odata.nextLinkが含まれている場合もあります。 詳細については、「 Microsoft Graph データのページング」を参照してください。
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
| User-Agent | 呼び出し元のアプリケーションの識別子。 この値には、オペレーティング システムと使用されるブラウザーに関する情報が含まれます。 必須です。 |
| ocp-client-name | API 呼び出しを実行するクライアント アプリケーションの名前。 このヘッダーは、デバッグ目的で使用されます。 省略可能。 |
| ocp-client-version | API 呼び出しを実行するクライアント アプリケーションのバージョン。 このヘッダーは、デバッグ目的で使用されます。 省略可能。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは200 OK応答コードと、応答本文の資格情報オブジェクトを除く deviceLocalCredentialInfo オブジェクトのコレクションを返します。
例
要求
次の例は要求を示しています。
GET https://graph.microsoft.com/beta/directory/deviceLocalCredentials
User-Agent: "Dsreg/10.0 (Windows 10.0.19043.1466)"
ocp-client-name: "My Friendly Client"
ocp-client-version: "1.2"
応答
次の例は応答を示しています。
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"id": "b465e4e8-e4e8-b465-e8e4-65b4e8e465b4",
"deviceName": "LAPS_TEST",
"lastBackupDateTime": "2023-04-21T13:45:30.0000000Z",
"refreshDateTime": "2020-05-20T13:45:30.0000000Z"
},
{
"id": "c9a5d9e6-d2bd-4ff6-8a47-38b98800600c",
"deviceName": "LAPS_TEST2",
"lastBackupDateTime": "2023-04-21T13:45:30.0000000Z",
"refreshDateTime": "2020-05-20T13:45:30.0000000Z"
}
]
}