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

Имя	В	Обязательно	Тип	Описание
databaseName	path	True	string	Имя базы данных.
managedInstanceName	path	True	string	Имя управляемого экземпляра.
resourceGroupName	path	True	string	Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
subscriptionId	path	True	string	Идентификатор подписки Azure.
api-version	query	True	string	Версия API для использования в запросе.

Текст запроса

Имя	Тип	Описание
operations	SensitivityLabelUpdate[]	Операция обновления метки конфиденциальности.

Ответы

Имя	Тип	Описание
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 — пользователь указал имя базы данных, которое не существует на этом экземпляре сервера. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден 404 DatabaseDoesNotExist — пользователь указал имя базы данных, которое не существует на этом экземпляре сервера. 404 SensitivityLabelNotFound — не удалось найти указанную метку конфиденциальности. 404 SensitivityLabelsSchemaNotFound — не удалось найти схему {0} 404 SensitivityLabelsTableNotFound — не удалось найти таблицу {0} в схеме {1} 404 SensitivityLabelsColumnNotFound — столбец {0} не найден в таблице {2}.{1} 501 SensitivityLabelRecommendedSourceNameNotSupported — источник метки конфиденциальности "Рекомендуется" пока не поддерживается 501 SensitivityLabelRecommendedSourceNameNotSupported — источник метки конфиденциальности "Рекомендуется" пока не поддерживается 503 DatabaseUnavailable — операция завершилась сбоем, так как база данных недоступна.

Имя

Тип

Описание

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 — пользователь указал имя базы данных, которое не существует на этом экземпляре сервера.
404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден
404 DatabaseDoesNotExist — пользователь указал имя базы данных, которое не существует на этом экземпляре сервера.
404 SensitivityLabelNotFound — не удалось найти указанную метку конфиденциальности.
404 SensitivityLabelsSchemaNotFound — не удалось найти схему {0}
404 SensitivityLabelsTableNotFound — не удалось найти таблицу {0} в схеме {1}
404 SensitivityLabelsColumnNotFound — столбец {0} не найден в таблице {2}.{1}
501 SensitivityLabelRecommendedSourceNameNotSupported — источник метки конфиденциальности "Рекомендуется" пока не поддерживается
501 SensitivityLabelRecommendedSourceNameNotSupported — источник метки конфиденциальности "Рекомендуется" пока не поддерживается
503 DatabaseUnavailable — операция завершилась сбоем, так как база данных недоступна.

Примеры

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

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


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

Определения

Имя	Описание
SensitivityLabel	Метка конфиденциальности.
SensitivityLabelRank
SensitivityLabelUpdate	Операция обновления метки конфиденциальности.
SensitivityLabelUpdateKind
SensitivityLabelUpdateList	Список операций обновления меток конфиденциальности.

SensitivityLabel

Метка конфиденциальности.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
managedBy	string	Ресурс, который управляет меткой конфиденциальности.
name	string	Имя ресурса.
properties.columnName	string	Имя столбца.
properties.informationType	string	Тип сведений.
properties.informationTypeId	string	Идентификатор типа сведений.
properties.isDisabled	boolean	Отключена ли рекомендация по конфиденциальности. Применимо только для рекомендуемой метки конфиденциальности. Указывает, отключена (отклонена) рекомендация по конфиденциальности для этого столбца.
properties.labelId	string	Идентификатор метки.
properties.labelName	string	Имя метки.
properties.rank	SensitivityLabelRank
properties.schemaName	string	Имя схемы.
properties.tableName	string	Имя таблицы.
type	string	Тип ресурса.

SensitivityLabelRank

Имя	Тип	Описание
Critical	string
High	string
Low	string
Medium	string
None	string

SensitivityLabelUpdate

Операция обновления метки конфиденциальности.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.column	string	Имя обновляемого столбца.
properties.op	SensitivityLabelUpdateKind
properties.schema	string	Имя схемы обновляемого столбца.
properties.sensitivityLabel	SensitivityLabel	Сведения о метках конфиденциальности, применяемые к столбцу.
properties.table	string	Имя таблицы обновляемого столбца.
type	string	Тип ресурса.

SensitivityLabelUpdateKind

Имя	Тип	Описание
remove	string
set	string

SensitivityLabelUpdateList

Список операций обновления меток конфиденциальности.

Имя	Тип	Описание
operations	SensitivityLabelUpdate[]	Операция обновления метки конфиденциальности.

Поделиться через