Delen via


Information Protection Policies - Get

Details van het informatiebeveiligingsbeleid.

GET https://management.azure.com/{scope}/providers/Microsoft.Security/informationProtectionPolicies/{informationProtectionPolicyName}?api-version=2017-08-01-preview

URI-parameters

Name In Vereist Type Description
informationProtectionPolicyName
path True

InformationProtectionPolicyName

Naam van het informatiebeveiligingsbeleid.

scope
path True

string

Het bereik van de query kan een abonnement zijn (/subscriptions/0b06d9ea-afe6-4779-bd59-30e5c2d9d13f) of beheergroep (/providers/Microsoft.Management/managementGroups/mgName).

api-version
query True

string

API-versie voor de bewerking

Antwoorden

Name Type Description
200 OK

InformationProtectionPolicy

OK

Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Get the customized information protection policy for a management group
Get the effective information protection policy for a management group

Get the customized information protection policy for a management group

Voorbeeldaanvraag

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/148059f7-faf3-49a6-ba35-85122112291e/providers/Microsoft.Security/informationProtectionPolicies/custom?api-version=2017-08-01-preview

Voorbeeldrespons

{
  "id": "/providers/Microsoft.Management/managementGroups/148059f7-faf3-49a6-ba35-85122112291e/providers/Microsoft.Security/informationProtectionPolicies/custom",
  "name": "custom",
  "type": "Microsoft.Security/informationProtectionPolicies",
  "properties": {
    "labels": {
      "1345da73-bc5a-4a8f-b7dd-3820eb713da8": {
        "displayName": "Public",
        "order": 100,
        "enabled": true
      },
      "7aa516c7-5a53-4857-bc6e-6808c6acd542": {
        "displayName": "General",
        "order": 200,
        "enabled": true
      },
      "575739d2-3d53-4df0-9042-4c7772d5c7b1": {
        "displayName": "Confidential",
        "order": 300,
        "enabled": true
      }
    },
    "informationTypes": {
      "7fb9419d-2473-4ad8-8e11-b25cc8cf6a07": {
        "displayName": "Networking",
        "order": 100,
        "recommendedLabelId": "575739d2-3d53-4df0-9042-4c7772d5c7b1",
        "enabled": true,
        "custom": false,
        "keywords": [
          {
            "pattern": "%networking%",
            "custom": true,
            "canBeNumeric": false
          }
        ]
      },
      "3bf35491-99b8-41f2-86d5-c1200a7df658": {
        "displayName": "Custom",
        "order": 1400,
        "recommendedLabelId": "7aa516c7-5a53-4857-bc6e-6808c6acd542",
        "enabled": true,
        "custom": true,
        "keywords": [
          {
            "pattern": "%custom%",
            "custom": true,
            "canBeNumeric": true
          }
        ]
      }
    }
  }
}

Get the effective information protection policy for a management group

Voorbeeldaanvraag

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/148059f7-faf3-49a6-ba35-85122112291e/providers/Microsoft.Security/informationProtectionPolicies/effective?api-version=2017-08-01-preview

Voorbeeldrespons

{
  "id": "/providers/Microsoft.Management/managementGroups/148059f7-faf3-49a6-ba35-85122112291e/providers/Microsoft.Security/informationProtectionPolicies/effective",
  "name": "effective",
  "type": "Microsoft.Security/informationProtectionPolicies",
  "properties": {
    "labels": {
      "1345da73-bc5a-4a8f-b7dd-3820eb713da8": {
        "displayName": "Public",
        "order": 100,
        "enabled": true
      },
      "7aa516c7-5a53-4857-bc6e-6808c6acd542": {
        "displayName": "General",
        "order": 200,
        "enabled": true
      },
      "575739d2-3d53-4df0-9042-4c7772d5c7b1": {
        "displayName": "Confidential",
        "order": 300,
        "enabled": true
      }
    },
    "informationTypes": {
      "7fb9419d-2473-4ad8-8e11-b25cc8cf6a07": {
        "displayName": "Networking",
        "order": 100,
        "recommendedLabelId": "575739d2-3d53-4df0-9042-4c7772d5c7b1",
        "enabled": true,
        "custom": false,
        "keywords": [
          {
            "pattern": "%ip%",
            "custom": false,
            "canBeNumeric": false
          },
          {
            "pattern": "ip%address%",
            "custom": false,
            "canBeNumeric": false
          },
          {
            "pattern": "%mac%address%",
            "custom": false,
            "canBeNumeric": false
          },
          {
            "pattern": "%networking%",
            "custom": true,
            "canBeNumeric": true,
            "excluded": true
          }
        ]
      },
      "5856f35c-8e08-4d08-9bf7-87a146150569": {
        "displayName": "Contact Info",
        "order": 200,
        "recommendedLabelId": "575739d2-3d53-4df0-9042-4c7772d5c7b1",
        "enabled": true,
        "custom": false,
        "keywords": [
          {
            "pattern": "%email%",
            "custom": false,
            "canBeNumeric": false
          },
          {
            "pattern": "%e-mail%",
            "custom": false,
            "canBeNumeric": false
          },
          {
            "pattern": "%addr%",
            "custom": false,
            "canBeNumeric": false
          },
          {
            "pattern": "%street%",
            "custom": false,
            "canBeNumeric": true
          },
          {
            "pattern": "%city%",
            "custom": false,
            "canBeNumeric": false
          }
        ]
      },
      "3bf35491-99b8-41f2-86d5-c1200a7df658": {
        "displayName": "Custom",
        "order": 1400,
        "recommendedLabelId": "7aa516c7-5a53-4857-bc6e-6808c6acd542",
        "enabled": true,
        "custom": true,
        "keywords": [
          {
            "pattern": "%networking%",
            "custom": true,
            "canBeNumeric": false
          }
        ]
      }
    }
  }
}

Definities

Name Description
CloudError

Veelvoorkomende foutreactie voor alle Azure Resource Manager-API's om foutdetails te retourneren voor mislukte bewerkingen. (Dit volgt ook de OData-foutreactieindeling.)

CloudErrorBody

De foutdetails.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

InformationProtectionKeyword

Het trefwoord voor het informatietype.

InformationProtectionPolicy

Informatiebeveiligingsbeleid.

InformationProtectionPolicyName

Naam van het informatiebeveiligingsbeleid.

InformationType

Het informatietype.

rank

De rang van het vertrouwelijkheidslabel.

SensitivityLabel

Het vertrouwelijkheidslabel.

CloudError

Veelvoorkomende foutreactie voor alle Azure Resource Manager-API's om foutdetails te retourneren voor mislukte bewerkingen. (Dit volgt ook de OData-foutreactieindeling.)

Name Type Description
error.additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.

error.code

string

De foutcode.

error.details

CloudErrorBody[]

De foutdetails.

error.message

string

Het foutbericht.

error.target

string

Het foutdoel.

CloudErrorBody

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.

code

string

De foutcode.

details

CloudErrorBody[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het extra informatietype.

InformationProtectionKeyword

Het trefwoord voor het informatietype.

Name Type Description
canBeNumeric

boolean

Geeft aan of het trefwoord wel of niet kan worden toegepast op numerieke typen.

custom

boolean

Geeft aan of het trefwoord aangepast is of niet.

excluded

boolean

Geeft aan of het trefwoord is uitgesloten of niet.

pattern

string

Het trefwoordpatroon.

InformationProtectionPolicy

Informatiebeveiligingsbeleid.

Name Type Description
id

string

Resource-id

name

string

Resourcenaam

properties.informationTypes

<string,  InformationType>

De typen vertrouwelijkheidsinformatie.

properties.labels

<string,  SensitivityLabel>

Woordenlijst met vertrouwelijkheidslabels.

properties.lastModifiedUtc

string

Beschrijft de laatste UTC-tijd waarop het beleid is gewijzigd.

properties.version

string

Beschrijft de versie van het beleid.

type

string

Resourcetype

InformationProtectionPolicyName

Naam van het informatiebeveiligingsbeleid.

Name Type Description
custom

string

effective

string

InformationType

Het informatietype.

Name Type Description
custom

boolean

Geeft aan of het informatietype al dan niet aangepast is.

description

string

De beschrijving van het informatietype.

displayName

string

De naam van het informatietype.

enabled

boolean

Geeft aan of het informatietype is ingeschakeld of niet.

keywords

InformationProtectionKeyword[]

Het informatietype trefwoorden.

order

integer

De volgorde van het informatietype.

recommendedLabelId

string

De aanbevolen label-id die aan dit informatietype moet worden gekoppeld.

rank

De rang van het vertrouwelijkheidslabel.

Name Type Description
Critical

string

High

string

Low

string

Medium

string

None

string

SensitivityLabel

Het vertrouwelijkheidslabel.

Name Type Description
description

string

De beschrijving van het vertrouwelijkheidslabel.

displayName

string

De naam van het vertrouwelijkheidslabel.

enabled

boolean

Geeft aan of het label is ingeschakeld of niet.

order

integer

De volgorde van het vertrouwelijkheidslabel.

rank

rank

De rang van het vertrouwelijkheidslabel.