Sensitivity Labels - Update

  • 참조
Service:
SQL Database
API Version:
2021-11-01

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

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
databaseName
 path True

string

데이터베이스의 이름입니다.
resourceGroupName
 path True

string

리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 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

오류 응답: ***

  • 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 - 사용자가 이 서버 instance 존재하지 않는 데이터베이스 이름을 지정했습니다.

  • 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다.

  • 404 DatabaseDoesNotExist - 사용자가 이 서버 instance 존재하지 않는 데이터베이스 이름을 지정했습니다.

  • 404 SensitivityLabelsLabelNotFound - 지정된 민감도 레이블을 찾을 수 없습니다.

  • 404 SensitivityLabelsSchemaNotFound - 스키마 {0} 를 찾을 수 없습니다.

  • 404 SensitivityLabelsTableNotFound - 스키마에서 테이블을 {0} 찾을 수 없습니다. {1}

  • 404 SensitivityLabelsColumnNotFound - 테이블에서 {2}열을 {0} 찾을 수 없습니다.{1}

  • 501 SensitivityLabelRecommendedSourceNameNotSupported - '권장' 민감도 레이블 원본은 아직 지원되지 않습니다.

  • 501 SensitivityLabelRecommendedSourceNameNotSupported - '권장' 민감도 레이블 원본은 아직 지원되지 않습니다.

  • 503 DatabaseUnavailable - 데이터베이스를 사용할 수 없어 작업이 실패했습니다.

예제

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

Sample Request

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/databases/myDatabase/currentSensitivityLabels?api-version=2021-11-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"
      }
    }
  ]
}

Sample Response

Status code:
200

정의

Name Description
SensitivityLabel

민감도 레이블입니다.
SensitivityLabelRank
SensitivityLabelUpdate

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

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

SensitivityLabel

민감도 레이블입니다.

Name 형식 Description
id

string

리소스 ID입니다.
managedBy

string

민감도 레이블을 관리하는 리소스입니다.
name

string

리소스 이름입니다.
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

Name 형식 Description
Critical

string

High

string

Low

string

Medium

string

None

string

SensitivityLabelUpdate

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

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

Name 형식 Description
remove

string

set

string

SensitivityLabelUpdateList

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

Name 형식 Description
operations

SensitivityLabelUpdate[]

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