informationProtectionLabel: extractLabel

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

名前空間: microsoft.graph

重要

Microsoft Graph のバージョンの /beta API は変更される可能性があります。実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。

既にラベルが付いた情報に存在するメタデータを使用して、メタデータを特定の感度ラベルに解決します。 contentInfo 入力は informationProtectionContentLabel に解決されます。

注意

informationProtectionContentLabel リソースは、情報に適用された感度ラベルを表します。 informationProtectionLabel オブジェクトは、組織のラベル付けポリシーの一部であり、情報に適用できる抽象ラベルです。

アクセス許可

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

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

HTTP 要求

POST /informationprotection/policy/labels/extractLabel

要求ヘッダー

名前	説明
Authorization	ベアラー {token}。必須。
Content-type	コンテンツタイプ: application/json。必須です。
User-Agent	呼び出し元のアプリケーションの名前とバージョンを説明します。詳細は Azure Information Protection Analytics に表示されます。推奨される形式は ApplicationName/Version です。省略可能。

要求本文

要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。

パラメーター	種類	説明
contentInfo	contentInfo	コンテンツ形式、コンテンツの状態、および既存のメタデータの詳細をキーと値のペアとして提供します。

応答

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

例

この API を呼び出す方法の例を次に示します。

要求

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

POST https://graph.microsoft.com/beta/informationProtection/policy/labels/extractLabel
Content-type: application/json
User-agent: ContosoLOBApp/1.0

{
    "contentInfo": {
        "@odata.type": "#microsoft.graph.contentInfo",
        "format@odata.type": "#microsoft.graph.contentFormat",
        "format": "default",
        "identifier": null,
        "state@odata.type": "#microsoft.graph.contentState",
        "state": "rest",
        "metadata@odata.type": "#Collection(microsoft.graph.keyValuePair)",
        "metadata": [
            {
                "@odata.type": "#microsoft.graph.keyValuePair",
                "name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Enabled",
                "value": "True"
            },
            {
                "@odata.type": "#microsoft.graph.keyValuePair",
                "name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Method",
                "value": "Standard"
            },
            {
                "@odata.type": "#microsoft.graph.keyValuePair",
                "name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SetDate",
                "value": "1/1/0001 12:00:00 AM"
            },
            {
                "@odata.type": "#microsoft.graph.keyValuePair",
                "name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SiteId",
                "value": "cfa4cf1d-a337-4481-aa99-19d8f3d63f7c"
            },
            {
                "@odata.type": "#microsoft.graph.keyValuePair",
                "name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Name",
                "value": "Top Secret"
            },
            {
                "@odata.type": "#microsoft.graph.keyValuePair",
                "name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ContentBits",
                "value": "0"
            },
            {
                "@odata.type": "#microsoft.graph.keyValuePair",
                "name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ActionId",
                "value": "00000000-0000-0000-0000-000000000000"
            }
        ]
    }
}


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var contentInfo = new ContentInfo
{
    Format = ContentFormat.Default,
    Identifier = null,
    State = ContentState.Rest,
    Metadata = new List<KeyValuePair>()
    {
        new KeyValuePair
        {
            Name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Enabled",
            Value = "True"
        },
        new KeyValuePair
        {
            Name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Method",
            Value = "Standard"
        },
        new KeyValuePair
        {
            Name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SetDate",
            Value = "1/1/0001 12:00:00 AM"
        },
        new KeyValuePair
        {
            Name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SiteId",
            Value = "cfa4cf1d-a337-4481-aa99-19d8f3d63f7c"
        },
        new KeyValuePair
        {
            Name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Name",
            Value = "Top Secret"
        },
        new KeyValuePair
        {
            Name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ContentBits",
            Value = "0"
        },
        new KeyValuePair
        {
            Name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ActionId",
            Value = "00000000-0000-0000-0000-000000000000"
        }
    },
    AdditionalData = new Dictionary<string, object>()
    {
        {"format@odata.type", "#microsoft.graph.contentFormat"},
        {"state@odata.type", "#microsoft.graph.contentState"},
        {"metadata@odata.type", "#Collection(microsoft.graph.keyValuePair)"}
    }
};

await graphClient.InformationProtection.Policy.Labels
    .ExtractLabel(contentInfo)
    .Request()
    .Header("User-Agent","ContosoLOBApp/1.0")
    .PostAsync();

重要

Microsoft Graph SDK では、既定で v1.0 バージョンの API が使用され、ベータ版で使用できるすべての種類、プロパティ、API はサポートされていません。 SDK を使用してベータ API にアクセスする方法の詳細については、「Microsoft Graph SDK とベータ API を使用する」を参照してください。

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


const options = {
    authProvider,
};

const client = Client.init(options);

const informationProtectionContentLabel = {
    contentInfo: {
        '@odata.type': '#microsoft.graph.contentInfo',
        'format@odata.type': '#microsoft.graph.contentFormat',
        format: 'default',
        identifier: null,
        'state@odata.type': '#microsoft.graph.contentState',
        state: 'rest',
        'metadata@odata.type': '#Collection(microsoft.graph.keyValuePair)',
        metadata: [
            {
                '@odata.type': '#microsoft.graph.keyValuePair',
                name: 'MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Enabled',
                value: 'True'
            },
            {
                '@odata.type': '#microsoft.graph.keyValuePair',
                name: 'MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Method',
                value: 'Standard'
            },
            {
                '@odata.type': '#microsoft.graph.keyValuePair',
                name: 'MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SetDate',
                value: '1/1/0001 12:00:00 AM'
            },
            {
                '@odata.type': '#microsoft.graph.keyValuePair',
                name: 'MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SiteId',
                value: 'cfa4cf1d-a337-4481-aa99-19d8f3d63f7c'
            },
            {
                '@odata.type': '#microsoft.graph.keyValuePair',
                name: 'MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Name',
                value: 'Top Secret'
            },
            {
                '@odata.type': '#microsoft.graph.keyValuePair',
                name: 'MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ContentBits',
                value: '0'
            },
            {
                '@odata.type': '#microsoft.graph.keyValuePair',
                name: 'MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ActionId',
                value: '00000000-0000-0000-0000-000000000000'
            }
        ]
    }
};

await client.api('/informationProtection/policy/labels/extractLabel')
    .version('beta')
    .post(informationProtectionContentLabel);

重要

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/informationProtection/policy/labels/extractLabel"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"ContosoLOBApp/1.0" forHTTPHeaderField:@"User-Agent"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

NSMutableDictionary *payloadDictionary = [[NSMutableDictionary alloc] init];

MSGraphContentInfo *contentInfo = [[MSGraphContentInfo alloc] init];
[contentInfo setFormat: [MSGraphContentFormat default]];
[contentInfo setIdentifier: null];
[contentInfo setState: [MSGraphContentState rest]];
NSMutableArray *metadataList = [[NSMutableArray alloc] init];
MSGraphKeyValuePair *metadata = [[MSGraphKeyValuePair alloc] init];
[metadata setName:@"MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Enabled"];
[metadata setValue:@"True"];
[metadataList addObject: metadata];
MSGraphKeyValuePair *metadata = [[MSGraphKeyValuePair alloc] init];
[metadata setName:@"MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Method"];
[metadata setValue:@"Standard"];
[metadataList addObject: metadata];
MSGraphKeyValuePair *metadata = [[MSGraphKeyValuePair alloc] init];
[metadata setName:@"MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SetDate"];
[metadata setValue:@"1/1/0001 12:00:00 AM"];
[metadataList addObject: metadata];
MSGraphKeyValuePair *metadata = [[MSGraphKeyValuePair alloc] init];
[metadata setName:@"MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SiteId"];
[metadata setValue:@"cfa4cf1d-a337-4481-aa99-19d8f3d63f7c"];
[metadataList addObject: metadata];
MSGraphKeyValuePair *metadata = [[MSGraphKeyValuePair alloc] init];
[metadata setName:@"MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Name"];
[metadata setValue:@"Top Secret"];
[metadataList addObject: metadata];
MSGraphKeyValuePair *metadata = [[MSGraphKeyValuePair alloc] init];
[metadata setName:@"MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ContentBits"];
[metadata setValue:@"0"];
[metadataList addObject: metadata];
MSGraphKeyValuePair *metadata = [[MSGraphKeyValuePair alloc] init];
[metadata setName:@"MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ActionId"];
[metadata setValue:@"00000000-0000-0000-0000-000000000000"];
[metadataList addObject: metadata];
[contentInfo setMetadata:metadataList];
payloadDictionary[@"contentInfo"] = contentInfo;

NSData *data = [NSJSONSerialization dataWithJSONObject:payloadDictionary options:kNilOptions error:&error];
[urlRequest setHTTPBody:data];

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

        //Request Completed

}];

[meDataTask execute];

重要

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


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

LinkedList<Option> requestOptions = new LinkedList<Option>();
requestOptions.add(new HeaderOption("User-Agent", "ContosoLOBApp/1.0"));

ContentInfo contentInfo = new ContentInfo();
contentInfo.additionalDataManager().put("format@odata.type", new JsonPrimitive("#microsoft.graph.contentFormat"));
contentInfo.format = ContentFormat.DEFAULT;
contentInfo.identifier = null;
contentInfo.additionalDataManager().put("state@odata.type", new JsonPrimitive("#microsoft.graph.contentState"));
contentInfo.state = ContentState.REST;
contentInfo.additionalDataManager().put("metadata@odata.type", new JsonPrimitive("#Collection(microsoft.graph.keyValuePair)"));
LinkedList<KeyValuePair> metadataList = new LinkedList<KeyValuePair>();
KeyValuePair metadata = new KeyValuePair();
metadata.name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Enabled";
metadata.value = "True";
metadataList.add(metadata);
KeyValuePair metadata1 = new KeyValuePair();
metadata1.name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Method";
metadata1.value = "Standard";
metadataList.add(metadata1);
KeyValuePair metadata2 = new KeyValuePair();
metadata2.name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SetDate";
metadata2.value = "1/1/0001 12:00:00 AM";
metadataList.add(metadata2);
KeyValuePair metadata3 = new KeyValuePair();
metadata3.name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SiteId";
metadata3.value = "cfa4cf1d-a337-4481-aa99-19d8f3d63f7c";
metadataList.add(metadata3);
KeyValuePair metadata4 = new KeyValuePair();
metadata4.name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Name";
metadata4.value = "Top Secret";
metadataList.add(metadata4);
KeyValuePair metadata5 = new KeyValuePair();
metadata5.name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ContentBits";
metadata5.value = "0";
metadataList.add(metadata5);
KeyValuePair metadata6 = new KeyValuePair();
metadata6.name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ActionId";
metadata6.value = "00000000-0000-0000-0000-000000000000";
metadataList.add(metadata6);
contentInfo.metadata = metadataList;

graphClient.informationProtection().policy().labels()
    .extractLabel(InformationProtectionLabelExtractLabelParameterSet
        .newBuilder()
        .withContentInfo(contentInfo)
        .build())
    .buildRequest( requestOptions )
    .post();

重要

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


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

requestBody := msgraphsdk.NewContentInfoRequestBody()
contentInfo := msgraphsdk.NewContentInfo()
requestBody.SetContentInfo(contentInfo)
format := "default"
contentInfo.SetFormat(&format)
contentInfo.SetIdentifier(nil)
state := "rest"
contentInfo.SetState(&state)
contentInfo.SetMetadata( []KeyValuePair {
    msgraphsdk.NewKeyValuePair(),
name := "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Enabled"
    SetName(&name)
value := "True"
    SetValue(&value)
    SetAdditionalData(map[string]interface{}{
        "@odata.type": "#microsoft.graph.keyValuePair",
    }
    msgraphsdk.NewKeyValuePair(),
name := "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Method"
    SetName(&name)
value := "Standard"
    SetValue(&value)
    SetAdditionalData(map[string]interface{}{
        "@odata.type": "#microsoft.graph.keyValuePair",
    }
    msgraphsdk.NewKeyValuePair(),
name := "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SetDate"
    SetName(&name)
value := "1/1/0001 12:00:00 AM"
    SetValue(&value)
    SetAdditionalData(map[string]interface{}{
        "@odata.type": "#microsoft.graph.keyValuePair",
    }
    msgraphsdk.NewKeyValuePair(),
name := "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SiteId"
    SetName(&name)
value := "cfa4cf1d-a337-4481-aa99-19d8f3d63f7c"
    SetValue(&value)
    SetAdditionalData(map[string]interface{}{
        "@odata.type": "#microsoft.graph.keyValuePair",
    }
    msgraphsdk.NewKeyValuePair(),
name := "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Name"
    SetName(&name)
value := "Top Secret"
    SetValue(&value)
    SetAdditionalData(map[string]interface{}{
        "@odata.type": "#microsoft.graph.keyValuePair",
    }
    msgraphsdk.NewKeyValuePair(),
name := "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ContentBits"
    SetName(&name)
value := "0"
    SetValue(&value)
    SetAdditionalData(map[string]interface{}{
        "@odata.type": "#microsoft.graph.keyValuePair",
    }
    msgraphsdk.NewKeyValuePair(),
name := "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ActionId"
    SetName(&name)
value := "00000000-0000-0000-0000-000000000000"
    SetValue(&value)
    SetAdditionalData(map[string]interface{}{
        "@odata.type": "#microsoft.graph.keyValuePair",
    }
}
contentInfo.SetAdditionalData(map[string]interface{}{
    "@odata.type": "#microsoft.graph.contentInfo",
    "format@odata.type": "#microsoft.graph.contentFormat",
    "state@odata.type": "#microsoft.graph.contentState",
    "metadata@odata.type": "#Collection(microsoft.graph.keyValuePair)",
}
headers := map[string]string{
    "User-Agent": "ContosoLOBApp/1.0"
}
options := &msgraphsdk.ExtractLabelRequestBuilderPostRequestConfiguration{
    Headers: headers,
}
result, err := graphClient.InformationProtection().Policy().Labels().ExtractLabel().PostWithRequestConfigurationAndResponseHandler(requestBody, options, nil)

重要

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


Import-Module Microsoft.Graph.Identity.SignIns

$params = @{
    ContentInfo = @{
        "@odata.type" = "#microsoft.graph.contentInfo"
        "Format@odata.type" = "#microsoft.graph.contentFormat"
        Format = "default"
        Identifier = $null
        "State@odata.type" = "#microsoft.graph.contentState"
        State = "rest"
        "Metadata@odata.type" = "#Collection(microsoft.graph.keyValuePair)"
        Metadata = @(
            @{
                "@odata.type" = "#microsoft.graph.keyValuePair"
                Name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Enabled"
                Value = "True"
            }
            @{
                "@odata.type" = "#microsoft.graph.keyValuePair"
                Name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Method"
                Value = "Standard"
            }
            @{
                "@odata.type" = "#microsoft.graph.keyValuePair"
                Name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SetDate"
                Value = "1/1/0001 12:00:00 AM"
            }
            @{
                "@odata.type" = "#microsoft.graph.keyValuePair"
                Name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SiteId"
                Value = "cfa4cf1d-a337-4481-aa99-19d8f3d63f7c"
            }
            @{
                "@odata.type" = "#microsoft.graph.keyValuePair"
                Name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Name"
                Value = "Top Secret"
            }
            @{
                "@odata.type" = "#microsoft.graph.keyValuePair"
                Name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ContentBits"
                Value = "0"
            }
            @{
                "@odata.type" = "#microsoft.graph.keyValuePair"
                Name = "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ActionId"
                Value = "00000000-0000-0000-0000-000000000000"
            }
        )
    }
}

Invoke-MgExtractInformationProtectionPolicyLabel -BodyParameter $params

重要

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

応答

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

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.informationProtectionContentLabel",
    "creationDateTime": "1970-01-01T00:00:00Z",
    "assignmentMethod": "standard",
    "label": {
        "id": "722a5300-ac39-4c9a-88e3-f54c46676417",
        "name": "Top Secret",
        "description": "",
        "color": "#000000",
        "sensitivity": 13,
        "tooltip": "This information is top secret.",
        "isActive": true,
        "parent" : null
    }
}

informationProtectionLabel: extractLabel

アクセス許可

HTTP 要求

要求ヘッダー

要求本文

応答

例

要求

応答

フィードバック