Information Protection Policies - List

Servizio:: Defender for Cloud

Versione API:: 2017-08-01-preview

Criteri di protezione delle informazioni di un gruppo di gestione specifico.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
scope	path	True	string	L'ambito della query può essere una sottoscrizione (/subscriptions/0b06d9ea-afe6-4779-bd59-30e5c2d9d13f) o un gruppo di gestione (/providers/Microsoft.Management/managementGroups/mgName).
api-version	query	True	string	Versione dell'API per l'operazione

Risposte

Nome	Tipo	Descrizione
200 OK	InformationProtectionPolicyList	OK
Other Status Codes	CloudError	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Get information protection policies

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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
              }
            ]
          }
        }
      }
    }
  ]
}

Definizioni

Nome	Descrizione
CloudError	Risposta di errore comune per tutte le API di Azure Resource Manager per restituire i dettagli dell'errore per le operazioni non riuscite. Questo segue anche il formato di risposta di errore OData.
CloudErrorBody	Dettagli dell'errore.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
InformationProtectionKeyword	Parola chiave del tipo di informazioni.
InformationProtectionPolicy	Criteri di protezione delle informazioni.
InformationProtectionPolicyList	Risposta ai criteri di protezione delle informazioni.
InformationType	Tipo di informazioni.
rank	Classificazione dell'etichetta di riservatezza.
SensitivityLabel	Etichetta di riservatezza.

CloudError

Oggetto

Risposta di errore comune per tutte le API di Azure Resource Manager per restituire i dettagli dell'errore per le operazioni non riuscite. Questo segue anche il formato di risposta di errore OData.

Nome	Tipo	Descrizione
error.additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
error.code	string	Codice di errore.
error.details	CloudErrorBody[]	Dettagli dell'errore.
error.message	string	Messaggio di errore.
error.target	string	Destinazione dell'errore.

CloudErrorBody

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	CloudErrorBody[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

InformationProtectionKeyword

Oggetto

Parola chiave del tipo di informazioni.

Nome	Tipo	Descrizione
canBeNumeric	boolean	Indica se la parola chiave può essere applicata o meno a tipi numerici.
custom	boolean	Indica se la parola chiave è personalizzata o meno.
excluded	boolean	Indica se la parola chiave è esclusa o meno.
pattern	string	Modello di parola chiave.

InformationProtectionPolicy

Oggetto

Criteri di protezione delle informazioni.

Nome	Tipo	Descrizione
id	string	ID risorsa
name	string	Nome risorsa
properties.informationTypes	<string, InformationType>	Tipi di informazioni di riservatezza.
properties.labels	<string, SensitivityLabel>	Dizionario delle etichette di riservatezza.
properties.lastModifiedUtc	string (date-time)	Descrive l'ora UTC dell'ultima modifica del criterio.
properties.version	string	Descrive la versione dei criteri.
type	string	Tipo di risorsa

InformationProtectionPolicyList

Oggetto

Risposta ai criteri di protezione delle informazioni.

Nome	Tipo	Descrizione
nextLink	string	URI da recuperare la pagina successiva.
value	InformationProtectionPolicy[]	Elenco dei criteri di protezione delle informazioni.

InformationType

Oggetto

Tipo di informazioni.

Nome	Tipo	Descrizione
custom	boolean	Indica se il tipo di informazioni è personalizzato o meno.
description	string	Descrizione del tipo di informazioni.
displayName	string	Nome del tipo di informazioni.
enabled	boolean	Indica se il tipo di informazioni è abilitato o meno.
keywords	InformationProtectionKeyword[]	Parole chiave del tipo di informazioni.
order	integer (int32)	Ordine del tipo di informazioni.
recommendedLabelId	string (uuid)	ID etichetta consigliato da associare a questo tipo di informazioni.

rank

Enumerazione

Classificazione dell'etichetta di riservatezza.

Valore	Descrizione
None
Low
Medium
High
Critical

SensitivityLabel

Oggetto

Etichetta di riservatezza.

Nome	Tipo	Descrizione
description	string	Descrizione dell'etichetta di riservatezza.
displayName	string	Nome dell'etichetta di riservatezza.
enabled	boolean	Indica se l'etichetta è abilitata o meno.
order	integer (int32)	Ordine dell'etichetta di riservatezza.
rank	rank	Classificazione dell'etichetta di riservatezza.

Condividi tramite

Information Protection Policies - List

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Get information protection policies

Esempio di richiesta

Risposta di esempio

Definizioni

CloudError

CloudErrorBody

ErrorAdditionalInfo

InformationProtectionKeyword

InformationProtectionPolicy

InformationProtectionPolicyList

InformationType

rank

SensitivityLabel