Managed Database Sensitivity Labels - Update

서비스:

SQL Database

API 버전:

2021-11-01

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

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
databaseName	path	True	string	데이터베이스의 이름입니다.
managedInstanceName	path	True	string	관리되는 인스턴스의 이름입니다.
resourceGroupName	path	True	string	리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다.
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.

샘플 요청

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/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"
          }
        }
      }
    },
    {
      "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"
          }
        }
      }
    },
    {
      "properties": {
        "op": "remove",
        "schema": "dbo",
        "table": "Table1",
        "column": "Column3"
      }
    }
  ]
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.SensitivityLabelInner;
import com.azure.resourcemanager.sql.fluent.models.SensitivityLabelUpdateInner;
import com.azure.resourcemanager.sql.models.SensitivityLabelUpdateKind;
import com.azure.resourcemanager.sql.models.SensitivityLabelUpdateList;
import java.util.Arrays;

/** Samples for ManagedDatabaseSensitivityLabels Update. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedDatabaseSensitivityLabelsCurrentUpdate.json
     */
    /**
     * Sample code: Update sensitivity labels of a given database using an operations batch.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateSensitivityLabelsOfAGivenDatabaseUsingAnOperationsBatch(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabaseSensitivityLabels().updateWithResponse("myRG",
            "myManagedInstanceName", "myDatabase",
            new SensitivityLabelUpdateList().withOperations(Arrays.asList(
                new SensitivityLabelUpdateInner().withOp(SensitivityLabelUpdateKind.SET).withSchema("dbo")
                    .withTable("table1").withColumn("column1")
                    .withSensitivityLabel(new SensitivityLabelInner().withLabelName("Highly Confidential")
                        .withLabelId("3A477B16-9423-432B-AA97-6069B481CEC3").withInformationType("Financial")
                        .withInformationTypeId("1D3652D6-422C-4115-82F1-65DAEBC665C8")),
                new SensitivityLabelUpdateInner().withOp(SensitivityLabelUpdateKind.SET).withSchema("dbo")
                    .withTable("table2").withColumn("column2")
                    .withSensitivityLabel(new SensitivityLabelInner().withLabelName("PII")
                        .withLabelId("bf91e08c-f4f0-478a-b016-25164b2a65ff").withInformationType("PhoneNumber")
                        .withInformationTypeId("d22fa6e9-5ee4-3bde-4c2b-a409604c4646")),
                new SensitivityLabelUpdateInner().withOp(SensitivityLabelUpdateKind.REMOVE).withSchema("dbo")
                    .withTable("Table1").withColumn("Column3"))),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

상태 코드:

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[]	민감도 레이블 업데이트 작업입니다.