Sensitivity Settings - Create Or Update

서비스:: Defender for Cloud

API 버전:: 2023-02-15-preview

중요한 데이터 검색을 위한 데이터 민감도 설정 만들기 또는 업데이트

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
api-version	query	True	string	작업에 대한 API 버전

요청 본문

Name	필수	형식	Description
sensitiveInfoTypesIds	True	string[] (uuid)	선택한 중요한 정보 유형의 ID 목록입니다.
sensitivityThresholdLabelId		string (uuid)	민감도 임계값 레이블의 ID입니다. 이 순위 이상의 모든 레이블은 중요한 것으로 간주됩니다.
sensitivityThresholdLabelOrder		number	민감도 임계값 레이블의 순서입니다. 이 주문 이상의 모든 레이블은 중요한 것으로 간주됩니다. -1로 설정하면 레이블별 민감도가 해제됩니다.

응답

Name	형식	Description
200 OK	GetSensitivitySettingsResponse	민감도 설정 업데이트의 성공
Other Status Codes	CloudError	작업이 실패한 이유를 설명하는 오류 응답

보안

azure_auth

Azure Active Directory OAuth2 흐름

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Update sensitivity settings

샘플 요청

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

샘플 응답

상태 코드:: 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"
        }
      ]
    }
  }
}

정의

Name	Description
BuiltInInfoType	미리 구성된 중요한 정보 유형
CloudError	실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.
CloudErrorBody	오류 세부 정보입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
GetSensitivitySettingsResponse	중요한 데이터 검색을 위한 데이터 민감도 설정
InfoType	사용자 지정 사용자 정의 정보 유형
Label	Microsoft 정보 보호 민감도 레이블
MipInformation	Microsoft 정보 보호 기본 제공 및 사용자 지정 정보 유형, 레이블 및 통합 상태입니다.
MipIntegrationStatus	Microsoft 정보 보호 통합 상태
Properties	민감도 설정 속성
UpdateSensitivitySettingsRequest	중요한 데이터 검색을 위한 데이터 민감도 설정 업데이트 요청

BuiltInInfoType

Object

미리 구성된 중요한 정보 유형

Name	형식	Description
id	string (uuid)	정보 형식의 ID
name	string	정보 형식의 표시 이름
type	string	기본 제공 정보 유형의 범주

CloudError

Object

실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.

Name	형식	Description
error.additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
error.code	string	오류 코드입니다.
error.details	CloudErrorBody[]	오류 세부 정보입니다.
error.message	string	오류 메시지입니다.
error.target	string	오류 대상입니다.

CloudErrorBody

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	CloudErrorBody[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

GetSensitivitySettingsResponse

Object

중요한 데이터 검색을 위한 데이터 민감도 설정

Name	형식	Description
id	string	민감도 설정의 ID
name	string	민감도 설정의 이름
properties	Properties	민감도 설정 속성
type	string	민감도 설정의 유형

InfoType

Object

사용자 지정 사용자 정의 정보 유형

Name	형식	Description
description	string	정보 유형에 대한 설명
id	string (uuid)	정보 형식의 ID
name	string	정보 형식의 표시 이름

Label

Object

Microsoft 정보 보호 민감도 레이블

Name	형식	Description
id	string (uuid)	레이블의 ID
name	string	레이블의 표시 이름
order	number	레이블은 민감도 수준별로 정렬됩니다. 레이블의 순서가 높을수록 레이블이 더 민감합니다.

MipInformation

Object

Microsoft 정보 보호 기본 제공 및 사용자 지정 정보 유형, 레이블 및 통합 상태입니다.

Name	형식	Description
builtInInfoTypes	BuiltInInfoType[]	미리 구성된 중요한 정보 유형 목록
customInfoTypes	InfoType[]	사용자 지정 사용자 정의 정보 유형 목록
labels	Label[]	Microsoft 정보 보호 민감도 레이블 목록
mipIntegrationStatus	MipIntegrationStatus	Microsoft 정보 보호 통합 상태

MipIntegrationStatus

열거형

Microsoft 정보 보호 통합 상태

값	Description
Ok
noConsent
noAutoLabelingRules
noMipLabels

Properties

Object

민감도 설정 속성

Name	형식	Description
mipInformation	MipInformation	Microsoft 정보 보호 기본 제공 및 사용자 지정 정보 유형, 레이블 및 통합 상태입니다.
sensitiveInfoTypesIds	string[] (uuid)	선택한 중요한 정보 유형의 ID 목록입니다.
sensitivityThresholdLabelId	string (uuid)	민감도 임계값 레이블의 ID입니다. 이 순위 이상의 모든 레이블은 중요한 것으로 간주됩니다.
sensitivityThresholdLabelOrder	number	민감도 임계값 레이블의 순서입니다. 이 주문 이상의 모든 레이블은 중요한 것으로 간주됩니다. -1로 설정하면 레이블별 민감도가 해제됩니다.

UpdateSensitivitySettingsRequest

Object

중요한 데이터 검색을 위한 데이터 민감도 설정 업데이트 요청

Name	형식	Description
sensitiveInfoTypesIds	string[] (uuid)	선택한 중요한 정보 유형의 ID 목록입니다.
sensitivityThresholdLabelId	string (uuid)	민감도 임계값 레이블의 ID입니다. 이 순위 이상의 모든 레이블은 중요한 것으로 간주됩니다.
sensitivityThresholdLabelOrder	number	민감도 임계값 레이블의 순서입니다. 이 주문 이상의 모든 레이블은 중요한 것으로 간주됩니다. -1로 설정하면 레이블별 민감도가 해제됩니다.

다음을 통해 공유

Sensitivity Settings - Create Or Update

URI 매개 변수

요청 본문

응답

보안

azure_auth

범위

예제

Update sensitivity settings

샘플 요청

샘플 응답

정의

BuiltInInfoType

CloudError

CloudErrorBody

ErrorAdditionalInfo

GetSensitivitySettingsResponse

InfoType

Label

MipInformation

MipIntegrationStatus

Properties

UpdateSensitivitySettingsRequest