recoveryKeys の一覧

[アーティクル]
02/18/2022

名前空間: microsoft.graph

bitlockerRecoveryKey オブジェクトとそのプロパティの一覧を取得します。

この操作では、key プロパティは返されない。 key プロパティを読み取 る方法については 、「 Get bitlockerRecoveryKey」を参照してください。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の大きいものから小さいものへ)
委任 (職場または学校のアカウント)	BitLockerKey.ReadBasic.All, BitLockerKey.Read.All
委任 (個人用 Microsoft アカウント)	サポートされていません
アプリケーション	非サポート

委任されたアクセス許可の場合、呼び出し元のユーザーは、BitLocker 回復キーが最初にバックアップされたデバイスの登録所有者である必要があります。または、次のいずれかのディレクトリロールに存在する必要があります。

グローバル管理者
クラウドデバイス管理者
ヘルプデスク管理者
Intune サービス管理者
セキュリティ管理者
セキュリティ閲覧者
グローバル閲覧者

HTTP 要求

テナント内の BitLocker キーの一覧を取得するには、次の手順を実行します。

GET /informationProtection/bitlocker/recoveryKeys

オプションのクエリパラメーター

このメソッドは $filter 、OData クエリパラメーターをサポートして、キーが最近バックアップされたデバイスの deviceId で結果をフィルター処理します。このメソッドはサポートされていません $top。一般的な情報については、「OData クエリパラメーター」を参照してください。

応答には、結果セットの odata.nextLinkページに使用できる、が含まれている場合があります。詳細については、「ページング Microsoft Graph」を参照してください。

要求ヘッダー

名前	説明
Authorization	ベアラー {token}。必須。
User-Agent	呼び出し元のアプリケーションの識別子。この値には、使用するオペレーティングシステムとブラウザーに関する情報が含まれる。必須です。
ocp-client-name	API 呼び出しを実行するクライアントアプリケーションの名前。このヘッダーは、デバッグの目的で使用されます。省略可能。
ocp-client-version	API 呼び出しを実行するクライアントアプリケーションのバージョン。このヘッダーは、デバッグの目的で使用されます。省略可能。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは応答 200 OK コードと、応答本文の bitlockerRecoveryKey オブジェクトのコレクションを返します。

例

例 1: テナント内の BitLocker キーの一覧を取得します。

要求

要求の例を次に示します。

GET https://graph.microsoft.com/v1.0/informationProtection/bitlocker/recoveryKeys
User-Agent: "Dsreg/10.0 (Windows 10.0.19043.1466)"
ocp-client-name: "My Friendly Client"
ocp-client-version: "1.2"


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var recoveryKeys = await graphClient.InformationProtection.Bitlocker.RecoveryKeys
    .Request()
    .Header("ocp-client-name","\"My Friendly Client\"")
    .Header("ocp-client-version","\"1.2\"")
    .GetAsync();


const options = {
    authProvider,
};

const client = Client.init(options);

let recoveryKeys = await client.api('/informationProtection/bitlocker/recoveryKeys')
    .header('ocp-client-name','"My Friendly Client"')
    .header('ocp-client-version','"1.2"')
    .get();


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/v1.0/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/informationProtection/bitlocker/recoveryKeys"]]];
[urlRequest setHTTPMethod:@"GET"];
[urlRequest setValue:@"\"My Friendly Client\"" forHTTPHeaderField:@"ocp-client-name"];
[urlRequest setValue:@"\"1.2\"" forHTTPHeaderField:@"ocp-client-version"];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        NSError *jsonError = nil;
        MSCollection *collection = [[MSCollection alloc] initWithData:data error:&jsonError];
        MSGraphBitlockerRecoveryKey *bitlockerRecoveryKey = [[MSGraphBitlockerRecoveryKey alloc] initWithDictionary:[[collection value] objectAtIndex: 0] error:&nserror];

}];

[meDataTask execute];


GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

LinkedList<Option> requestOptions = new LinkedList<Option>();
requestOptions.add(new HeaderOption("ocp-client-name", "\"My Friendly Client\""));
requestOptions.add(new HeaderOption("ocp-client-version", "\"1.2\""));

BitlockerRecoveryKeyCollectionPage recoveryKeys = graphClient.informationProtection().bitlocker().recoveryKeys()
    .buildRequest( requestOptions )
    .get();


//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

headers := map[string]string{
    "ocp-client-name": ""My Friendly Client""
    "ocp-client-version": ""1.2""
}
options := &msgraphsdk.RecoveryKeysRequestBuilderGetOptions{
    H: headers,
}
result, err := graphClient.InformationProtection().Bitlocker().RecoveryKeys().Get(options)


Import-Module Microsoft.Graph.Identity.SignIns

Get-MgInformationProtectionBitlockerRecoveryKey

応答

応答の例を次に示します。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.bitlockerRecoveryKey",
      "id": "b465e4e8-e4e8-b465-e8e4-65b4e8e465b4",
      "createdDateTime": "2020-06-15T13:45:30.0000000Z",
      "volumeType": "1",
      "deviceId": "2ef04ef1-23b0-2e00-a3a5-ab345e567ab6"
    },
    {
      "@odata.type": "#microsoft.graph.bitlockerRecoveryKey",
      "id": "6a30ed7b-247b-4d26-86b5-2f405e55ea42",
      "createdDateTime": "2020-06-15T13:45:30.0000000Z",
      "volumeType": "1",
      "deviceId": "1ab40ab2-32a8-4b00-b6b5-ba724e407de9"
    }
  ]
}

例 2: deviceId でフィルター処理された BitLocker キーの一覧を取得します。

要求