Freigeben über


Sensitivity Settings - Create Or Update

Erstellen oder Aktualisieren von Datenschutzeinstellungen für die Ermittlung vertraulicher Daten

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
api-version
query True

string

API-Version für den Vorgang

Anforderungstext

Name Erforderlich Typ Beschreibung
sensitiveInfoTypesIds True

string[]

Liste der IDs ausgewählter vertraulicher Informationstypen.

sensitivityThresholdLabelId

string

Die ID der Vertraulichkeitsschwellenbezeichnung. Jede Bezeichnung mit oder über diesem Rang wird als vertraulich betrachtet.

sensitivityThresholdLabelOrder

number

Die Reihenfolge der Vertraulichkeitsschwellenbezeichnung. Alle Bezeichnungen ab dieser Bestellung werden als vertraulich betrachtet. Bei Festlegung auf -1 wird die Vertraulichkeit durch Bezeichnungen deaktiviert.

Antworten

Name Typ Beschreibung
200 OK

GetSensitivitySettingsResponse

Erfolgreiche Aktualisierung der Vertraulichkeitseinstellungen

Other Status Codes

CloudError

Fehlerantwort mit Beschreibung des Grunds für den Fehler

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

Update sensitivity settings

Sample Request

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"
}

Sample Response

{
  "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"
        }
      ]
    }
  }
}

Definitionen

Name Beschreibung
BuiltInInfoType

Vorkonfigurierte vertraulicher Informationstyp

CloudError

Allgemeine Fehlerantwort für alle Azure Resource Manager-APIs, zur Rückgabe von Fehlerdetails für fehlgeschlagene Vorgänge. (Dies folgt auch dem OData-Fehlerantwortformat.)

CloudErrorBody

Die Fehlerdetails.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

GetSensitivitySettingsResponse

Datenschutzeinstellungen für die Ermittlung vertraulicher Daten

InfoType

Benutzerdefinierter Informationstyp

Label

Vertraulichkeitsbezeichnung für Microsoft Information Protection

MipInformation

Integrierte und benutzerdefinierte Informationstypen, Bezeichnungen und Integrations-status in Microsoft Information Protection.

MipIntegrationStatus

Microsoft Information Protection Integration status

Properties

Eigenschaften der Vertraulichkeitseinstellungen

UpdateSensitivitySettingsRequest

Anforderung zum Aktualisieren der Datenschutzeinstellungen für die Ermittlung vertraulicher Daten

BuiltInInfoType

Vorkonfigurierte vertraulicher Informationstyp

Name Typ Beschreibung
id

string

ID des Infotyps

name

string

Anzeigename des Infotyps

type

string

Kategorie des integrierten Infotyps

CloudError

Allgemeine Fehlerantwort für alle Azure Resource Manager-APIs, zur Rückgabe von Fehlerdetails für fehlgeschlagene Vorgänge. (Dies folgt auch dem OData-Fehlerantwortformat.)

Name Typ Beschreibung
error.additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

error.code

string

Der Fehlercode.

error.details

CloudErrorBody[]

Die Fehlerdetails.

error.message

string

Die Fehlermeldung.

error.target

string

Das Fehlerziel.

CloudErrorBody

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

CloudErrorBody[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

GetSensitivitySettingsResponse

Datenschutzeinstellungen für die Ermittlung vertraulicher Daten

Name Typ Beschreibung
id

string

Die ID der Vertraulichkeitseinstellungen

name

string

Der Name der Vertraulichkeitseinstellungen

properties

Properties

Eigenschaften der Vertraulichkeitseinstellungen

type

string

Typ der Vertraulichkeitseinstellungen

InfoType

Benutzerdefinierter Informationstyp

Name Typ Beschreibung
description

string

Beschreibung des Infotyps

id

string

ID des Infotyps

name

string

Anzeigename des Infotyps

Label

Vertraulichkeitsbezeichnung für Microsoft Information Protection

Name Typ Beschreibung
id

string

Die ID der Bezeichnung

name

string

Der Anzeigename der Bezeichnung

order

number

Bezeichnungen werden nach Vertraulichkeitsstufe sortiert. Je höher die Reihenfolge der Bezeichnung, desto empfindlicher ist sie.

MipInformation

Integrierte und benutzerdefinierte Informationstypen, Bezeichnungen und Integrations-status in Microsoft Information Protection.

Name Typ Beschreibung
builtInInfoTypes

BuiltInInfoType[]

Liste der vorkonfigurierten Typen vertraulicher Informationen

customInfoTypes

InfoType[]

Liste der benutzerdefinierten Informationstypen

labels

Label[]

Liste der Vertraulichkeitsbezeichnungen für den Microsoft-Informationsschutz

mipIntegrationStatus

MipIntegrationStatus

Microsoft Information Protection Integration status

MipIntegrationStatus

Microsoft Information Protection Integration status

Name Typ Beschreibung
Ok

string

noAutoLabelingRules

string

noConsent

string

noMipLabels

string

Properties

Eigenschaften der Vertraulichkeitseinstellungen

Name Typ Beschreibung
mipInformation

MipInformation

Integrierte und benutzerdefinierte Informationstypen, Bezeichnungen und Integrations-status in Microsoft Information Protection.

sensitiveInfoTypesIds

string[]

Liste der IDs ausgewählter vertraulicher Informationstypen.

sensitivityThresholdLabelId

string

Die ID der Vertraulichkeitsschwellenbezeichnung. Jede Bezeichnung mit oder über diesem Rang wird als vertraulich betrachtet.

sensitivityThresholdLabelOrder

number

Die Reihenfolge der Vertraulichkeitsschwellenbezeichnung. Alle Bezeichnungen ab dieser Bestellung werden als vertraulich betrachtet. Bei Festlegung auf -1 wird die Vertraulichkeit durch Bezeichnungen deaktiviert.

UpdateSensitivitySettingsRequest

Anforderung zum Aktualisieren der Datenschutzeinstellungen für die Ermittlung vertraulicher Daten

Name Typ Beschreibung
sensitiveInfoTypesIds

string[]

Liste der IDs ausgewählter vertraulicher Informationstypen.

sensitivityThresholdLabelId

string

Die ID der Vertraulichkeitsschwellenbezeichnung. Jede Bezeichnung mit oder über diesem Rang wird als vertraulich betrachtet.

sensitivityThresholdLabelOrder

number

Die Reihenfolge der Vertraulichkeitsschwellenbezeichnung. Alle Bezeichnungen ab dieser Bestellung werden als vertraulich betrachtet. Bei Festlegung auf -1 wird die Vertraulichkeit durch Bezeichnungen deaktiviert.