Udostępnij za pośrednictwem


Sensitivity Settings - Create Or Update

Tworzenie lub aktualizowanie ustawień poufności danych na potrzeby odnajdywania poufnych danych

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
api-version
query True

string

Wersja interfejsu API dla operacji

Treść żądania

Nazwa Wymagane Typ Opis
sensitiveInfoTypesIds True

string[]

Lista identyfikatorów wybranych typów informacji poufnych.

sensitivityThresholdLabelId

string

Identyfikator etykiety progu poufności. Każda etykieta o lub powyżej tej rangi będzie uznawana za wrażliwą.

sensitivityThresholdLabelOrder

number

Kolejność etykiety progu poufności. Każda etykieta w lub powyżej tej kolejności będzie uznawana za wrażliwą. Jeśli ustawiono wartość -1, ważność według etykiet zostanie wyłączona

Odpowiedzi

Nazwa Typ Opis
200 OK

GetSensitivitySettingsResponse

Powodzenie aktualizacji ustawień poufności

Other Status Codes

CloudError

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

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

Scopes

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

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

Definicje

Nazwa Opis
BuiltInInfoType

Wstępnie skonfigurowany typ informacji poufnych

CloudError

Typowa odpowiedź na błędy dla wszystkich interfejsów API usługi Azure Resource Manager zwraca szczegóły błędu dla operacji, które zakończyły się niepowodzeniem. (Jest to również zgodne z formatem odpowiedzi na błąd OData).

CloudErrorBody

Szczegóły błędu.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

GetSensitivitySettingsResponse

Ustawienia poufności danych na potrzeby odnajdywania poufnych danych

InfoType

Niestandardowy typ informacji zdefiniowany przez użytkownika

Label

Etykieta poufności ochrony informacji firmy Microsoft

MipInformation

Wbudowane i niestandardowe typy informacji, etykiety i stan integracji usługi Microsoft Information Protection.

MipIntegrationStatus

Stan integracji z usługą Microsoft Information Protection

Properties

Właściwości ustawień poufności

UpdateSensitivitySettingsRequest

Żądanie zaktualizowania ustawień poufności danych na potrzeby odnajdywania poufnych danych

BuiltInInfoType

Wstępnie skonfigurowany typ informacji poufnych

Nazwa Typ Opis
id

string

Identyfikator typu informacji

name

string

Nazwa wyświetlana typu informacji

type

string

Kategoria typu informacji wbudowanych

CloudError

Typowa odpowiedź na błędy dla wszystkich interfejsów API usługi Azure Resource Manager zwraca szczegóły błędu dla operacji, które zakończyły się niepowodzeniem. (Jest to również zgodne z formatem odpowiedzi na błąd OData).

Nazwa Typ Opis
error.additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

error.code

string

Kod błędu.

error.details

CloudErrorBody[]

Szczegóły błędu.

error.message

string

Komunikat o błędzie.

error.target

string

Element docelowy błędu.

CloudErrorBody

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

CloudErrorBody[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

GetSensitivitySettingsResponse

Ustawienia poufności danych na potrzeby odnajdywania poufnych danych

Nazwa Typ Opis
id

string

Identyfikator ustawień poufności

name

string

Nazwa ustawień poufności

properties

Properties

Właściwości ustawień poufności

type

string

Typ ustawień poufności

InfoType

Niestandardowy typ informacji zdefiniowany przez użytkownika

Nazwa Typ Opis
description

string

Opis typu informacji

id

string

Identyfikator typu informacji

name

string

Nazwa wyświetlana typu informacji

Label

Etykieta poufności ochrony informacji firmy Microsoft

Nazwa Typ Opis
id

string

Identyfikator etykiety

name

string

Nazwa wyświetlana etykiety

order

number

Etykiety są uporządkowane według poziomu poufności. Im wyższa kolejność etykiety, tym bardziej jest wrażliwa.

MipInformation

Wbudowane i niestandardowe typy informacji, etykiety i stan integracji usługi Microsoft Information Protection.

Nazwa Typ Opis
builtInInfoTypes

BuiltInInfoType[]

Lista wstępnie skonfigurowanych typów informacji poufnych

customInfoTypes

InfoType[]

Lista niestandardowych typów informacji zdefiniowanych przez użytkownika

labels

Label[]

Lista etykiet poufności ochrony informacji firmy Microsoft

mipIntegrationStatus

MipIntegrationStatus

Stan integracji z usługą Microsoft Information Protection

MipIntegrationStatus

Stan integracji z usługą Microsoft Information Protection

Nazwa Typ Opis
Ok

string

noAutoLabelingRules

string

noConsent

string

noMipLabels

string

Properties

Właściwości ustawień poufności

Nazwa Typ Opis
mipInformation

MipInformation

Wbudowane i niestandardowe typy informacji, etykiety i stan integracji usługi Microsoft Information Protection.

sensitiveInfoTypesIds

string[]

Lista identyfikatorów wybranych typów informacji poufnych.

sensitivityThresholdLabelId

string

Identyfikator etykiety progu poufności. Każda etykieta o lub powyżej tej rangi będzie uznawana za wrażliwą.

sensitivityThresholdLabelOrder

number

Kolejność etykiety progu poufności. Każda etykieta w lub powyżej tej kolejności będzie uznawana za wrażliwą. Jeśli ustawiono wartość -1, ważność według etykiet zostanie wyłączona

UpdateSensitivitySettingsRequest

Żądanie zaktualizowania ustawień poufności danych na potrzeby odnajdywania poufnych danych

Nazwa Typ Opis
sensitiveInfoTypesIds

string[]

Lista identyfikatorów wybranych typów informacji poufnych.

sensitivityThresholdLabelId

string

Identyfikator etykiety progu poufności. Każda etykieta o lub powyżej tej rangi będzie uznawana za wrażliwą.

sensitivityThresholdLabelOrder

number

Kolejność etykiety progu poufności. Każda etykieta w lub powyżej tej kolejności będzie uznawana za wrażliwą. Jeśli ustawiono wartość -1, ważność według etykiet zostanie wyłączona