Information Protection Policies - List

Dienst:: Defender for Cloud

API-Version:: 2017-08-01-preview

Informationsschutzrichtlinien einer bestimmten Verwaltungsgruppe.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
scope	path	True	string	Der Umfang der Abfrage kann abonnement (/subscriptions/0b06d9ea-afe6-4779-bd59-30e5c2d9d13f) oder Verwaltungsgruppe (/providers/Microsoft.Management/managementGroups/mgName) sein.
api-version	query	True	string	API-Version für den Vorgang

Antworten

Name	Typ	Beschreibung
200 OK	InformationProtectionPolicyList	OKAY
Other Status Codes	CloudError	Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

Get information protection policies

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 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
              }
            ]
          }
        }
      }
    }
  ]
}

Definitionen

Name	Beschreibung
CloudError	Häufige Fehlerantwort für alle Azure Resource Manager-APIs, um Fehlerdetails für fehlgeschlagene Vorgänge zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)
CloudErrorBody	Das Fehlerdetails.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
InformationProtectionKeyword	Das Schlüsselwort für den Informationstyp.
InformationProtectionPolicy	Richtlinie zum Schutz von Informationen.
InformationProtectionPolicyList	Reaktion auf Informationsschutzrichtlinien.
InformationType	Der Informationstyp.
rank	Der Rang der Vertraulichkeitsbezeichnung.
SensitivityLabel	Die Vertraulichkeitsbezeichnung.

CloudError

Objekt

Häufige Fehlerantwort für alle Azure Resource Manager-APIs, um Fehlerdetails für fehlgeschlagene Vorgänge zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)

Name	Typ	Beschreibung
error.additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
error.code	string	Der Fehlercode.
error.details	CloudErrorBody[]	Die Fehlerdetails.
error.message	string	Die Fehlermeldung.
error.target	string	Das Fehlerziel.

CloudErrorBody

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	CloudErrorBody[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

InformationProtectionKeyword

Objekt

Das Schlüsselwort für den Informationstyp.

Name	Typ	Beschreibung
canBeNumeric	boolean	Gibt an, ob das Schlüsselwort auf numerische Typen angewendet werden kann.
custom	boolean	Gibt an, ob das Schlüsselwort benutzerdefiniert ist oder nicht.
excluded	boolean	Gibt an, ob das Schlüsselwort ausgeschlossen ist oder nicht.
pattern	string	Das Schlüsselwortmuster.

InformationProtectionPolicy

Objekt

Richtlinie zum Schutz von Informationen.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Ressourcenname
properties.informationTypes	<string, InformationType>	Die Vertraulichkeitsinformationstypen.
properties.labels	<string, SensitivityLabel>	Wörterbuch mit Vertraulichkeitsbezeichnungen.
properties.lastModifiedUtc	string (date-time)	Beschreibt die letzte UTC-Zeit, zu der die Richtlinie geändert wurde.
properties.version	string	Beschreibt die Version der Richtlinie.
type	string	Ressourcentyp

InformationProtectionPolicyList

Objekt

Reaktion auf Informationsschutzrichtlinien.

Name	Typ	Beschreibung
nextLink	string	Der URI zum Abrufen der nächsten Seite.
value	InformationProtectionPolicy[]	Liste der Informationsschutzrichtlinien.

InformationType

Objekt

Der Informationstyp.

Name	Typ	Beschreibung
custom	boolean	Gibt an, ob der Informationstyp benutzerdefiniert ist oder nicht.
description	string	Die Beschreibung des Informationstyps.
displayName	string	Der Name des Informationstyps.
enabled	boolean	Gibt an, ob der Informationstyp aktiviert ist oder nicht.
keywords	InformationProtectionKeyword[]	Die Schlüsselwörter des Informationstyps.
order	integer (int32)	Die Reihenfolge des Informationstyps.
recommendedLabelId	string (uuid)	Die empfohlene Bezeichnungs-ID, die diesem Informationstyp zugeordnet werden soll.

rank

Enumeration

Der Rang der Vertraulichkeitsbezeichnung.

Wert	Beschreibung
None
Low
Medium
High
Critical

SensitivityLabel

Objekt

Die Vertraulichkeitsbezeichnung.

Name	Typ	Beschreibung
description	string	Die Beschreibung der Vertraulichkeitsbezeichnung.
displayName	string	Der Name der Vertraulichkeitsbezeichnung.
enabled	boolean	Gibt an, ob die Bezeichnung aktiviert ist.
order	integer (int32)	Die Reihenfolge der Vertraulichkeitsbezeichnung.
rank	rank	Der Rang der Vertraulichkeitsbezeichnung.

Freigeben über

Information Protection Policies - List

URI-Parameter

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

Get information protection policies

Beispielanforderung

Beispiel für eine Antwort

Definitionen

CloudError

CloudErrorBody

ErrorAdditionalInfo

InformationProtectionKeyword

InformationProtectionPolicy

InformationProtectionPolicyList

InformationType

rank

SensitivityLabel