Information Protection Policies - List

Tjänst:: Defender for Cloud

API-versionen:: 2017-08-01-preview

Informationsskyddsprinciper för en specifik hanteringsgrupp.

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

URI-parametrar

Namn	I	Krävs	Typ	Beskrivning
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

Svaren

Namn	Typ	Beskrivning
200 OK	InformationProtectionPolicyList	OKEJ
Other Status Codes	CloudError	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde

Typ: oauth2
Rinna: implicit
Auktorisations-URL: https://login.microsoftonline.com/common/oauth2/authorize

Scope

Namn	Beskrivning
user_impersonation	personifiera ditt användarkonto

Exempel

Get information protection policies

Exempelförfrågan

HTTP

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

Exempelsvar

Statuskod:: 200

{
  "value": [
    {
      "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
              }
            ]
          },
          "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
              }
            ]
          }
        }
      }
    },
    {
      "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
              }
            ]
          }
        }
      }
    }
  ]
}

Definitioner

Namn	Beskrivning
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.
InformationProtectionPolicyList	Svar på informationsskyddsprinciper.
InformationType	Informationstypen.
rank	Känslighetsetikettens rangordning.
SensitivityLabel	Känslighetsetiketten.

CloudError

Objekt

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.).

Namn	Typ	Beskrivning
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

Objekt

Felinformationen.

Namn	Typ	Beskrivning
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	CloudErrorBody[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Namn	Typ	Beskrivning
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

InformationProtectionKeyword

Objekt

Nyckelordet informationstyp.

Namn	Typ	Beskrivning
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

Objekt

Informationsskyddsprincip.

Namn	Typ	Beskrivning
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 (date-time)	Beskriver den senaste UTC-tiden då principen ändrades.
properties.version	string	Beskriver versionen av principen.
type	string	Resurstyp

InformationProtectionPolicyList

Objekt

Svar på informationsskyddsprinciper.

Namn	Typ	Beskrivning
nextLink	string	URI:n för att hämta nästa sida.
value	InformationProtectionPolicy[]	Lista över informationsskyddsprinciper.

InformationType

Objekt

Informationstypen.

Namn	Typ	Beskrivning
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 (int32)	Ordningen på informationstypen.
recommendedLabelId	string (uuid)	Det rekommenderade etikett-ID som ska associeras med den här informationstypen.

rank

Uppräkning

Känslighetsetikettens rangordning.

Värde	Beskrivning
None
Low
Medium
High
Critical

SensitivityLabel

Objekt

Känslighetsetiketten.

Namn	Typ	Beskrivning
description	string	Beskrivningen av känslighetsetiketten.
displayName	string	Namnet på känslighetsetiketten.
enabled	boolean	Anger om etiketten är aktiverad eller inte.
order	integer (int32)	Känslighetsetikettens ordning.
rank	rank	Känslighetsetikettens rangordning.

Dela via

Information Protection Policies - List

URI-parametrar

Svaren

Säkerhet

azure_auth

Scope

Exempel

Get information protection policies

Exempelförfrågan

Exempelsvar

Definitioner

CloudError

CloudErrorBody

ErrorAdditionalInfo

InformationProtectionKeyword

InformationProtectionPolicy

InformationProtectionPolicyList

InformationType

rank

SensitivityLabel