Managed Database Sensitivity Labels - Create Or Update

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

지정된 열의 민감도 레이블을 만들거나 업데이트합니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/columns/{columnName}/sensitivityLabels/current?api-version=2021-11-01

URI 매개 변수

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

string

열 이름입니다.
databaseName
 path True

string

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

string

관리되는 인스턴스의 이름입니다.
resourceGroupName
 path True

string

리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다.
schemaName
 path True

string

스키마의 이름입니다.
sensitivityLabelSource
 path True

WritableSensitivityLabelSource

민감도 레이블의 원본입니다.
subscriptionId
 path True

string

Azure 구독을 식별하는 구독 ID입니다.
tableName
 path True

string

테이블의 이름입니다.
api-version
 query True

string

요청에 사용할 API 버전입니다.

요청 본문

Name 형식 Description
properties.informationType

string

정보 유형입니다.
properties.informationTypeId

string

정보 유형 ID입니다.
properties.labelId

string

레이블 ID입니다.
properties.labelName

string

레이블 이름입니다.
properties.rank

SensitivityLabelRank

응답

Name 형식 Description
200 OK

SensitivityLabel

민감도 레이블을 업데이트했습니다.
201 Created

SensitivityLabel

민감도 레이블을 만들었습니다.
Other Status Codes

오류 응답: ***

  • 400 DatawarehouseDatabaseIsDeactivated - 데이터베이스가 일시 중지되어 데이터 분류 작업을 실행할 수 없습니다. 다시 시작하세요.

  • 400 SensitivityLabelSourceNameNotSupported - 지정된 민감도 레이블 원본이 잘못되었습니다.

  • 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 SensitivityLabelsLabelNotFound - 지정된 민감도 레이블을 찾을 수 없습니다.

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

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

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

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

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

예제

Updates or creates a sensitivity label of a given column with all parameters in a managed database

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current?api-version=2021-11-01

{
  "properties": {
    "informationType": "PhoneNumber",
    "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
    "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
    "labelName": "PII",
    "rank": "High"
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current",
  "name": "current",
  "type": "Microsoft.Sql/managedInstances/databases/schemas/tables/columns/sensitivityLabels",
  "properties": {
    "schemaName": "dbo",
    "tableName": "myTable",
    "columnName": "myColumn",
    "informationType": "PhoneNumber",
    "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
    "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
    "labelName": "PII",
    "rank": "High"
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current",
  "name": "current",
  "type": "Microsoft.Sql/managedInstances/databases/schemas/tables/columns/sensitivityLabels",
  "properties": {
    "schemaName": "dbo",
    "tableName": "myTable",
    "columnName": "myColumn",
    "informationType": "PhoneNumber",
    "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
    "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
    "labelName": "PII",
    "rank": "High"
  }
}

정의

Name Description
SensitivityLabel

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

민감도 레이블의 원본입니다.

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

WritableSensitivityLabelSource

민감도 레이블의 원본입니다.

Name 형식 Description
current

string