Sensitivity Labels - Update

서비스:

SQL Database

API 버전:

2023-08-01

작업 일괄 처리를 사용하여 지정된 데이터베이스의 민감도 레이블을 업데이트합니다.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/currentSensitivityLabels?api-version=2023-08-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
databaseName	path	True	string	데이터베이스의 이름입니다.
resourceGroupName	path	True	string	리소스를 포함하는 리소스 그룹의 이름입니다. Azure Resource Manager API 또는 포털에서 이 값을 가져올 수 있습니다.
serverName	path	True	string	서버의 이름입니다.
subscriptionId	path	True	string	Azure 구독을 식별하는 구독 ID입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
operations	SensitivityLabelUpdate[]	민감도 레이블 업데이트 작업입니다.

응답

Name	형식	Description
200 OK		민감도 레이블을 업데이트했습니다.
Other Status Codes	ErrorResponse	오류 응답: *** 400 DatawarehouseDatabaseIsDeactivated - 데이터베이스가 일시 중지되어 데이터 분류 작업을 실행할 수 없습니다. 다시 시작하세요. 400 DatawarehouseDatabaseIsDeactivated - 데이터베이스가 일시 중지되어 데이터 분류 작업을 실행할 수 없습니다. 다시 시작하세요. 400 SensitivityLabelSourceNameNotSupported - 지정된 민감도 레이블 원본이 잘못되었습니다. 400 InvalidSensitivityLabelsBatch - 지정된 민감도 레이블 일괄 처리가 잘못되었습니다. 일괄 처리 작업을 제공하세요. 400 SensitivityLabelsMissingSchema - Operation[{0}]: 누락된 스키마 정보 400 SensitivityLabelsMissingTable - Operation[{0}]: 누락된 테이블 정보 400 SensitivityLabelsMissingColumn - Operation[{0}]: 누락된 열 정보 400 SensitivityLabelsUpdateSameColumnMoreThanOnce - 단일 명령에서 열 {0} 두 번 이상 업데이트할 수 없습니다. 400 InvalidSensitivityLabelResource - 지정된 민감도 레이블 리소스가 잘못되었습니다. 400 SensitivityLabelLabelNameAndInfoTypeNotProvided - LabelName 및 InformationType 중 하나 이상을 지정해야 합니다. 400 LabelNameTooLong - 레이블 이름은 {0} 문자를 초과할 수 없습니다. 400 InformationTypeTooLong - 정보 유형이 {0} 문자를 초과할 수 없음 400 LabelIdMustBeGuid - 제공된 'labelId'가 잘못되었습니다. 값은 GUID여야 합니다. 400 InformationTypeIdMustBeGuid - 제공된 'informationTypeId'가 잘못되었습니다. 값은 GUID여야 합니다. 400 LabelMissing - 레이블이 필요합니다. 'labelName' 또는 'labelId' 중 하나 이상을 제공해야 합니다. 400 InformationTypeMissing - 정보 유형이 필요합니다. 'informationType' 또는 'informationTypeId' 중 하나 이상을 제공해야 합니다. 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 DatabaseDoesNotExist - 사용자가 이 서버 인스턴스에 없는 데이터베이스 이름을 지정했습니다. 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 SensitivityLabelsSchemaNotFound - 스키마 {0} 찾을 수 없습니다. 404 SensitivityLabelsTableNotFound - 스키마 {0}{1} 테이블을 찾을 수 없습니다. 404 SensitivityLabelsColumnNotFound - {0}테이블에서 {2} 열을 찾을 수 없습니다.{1} 404 DatabaseDoesNotExist - 사용자가 이 서버 인스턴스에 없는 데이터베이스 이름을 지정했습니다. 404 SensitivityLabelsLabelNotFound - 지정된 민감도 레이블을 찾을 수 없습니다. 501 SensitivityLabelRecommendedSourceNameNotSupported - '권장' 민감도 레이블 원본은 아직 지원되지 않습니다. 501 SensitivityLabelRecommendedSourceNameNotSupported - '권장' 민감도 레이블 원본은 아직 지원되지 않습니다. 503 DatabaseUnavailable - 데이터베이스를 사용할 수 없어 작업이 실패했습니다.

예제

Update sensitivity labels of a given database using an operations batch.

샘플 요청

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/databases/myDatabase/currentSensitivityLabels?api-version=2023-08-01

{
  "operations": [
    {
      "properties": {
        "op": "set",
        "schema": "dbo",
        "table": "table1",
        "column": "column1",
        "sensitivityLabel": {
          "properties": {
            "labelName": "Highly Confidential",
            "labelId": "3A477B16-9423-432B-AA97-6069B481CEC3",
            "informationType": "Financial",
            "informationTypeId": "1D3652D6-422C-4115-82F1-65DAEBC665C8",
            "rank": "Low"
          }
        }
      }
    },
    {
      "properties": {
        "op": "set",
        "schema": "dbo",
        "table": "table2",
        "column": "column2",
        "sensitivityLabel": {
          "properties": {
            "informationType": "PhoneNumber",
            "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
            "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
            "labelName": "PII",
            "rank": "Critical"
          }
        }
      }
    },
    {
      "properties": {
        "op": "remove",
        "schema": "dbo",
        "table": "Table1",
        "column": "Column3"
      }
    }
  ]
}

샘플 응답

상태 코드:

200

정의

Name	Description
ClientClassificationSource
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
SensitivityLabel	민감도 레이블입니다.
SensitivityLabelRank
SensitivityLabelUpdate	민감도 레이블 업데이트 작업입니다.
SensitivityLabelUpdateKind
SensitivityLabelUpdateList	민감도 레이블 업데이트 작업 목록입니다.

ClientClassificationSource

열거형

값	Description
None
Native
Recommended
MIP

ErrorAdditionalInfo

Object

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

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

ErrorDetail

Object

오류 세부 정보입니다.

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

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

SensitivityLabel

Object

민감도 레이블입니다.

Name	형식	Description
id	string	리소스 ID입니다.
managedBy	string	민감도 레이블을 관리하는 리소스입니다.
name	string	리소스 이름입니다.
properties.clientClassificationSource	ClientClassificationSource
properties.columnName	string	열 이름입니다.
properties.informationType	string	정보 유형입니다.
properties.informationTypeId	string	정보 유형 ID입니다.
properties.isDisabled	boolean	민감도 권장 사항을 사용할 수 없습니다. 권장 민감도 레이블에만 적용됩니다. 이 열의 민감도 권장 사항을 사용하지 않도록 설정(해제)할지 여부를 지정합니다.
properties.labelId	string	레이블 ID입니다.
properties.labelName	string	레이블 이름입니다.
properties.rank	SensitivityLabelRank
properties.schemaName	string	스키마 이름입니다.
properties.tableName	string	테이블 이름입니다.
type	string	리소스 종류입니다.

SensitivityLabelRank

열거형

값	Description
None
Low
Medium
High
Critical

SensitivityLabelUpdate

Object

민감도 레이블 업데이트 작업입니다.

Name	형식	Description
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.column	string	업데이트할 열 이름입니다.
properties.op	SensitivityLabelUpdateKind
properties.schema	string	업데이트할 열의 스키마 이름입니다.
properties.sensitivityLabel	SensitivityLabel	열에 적용할 민감도 레이블 정보입니다.
properties.table	string	업데이트할 열의 테이블 이름입니다.
type	string	리소스 종류입니다.

SensitivityLabelUpdateKind

열거형

값	Description
set
remove

SensitivityLabelUpdateList

Object

민감도 레이블 업데이트 작업 목록입니다.

Name	형식	Description
operations	SensitivityLabelUpdate[]	민감도 레이블 업데이트 작업입니다.