Sensitivity Settings - Create Or Update

Layanan:: Defender for Cloud

Versi API:: 2023-02-15-preview

Membuat atau memperbarui pengaturan sensitivitas data untuk penemuan data sensitif

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
api-version	query	True	string	Versi API untuk operasi

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
sensitiveInfoTypesIds	True	string[] (uuid)	Daftar ID jenis info sensitif yang dipilih.
sensitivityThresholdLabelId		string (uuid)	Id label ambang sensitivitas. Label apa pun di atau di atas peringkat ini akan dianggap sensitif.
sensitivityThresholdLabelOrder		number	Urutan label ambang sensitivitas. Label apa pun pada atau di atas urutan ini akan dianggap sensitif. Jika diatur ke -1, sensitivitas menurut label dinonaktifkan

Respons

Nama	Jenis	Deskripsi
200 OK	GetSensitivitySettingsResponse	Keberhasilan pembaruan pengaturan sensitivitas
Other Status Codes	CloudError	Respons kesalahan yang menjelaskan mengapa operasi gagal

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

Update sensitivity settings

Permintaan sampel

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

Respon sampel

Kode status:: 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"
        }
      ]
    }
  }
}

Definisi

Nama	Deskripsi
BuiltInInfoType	Jenis informasi sensitif yang telah dikonfigurasi sebelumnya
CloudError	Respons kesalahan umum untuk semua API Azure Resource Manager untuk mengembalikan detail kesalahan untuk operasi yang gagal. (Ini juga mengikuti format respons kesalahan OData.).
CloudErrorBody	Detail kesalahan.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
GetSensitivitySettingsResponse	Pengaturan sensitivitas data untuk penemuan data sensitif
InfoType	Jenis informasi kustom yang ditentukan pengguna
Label	Label sensitivitas perlindungan informasi Microsoft
MipInformation	Perlindungan informasi Microsoft bawaan dan jenis informasi kustom, label, dan status integrasi.
MipIntegrationStatus	Status integrasi perlindungan informasi Microsoft
Properties	Properti pengaturan sensitivitas
UpdateSensitivitySettingsRequest	Permintaan untuk memperbarui pengaturan sensitivitas data untuk penemuan data sensitif

BuiltInInfoType

Objek

Jenis informasi sensitif yang telah dikonfigurasi sebelumnya

Nama	Jenis	Deskripsi
id	string (uuid)	Id jenis info
name	string	Nama tampilan jenis info
type	string	Kategori jenis info bawaan

CloudError

Objek

Respons kesalahan umum untuk semua API Azure Resource Manager untuk mengembalikan detail kesalahan untuk operasi yang gagal. (Ini juga mengikuti format respons kesalahan OData.).

Nama	Jenis	Deskripsi
error.additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
error.code	string	Kode kesalahan.
error.details	CloudErrorBody[]	Detail kesalahan.
error.message	string	Pesan kesalahan.
error.target	string	Target kesalahan.

CloudErrorBody

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	CloudErrorBody[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

GetSensitivitySettingsResponse

Objek

Pengaturan sensitivitas data untuk penemuan data sensitif

Nama	Jenis	Deskripsi
id	string	ID pengaturan sensitivitas
name	string	Nama pengaturan sensitivitas
properties	Properties	Properti pengaturan sensitivitas
type	string	Jenis pengaturan sensitivitas

InfoType

Objek

Jenis informasi kustom yang ditentukan pengguna

Nama	Jenis	Deskripsi
description	string	Deskripsi jenis info
id	string (uuid)	Id jenis info
name	string	Nama tampilan jenis info

Label

Objek

Label sensitivitas perlindungan informasi Microsoft

Nama	Jenis	Deskripsi
id	string (uuid)	ID label
name	string	Nama tampilan label
order	number	Label diurutkan berdasarkan tingkat sensitivitas. Semakin tinggi urutan label, semakin sensitif.

MipInformation

Objek

Perlindungan informasi Microsoft bawaan dan jenis informasi kustom, label, dan status integrasi.

Nama	Jenis	Deskripsi
builtInInfoTypes	BuiltInInfoType[]	Daftar jenis informasi sensitif yang telah dikonfigurasi sebelumnya
customInfoTypes	InfoType[]	Daftar jenis informasi kustom yang ditentukan pengguna
labels	Label[]	Daftar label sensitivitas perlindungan informasi Microsoft
mipIntegrationStatus	MipIntegrationStatus	Status integrasi perlindungan informasi Microsoft

MipIntegrationStatus

Enumerasi

Status integrasi perlindungan informasi Microsoft

Nilai	Deskripsi
Ok
noConsent
noAutoLabelingRules
noMipLabels

Properties

Objek

Properti pengaturan sensitivitas

Nama	Jenis	Deskripsi
mipInformation	MipInformation	Perlindungan informasi Microsoft bawaan dan jenis informasi kustom, label, dan status integrasi.
sensitiveInfoTypesIds	string[] (uuid)	Daftar ID jenis info sensitif yang dipilih.
sensitivityThresholdLabelId	string (uuid)	Id label ambang sensitivitas. Label apa pun di atau di atas peringkat ini akan dianggap sensitif.
sensitivityThresholdLabelOrder	number	Urutan label ambang sensitivitas. Label apa pun pada atau di atas urutan ini akan dianggap sensitif. Jika diatur ke -1, sensitivitas menurut label dinonaktifkan

UpdateSensitivitySettingsRequest

Objek

Permintaan untuk memperbarui pengaturan sensitivitas data untuk penemuan data sensitif

Nama	Jenis	Deskripsi
sensitiveInfoTypesIds	string[] (uuid)	Daftar ID jenis info sensitif yang dipilih.
sensitivityThresholdLabelId	string (uuid)	Id label ambang sensitivitas. Label apa pun di atau di atas peringkat ini akan dianggap sensitif.
sensitivityThresholdLabelOrder	number	Urutan label ambang sensitivitas. Label apa pun pada atau di atas urutan ini akan dianggap sensitif. Jika diatur ke -1, sensitivitas menurut label dinonaktifkan

Bagikan melalui

Sensitivity Settings - Create Or Update

Parameter URI

Isi Permintaan

Respons

Keamanan

azure_auth

Cakupan

Contoh

Update sensitivity settings

Permintaan sampel

Respon sampel

Definisi

BuiltInInfoType

CloudError

CloudErrorBody

ErrorAdditionalInfo

GetSensitivitySettingsResponse

InfoType

Label

MipInformation

MipIntegrationStatus

Properties

UpdateSensitivitySettingsRequest