Sensitivity Settings - Create Or Update

Service:: Defender for Cloud

Version d'API:: 2023-02-15-preview

Créer ou mettre à jour des paramètres de confidentialité des données pour la découverte de données sensibles

PUT https://management.azure.com/providers/Microsoft.Security/sensitivitySettings/current?api-version=2023-02-15-preview

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
api-version	query	True	string	Version de l’API pour l’opération

Corps de la demande

Nom	Obligatoire	Type	Description
sensitiveInfoTypesIds	True	string[] (uuid)	Liste des ID des types d’informations sensibles sélectionnés.
sensitivityThresholdLabelId		string (uuid)	ID de l’étiquette de seuil de confidentialité. Toute étiquette au ou au-dessus de ce rang sera considérée comme sensible.
sensitivityThresholdLabelOrder		number	Ordre de l’étiquette de seuil de confidentialité. Toute étiquette au ou au-dessus de cet ordre sera considérée comme sensible. Si la valeur est -1, la sensibilité par étiquettes est désactivée

Réponses

Nom	Type	Description
200 OK	GetSensitivitySettingsResponse	Réussite de la mise à jour des paramètres de confidentialité
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

Update sensitivity settings

Exemple de requête

HTTP

PUT https://management.azure.com/providers/Microsoft.Security/sensitivitySettings/current?api-version=2023-02-15-preview

{
  "sensitiveInfoTypesIds": [
    "f2f8a7a1-28c0-404b-9ab4-30a0a7af18cb",
    "b452f22b-f87d-4f48-8490-ecf0873325b5",
    "d59ee8b6-2618-404b-a5e7-aa377cd67543"
  ],
  "sensitivityThresholdLabelOrder": 2,
  "sensitivityThresholdLabelId": "f2f8a7a1-28c0-404b-9ab4-30a0a7af18cb"
}

Exemple de réponse

Code d’état:: 200

{
  "id": "/providers/Microsoft.Security/sensitivitySettings",
  "name": "current",
  "type": "Microsoft.Security/sensitivitySettings",
  "properties": {
    "sensitiveInfoTypesIds": [
      "a98fde82-45b6-4b2c-afd0-ad579cd9f826",
      "4d0d3eb6-619f-4c8c-810c-c16150c95278",
      "0e9b3178-9678-47dd-a509-37222ca96b42",
      "c5f9b9a1-2b9a-4a3a-8c5b-1f3d1d9d9c9b"
    ],
    "sensitivityThresholdLabelOrder": 2,
    "mipInformation": {
      "mipIntegrationStatus": "Ok",
      "labels": [
        {
          "name": "Public",
          "id": "fdfb5435-124d-4651-a889-a4210fec6a77",
          "order": 0
        },
        {
          "name": "Confidential",
          "id": "4c5447ec-f7f3-4345-a160-6a5850f2bf0c",
          "order": 1
        },
        {
          "name": "Highly Confidential",
          "id": "f38ac75c-f42a-4c89-aa37-9c4e74101414",
          "order": 2
        }
      ],
      "customInfoTypes": [
        {
          "name": "User created custom info type 1",
          "id": "c5f9b9a1-2b9a-4a3a-8c5b-1f3d1d9d9c9b",
          "description": "Custom info type description"
        },
        {
          "name": "User created custom info type 2",
          "id": "a4fee2b6-5618-404b-a5e7-aa377cd67543",
          "description": "Custom info type description"
        },
        {
          "name": "User created custom info type 3",
          "id": "a355f11e-f87d-4f48-8490-ecf0873325b5",
          "description": "Custom info type description"
        }
      ],
      "builtInInfoTypes": [
        {
          "name": "Http Authorization Header",
          "type": "Credentials",
          "id": "4d0d3eb6-619f-4c8c-810c-c16150c95278"
        },
        {
          "name": "User Login Credentials",
          "type": "Credentials",
          "id": "a98fde82-45b6-4b2c-afd0-ad579cd9f826"
        },
        {
          "name": "Credit card number",
          "type": "Finance",
          "id": "50842eb7-edc8-4019-85dd-5a5c1f2bb085"
        },
        {
          "name": "EU debit card number",
          "type": "Finance",
          "id": "0e9b3178-9678-47dd-a509-37222ca96b42"
        }
      ]
    }
  }
}

Définitions

Nom	Description
BuiltInInfoType	Type d’informations sensibles préconfigurées
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.
GetSensitivitySettingsResponse	Paramètres de confidentialité des données pour la découverte de données sensibles
InfoType	Type d’informations personnalisé défini par l’utilisateur
Label	Étiquette de confidentialité de la protection des informations Microsoft
MipInformation	Protection des informations Microsoft intégrée et personnalisée, types d’informations, étiquettes et état d’intégration.
MipIntegrationStatus	État de l’intégration de la protection des informations Microsoft
Properties	Propriétés des paramètres de confidentialité
UpdateSensitivitySettingsRequest	Demande de mise à jour des paramètres de confidentialité des données pour la découverte de données sensibles

BuiltInInfoType

Objet

Type d’informations sensibles préconfigurées

Nom	Type	Description
id	string (uuid)	ID du type d’informations
name	string	Nom complet du type d’informations
type	string	Catégorie du type d’informations intégré

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.

GetSensitivitySettingsResponse

Objet

Paramètres de confidentialité des données pour la découverte de données sensibles

Nom	Type	Description
id	string	ID des paramètres de confidentialité
name	string	Nom des paramètres de confidentialité
properties	Properties	Propriétés des paramètres de confidentialité
type	string	Type des paramètres de confidentialité

InfoType

Objet

Type d’informations personnalisé défini par l’utilisateur

Nom	Type	Description
description	string	Description du type d’informations
id	string (uuid)	ID du type d’informations
name	string	Nom complet du type d’informations

Label

Objet

Étiquette de confidentialité de la protection des informations Microsoft

Nom	Type	Description
id	string (uuid)	ID de l’étiquette
name	string	Nom complet de l’étiquette
order	number	Les étiquettes sont classées par niveau de confidentialité. Plus l’ordre de l’étiquette est élevé, plus il est sensible.

MipInformation

Objet

Protection des informations Microsoft intégrée et personnalisée, types d’informations, étiquettes et état d’intégration.

Nom	Type	Description
builtInInfoTypes	BuiltInInfoType[]	Liste des types d’informations sensibles préconfigurés
customInfoTypes	InfoType[]	Liste des types d’informations personnalisés définis par l’utilisateur
labels	Label[]	Liste des étiquettes de confidentialité de la protection des informations Microsoft
mipIntegrationStatus	MipIntegrationStatus	État de l’intégration de la protection des informations Microsoft

MipIntegrationStatus

Énumération

État de l’intégration de la protection des informations Microsoft

Valeur	Description
Ok
noConsent
noAutoLabelingRules
noMipLabels

Properties

Objet

Propriétés des paramètres de confidentialité

Nom	Type	Description
mipInformation	MipInformation	Protection des informations Microsoft intégrée et personnalisée, types d’informations, étiquettes et état d’intégration.
sensitiveInfoTypesIds	string[] (uuid)	Liste des ID des types d’informations sensibles sélectionnés.
sensitivityThresholdLabelId	string (uuid)	ID de l’étiquette de seuil de confidentialité. Toute étiquette au ou au-dessus de ce rang sera considérée comme sensible.
sensitivityThresholdLabelOrder	number	Ordre de l’étiquette de seuil de confidentialité. Toute étiquette au ou au-dessus de cet ordre sera considérée comme sensible. Si la valeur est -1, la sensibilité par étiquettes est désactivée

UpdateSensitivitySettingsRequest

Objet

Demande de mise à jour des paramètres de confidentialité des données pour la découverte de données sensibles

Nom	Type	Description
sensitiveInfoTypesIds	string[] (uuid)	Liste des ID des types d’informations sensibles sélectionnés.
sensitivityThresholdLabelId	string (uuid)	ID de l’étiquette de seuil de confidentialité. Toute étiquette au ou au-dessus de ce rang sera considérée comme sensible.
sensitivityThresholdLabelOrder	number	Ordre de l’étiquette de seuil de confidentialité. Toute étiquette au ou au-dessus de cet ordre sera considérée comme sensible. Si la valeur est -1, la sensibilité par étiquettes est désactivée

Partager via

Sensitivity Settings - Create Or Update

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

Update sensitivity settings

Exemple de requête

Exemple de réponse

Définitions

BuiltInInfoType

CloudError

CloudErrorBody

ErrorAdditionalInfo

GetSensitivitySettingsResponse

InfoType

Label

MipInformation

MipIntegrationStatus

Properties

UpdateSensitivitySettingsRequest