Compartir a través de


Sensitivity Settings - Create Or Update

Crear o actualizar la configuración de confidencialidad de datos para la detección de datos confidenciales

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
api-version
query True

string

Versión de API para la operación

Cuerpo de la solicitud

Nombre Requerido Tipo Description
sensitiveInfoTypesIds True

string[]

Lista de los identificadores de los tipos de información confidencial seleccionados.

sensitivityThresholdLabelId

string

Identificador de la etiqueta de umbral de confidencialidad. Cualquier etiqueta en o por encima de esta clasificación se considerará confidencial.

sensitivityThresholdLabelOrder

number

Orden de la etiqueta de umbral de confidencialidad. Cualquier etiqueta en o por encima de este pedido se considerará confidencial. Si se establece en -1, la confidencialidad por etiquetas está desactivada.

Respuestas

Nombre Tipo Description
200 OK

GetSensitivitySettingsResponse

Correcto de la actualización de la configuración de confidencialidad

Other Status Codes

CloudError

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

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

Scopes

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

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

Definiciones

Nombre Description
BuiltInInfoType

Tipo de información confidencial preconfigurada

CloudError

Respuesta de error común para todas las API de Azure Resource Manager para devolver los detalles de error de las operaciones con errores. (Esto también sigue el formato de respuesta de error de OData).

CloudErrorBody

Detalle del error.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

GetSensitivitySettingsResponse

Configuración de confidencialidad de datos para la detección de datos confidenciales

InfoType

Tipo de información personalizado definido por el usuario

Label

Etiqueta de confidencialidad de Microsoft Information Protection

MipInformation

Tipos de información, etiquetas y estado de integración integrados y personalizados de Microsoft Information Protection.

MipIntegrationStatus

Estado de integración de Microsoft Information Protection

Properties

Propiedades de configuración de confidencialidad

UpdateSensitivitySettingsRequest

Solicitud para actualizar la configuración de confidencialidad de datos para la detección de datos confidenciales

BuiltInInfoType

Tipo de información confidencial preconfigurada

Nombre Tipo Description
id

string

Identificador del tipo de información

name

string

Nombre para mostrar del tipo de información

type

string

Categoría del tipo de información integrado

CloudError

Respuesta de error común para todas las API de Azure Resource Manager para devolver los detalles de error de las operaciones con errores. (Esto también sigue el formato de respuesta de error de OData).

Nombre Tipo Description
error.additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

error.code

string

Código de error.

error.details

CloudErrorBody[]

Los detalles del error.

error.message

string

El mensaje de error.

error.target

string

Destino del error.

CloudErrorBody

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

CloudErrorBody[]

Los detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

GetSensitivitySettingsResponse

Configuración de confidencialidad de datos para la detección de datos confidenciales

Nombre Tipo Description
id

string

Identificador de la configuración de confidencialidad

name

string

Nombre de la configuración de confidencialidad

properties

Properties

Propiedades de configuración de confidencialidad

type

string

Tipo de la configuración de confidencialidad

InfoType

Tipo de información personalizado definido por el usuario

Nombre Tipo Description
description

string

Descripción del tipo de información

id

string

Identificador del tipo de información

name

string

Nombre para mostrar del tipo de información

Label

Etiqueta de confidencialidad de Microsoft Information Protection

Nombre Tipo Description
id

string

Identificador de la etiqueta

name

string

Nombre para mostrar de la etiqueta

order

number

Las etiquetas se ordenan por nivel de confidencialidad. Cuanto mayor sea el orden de la etiqueta, más sensible es.

MipInformation

Tipos de información, etiquetas y estado de integración integrados y personalizados de Microsoft Information Protection.

Nombre Tipo Description
builtInInfoTypes

BuiltInInfoType[]

Lista de tipos de información confidencial preconfigurados

customInfoTypes

InfoType[]

Lista de tipos de información personalizados definidos por el usuario

labels

Label[]

Lista de etiquetas de confidencialidad de Microsoft Information Protection

mipIntegrationStatus

MipIntegrationStatus

Estado de integración de Microsoft Information Protection

MipIntegrationStatus

Estado de integración de Microsoft Information Protection

Nombre Tipo Description
Ok

string

noAutoLabelingRules

string

noConsent

string

noMipLabels

string

Properties

Propiedades de configuración de confidencialidad

Nombre Tipo Description
mipInformation

MipInformation

Tipos de información, etiquetas y estado de integración integrados y personalizados de Microsoft Information Protection.

sensitiveInfoTypesIds

string[]

Lista de los identificadores de los tipos de información confidencial seleccionados.

sensitivityThresholdLabelId

string

Identificador de la etiqueta de umbral de confidencialidad. Cualquier etiqueta en o por encima de esta clasificación se considerará confidencial.

sensitivityThresholdLabelOrder

number

Orden de la etiqueta de umbral de confidencialidad. Cualquier etiqueta en o por encima de este pedido se considerará confidencial. Si se establece en -1, la confidencialidad por etiquetas está desactivada.

UpdateSensitivitySettingsRequest

Solicitud para actualizar la configuración de confidencialidad de datos para la detección de datos confidenciales

Nombre Tipo Description
sensitiveInfoTypesIds

string[]

Lista de los identificadores de los tipos de información confidencial seleccionados.

sensitivityThresholdLabelId

string

Identificador de la etiqueta de umbral de confidencialidad. Cualquier etiqueta en o por encima de esta clasificación se considerará confidencial.

sensitivityThresholdLabelOrder

number

Orden de la etiqueta de umbral de confidencialidad. Cualquier etiqueta en o por encima de este pedido se considerará confidencial. Si se establece en -1, la confidencialidad por etiquetas está desactivada.