Condividi tramite


Sensitivity Settings - Create Or Update

Creare o aggiornare le impostazioni di riservatezza dei dati per l'individuazione dei dati sensibili

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
api-version
query True

string

Versione DELL'API per l'operazione

Corpo della richiesta

Nome Necessario Tipo Descrizione
sensitiveInfoTypesIds True

string[]

Elenco degli ID dei tipi di informazioni sensibili selezionati.

sensitivityThresholdLabelId

string

ID dell'etichetta soglia di riservatezza. Qualsiasi etichetta in corrispondenza o superiore a questa classificazione verrà considerata sensibile.

sensitivityThresholdLabelOrder

number

Ordine dell'etichetta soglia di riservatezza. Qualsiasi etichetta in corrispondenza o superiore di questo ordine verrà considerata sensibile. Se impostato su -1, la riservatezza per etichette viene disattivata

Risposte

Nome Tipo Descrizione
200 OK

GetSensitivitySettingsResponse

Esito positivo dell'aggiornamento delle impostazioni di riservatezza

Other Status Codes

CloudError

Risposta di errore che descrive perché l'operazione non è riuscita

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

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

Scopes

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

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

Definizioni

Nome Descrizione
BuiltInInfoType

Tipo di informazioni riservate preconfigurato

CloudError

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

CloudErrorBody

Dettagli dell'errore.

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

GetSensitivitySettingsResponse

Impostazioni di riservatezza dei dati per l'individuazione dei dati sensibili

InfoType

Tipo di informazioni definito dall'utente personalizzato

Label

Etichetta di riservatezza della protezione delle informazioni Microsoft

MipInformation

Microsoft Information Protection predefinito e tipi di informazioni personalizzate, etichette e stato di integrazione.

MipIntegrationStatus

Stato di integrazione di Microsoft Information Protection

Properties

Proprietà delle impostazioni di riservatezza

UpdateSensitivitySettingsRequest

Richiesta di aggiornamento delle impostazioni di riservatezza dei dati per l'individuazione dei dati sensibili

BuiltInInfoType

Tipo di informazioni riservate preconfigurato

Nome Tipo Descrizione
id

string

ID del tipo di info

name

string

Nome visualizzato del tipo di informazioni

type

string

Categoria del tipo di informazioni predefinite

CloudError

Risposta di errore comune per tutte le API di Resource Manager di Azure per restituire i dettagli degli errori per le operazioni non riuscite. Questo segue anche il formato di risposta dell'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

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

Informazioni aggiuntive sulla gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

GetSensitivitySettingsResponse

Impostazioni di riservatezza dei dati per l'individuazione dei dati sensibili

Nome Tipo Descrizione
id

string

ID delle impostazioni di riservatezza

name

string

Nome delle impostazioni di riservatezza

properties

Properties

Proprietà delle impostazioni di riservatezza

type

string

Tipo delle impostazioni di riservatezza

InfoType

Tipo di informazioni definito dall'utente personalizzato

Nome Tipo Descrizione
description

string

Descrizione del tipo di info

id

string

ID del tipo di info

name

string

Nome visualizzato del tipo di informazioni

Label

Etichetta di riservatezza della protezione delle informazioni Microsoft

Nome Tipo Descrizione
id

string

ID dell'etichetta

name

string

Nome visualizzato dell'etichetta

order

number

Le etichette vengono ordinate per livello di riservatezza. Maggiore è l'ordine dell'etichetta, più sensibile è.

MipInformation

Microsoft Information Protection predefinito e tipi di informazioni personalizzate, etichette e stato di integrazione.

Nome Tipo Descrizione
builtInInfoTypes

BuiltInInfoType[]

Elenco dei tipi di informazioni sensibili preconfigurati

customInfoTypes

InfoType[]

Elenco dei tipi di informazioni definiti dall'utente personalizzati

labels

Label[]

Elenco delle etichette di riservatezza di Microsoft Information Protection

mipIntegrationStatus

MipIntegrationStatus

Stato di integrazione di Microsoft Information Protection

MipIntegrationStatus

Stato di integrazione di Microsoft Information Protection

Nome Tipo Descrizione
Ok

string

noAutoLabelingRules

string

noConsent

string

noMipLabels

string

Properties

Proprietà delle impostazioni di riservatezza

Nome Tipo Descrizione
mipInformation

MipInformation

Microsoft Information Protection predefinito e tipi di informazioni personalizzate, etichette e stato di integrazione.

sensitiveInfoTypesIds

string[]

Elenco degli ID dei tipi di informazioni sensibili selezionati.

sensitivityThresholdLabelId

string

ID dell'etichetta soglia di riservatezza. Qualsiasi etichetta in corrispondenza o superiore a questa classificazione verrà considerata sensibile.

sensitivityThresholdLabelOrder

number

Ordine dell'etichetta soglia di riservatezza. Qualsiasi etichetta in corrispondenza o superiore di questo ordine verrà considerata sensibile. Se impostato su -1, la riservatezza per etichette viene disattivata

UpdateSensitivitySettingsRequest

Richiesta di aggiornamento delle impostazioni di riservatezza dei dati per l'individuazione dei dati sensibili

Nome Tipo Descrizione
sensitiveInfoTypesIds

string[]

Elenco degli ID dei tipi di informazioni sensibili selezionati.

sensitivityThresholdLabelId

string

ID dell'etichetta soglia di riservatezza. Qualsiasi etichetta in corrispondenza o superiore a questa classificazione verrà considerata sensibile.

sensitivityThresholdLabelOrder

number

Ordine dell'etichetta soglia di riservatezza. Qualsiasi etichetta in corrispondenza o superiore di questo ordine verrà considerata sensibile. Se impostato su -1, la riservatezza per etichette viene disattivata