Dela via


Information Protection Policies - Get

Information om informationsskyddsprincipen.

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

URI-parametrar

Name I Obligatorisk Typ Description
informationProtectionPolicyName
path True

InformationProtectionPolicyName

Namnet på informationsskyddsprincipen.

scope
path True

string

Frågans omfattning kan vara prenumeration (/subscriptions/0b06d9ea-afe6-4779-bd59-30e5c2d9d13f) eller hanteringsgrupp (/providers/Microsoft.Management/managementGroups/mgName).

api-version
query True

string

API-version för åtgärden

Svar

Name Typ Description
200 OK

InformationProtectionPolicy

OKEJ

Other Status Codes

CloudError

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

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

Exempelbegäran

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

Exempelsvar

{
  "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

Exempelbegäran

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

Exempelsvar

{
  "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
          }
        ]
      }
    }
  }
}

Definitioner

Name Description
CloudError

Vanligt felsvar för alla Azure Resource Manager-API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även formatet för OData-felsvar.).

CloudErrorBody

Felinformationen.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

InformationProtectionKeyword

Nyckelordet informationstyp.

InformationProtectionPolicy

Informationsskyddsprincip.

InformationProtectionPolicyName

Namnet på informationsskyddsprincipen.

InformationType

Informationstypen.

rank

Känslighetsetikettens rangordning.

SensitivityLabel

Känslighetsetiketten.

CloudError

Vanligt felsvar för alla Azure Resource Manager-API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även formatet för OData-felsvar.).

Name Typ Description
error.additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

error.code

string

Felkoden.

error.details

CloudErrorBody[]

Felinformationen.

error.message

string

Felmeddelandet.

error.target

string

Felmålet.

CloudErrorBody

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

CloudErrorBody[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.

type

string

Ytterligare informationstyp.

InformationProtectionKeyword

Nyckelordet informationstyp.

Name Typ Description
canBeNumeric

boolean

Anger om nyckelordet kan tillämpas på numeriska typer eller inte.

custom

boolean

Anger om nyckelordet är anpassat eller inte.

excluded

boolean

Anger om nyckelordet är exkluderat eller inte.

pattern

string

Nyckelordsmönstret.

InformationProtectionPolicy

Informationsskyddsprincip.

Name Typ Description
id

string

Resurs-ID

name

string

Resursnamn

properties.informationTypes

<string,  InformationType>

Typer av känslighetsinformation.

properties.labels

<string,  SensitivityLabel>

Ordlista med känslighetsetiketter.

properties.lastModifiedUtc

string

Beskriver den senaste UTC-tiden då principen ändrades.

properties.version

string

Beskriver versionen av principen.

type

string

Resurstyp

InformationProtectionPolicyName

Namnet på informationsskyddsprincipen.

Name Typ Description
custom

string

effective

string

InformationType

Informationstypen.

Name Typ Description
custom

boolean

Anger om informationstypen är anpassad eller inte.

description

string

Beskrivningen av informationstypen.

displayName

string

Namnet på informationstypen.

enabled

boolean

Anger om informationstypen är aktiverad eller inte.

keywords

InformationProtectionKeyword[]

Nyckelord för informationstyp.

order

integer

Ordningen på informationstypen.

recommendedLabelId

string

Det rekommenderade etikett-ID som ska associeras med den här informationstypen.

rank

Känslighetsetikettens rangordning.

Name Typ Description
Critical

string

High

string

Low

string

Medium

string

None

string

SensitivityLabel

Känslighetsetiketten.

Name Typ Description
description

string

Beskrivningen av känslighetsetiketten.

displayName

string

Namnet på känslighetsetiketten.

enabled

boolean

Anger om etiketten är aktiverad eller inte.

order

integer

Känslighetsetikettens ordning.

rank

rank

Känslighetsetikettens rangordning.