Information Protection Policies - List

Service:: Defender for Cloud

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

Stratégies de protection des informations d’un groupe d’administration spécifique.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
scope	path	True	string	L’étendue de la requête peut être un abonnement (/subscriptions/0b06d9ea-afe6-4779-bd59-30e5c2d9d13f) ou un groupe d’administration (/providers/Microsoft.Management/managementGroups/mgName).
api-version	query	True	string	Version de l’API pour l’opération

Réponses

Nom	Type	Description
200 OK	InformationProtectionPolicyList	D’ACCORD
Other Status Codes	CloudError	Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

Get information protection policies

Exemple de requête

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

Exemple de réponse

Code d’état:: 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
              }
            ]
          }
        }
      }
    }
  ]
}

Définitions

Nom	Description
CloudError	Réponse d’erreur courante pour toutes les API Azure Resource Manager afin de retourner les détails de l’erreur pour les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.).
CloudErrorBody	Détail de l’erreur.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
InformationProtectionKeyword	Mot clé de type d’informations.
InformationProtectionPolicy	Stratégie de protection des informations.
InformationProtectionPolicyList	Réponse des stratégies de protection des informations.
InformationType	Type d’informations.
rank	Rang de l’étiquette de confidentialité.
SensitivityLabel	Étiquette de confidentialité.

CloudError

Objet

Réponse d’erreur courante pour toutes les API Azure Resource Manager afin de retourner les détails de l’erreur pour les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.).

Nom	Type	Description
error.additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
error.code	string	Code d’erreur.
error.details	CloudErrorBody[]	Détails de l’erreur.
error.message	string	Message d’erreur.
error.target	string	Cible d’erreur.

CloudErrorBody

Objet

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	CloudErrorBody[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

InformationProtectionKeyword

Objet

Mot clé de type d’informations.

Nom	Type	Description
canBeNumeric	boolean	Indique si le mot clé peut être appliqué sur des types numériques ou non.
custom	boolean	Indique si le mot clé est personnalisé ou non.
excluded	boolean	Indique si le mot clé est exclu ou non.
pattern	string	Modèle de mot clé.

InformationProtectionPolicy

Objet

Stratégie de protection des informations.

Nom	Type	Description
id	string	ID de ressource
name	string	Nom de la ressource
properties.informationTypes	<string, InformationType>	Types d’informations de confidentialité.
properties.labels	<string, SensitivityLabel>	Dictionnaire d’étiquettes de confidentialité.
properties.lastModifiedUtc	string (date-time)	Décrit la dernière heure UTC de la modification de la stratégie.
properties.version	string	Décrit la version de la stratégie.
type	string	Type de ressource

InformationProtectionPolicyList

Objet

Réponse des stratégies de protection des informations.

Nom	Type	Description
nextLink	string	URI permettant d’extraire la page suivante.
value	InformationProtectionPolicy[]	Liste des stratégies de protection des informations.

InformationType

Objet

Type d’informations.

Nom	Type	Description
custom	boolean	Indique si le type d’informations est personnalisé ou non.
description	string	Description du type d’informations.
displayName	string	Nom du type d’informations.
enabled	boolean	Indique si le type d’informations est activé ou non.
keywords	InformationProtectionKeyword[]	Mots clés de type d’informations.
order	integer (int32)	Ordre du type d’informations.
recommendedLabelId	string (uuid)	ID d’étiquette recommandé à associer à ce type d’informations.

rank

Énumération

Rang de l’étiquette de confidentialité.

Valeur	Description
None
Low
Medium
High
Critical

SensitivityLabel

Objet

Étiquette de confidentialité.

Nom	Type	Description
description	string	Description de l’étiquette de confidentialité.
displayName	string	Nom de l’étiquette de confidentialité.
enabled	boolean	Indique si l’étiquette est activée ou non.
order	integer (int32)	Ordre de l’étiquette de confidentialité.
rank	rank	Rang de l’étiquette de confidentialité.

Partager via

Information Protection Policies - List

Paramètres URI

Réponses

Sécurité

azure_auth

Étendues

Exemples

Get information protection policies

Exemple de requête

Exemple de réponse

Définitions

CloudError

CloudErrorBody

ErrorAdditionalInfo

InformationProtectionKeyword

InformationProtectionPolicy

InformationProtectionPolicyList

InformationType

rank

SensitivityLabel