Выполнение задания анонимизации: различия между версиями
ENetrebin (обсуждение | вклад)  (Новая страница: «Пользователю гарантировано право на удаление личных данных. Этот эндпойнт предоставляе...»)  | 
				ENetrebin (обсуждение | вклад)   | 
				||
| Строка 9: | Строка 9: | ||
Запрос создает <code>application/json</code>полезную нагрузку. Тело ответа содержит идентификатор задания анонимизации, который можно использовать для проверки статуса задания .  | Запрос создает <code>application/json</code>полезную нагрузку. Тело ответа содержит идентификатор задания анонимизации, который можно использовать для проверки статуса задания .  | ||
{| class="wikitable"  | {| class="wikitable"  | ||
| rowspan="3" |  | | rowspan="3" |PUT  | ||
|  | |Managed  | ||
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v1/anonymize/anonymizationJobs</nowiki></code>  | |<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v1/anonymize/anonymizationJobs</nowiki></code>  | ||
|-  | |-  | ||
| Строка 16: | Строка 16: | ||
|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v1/anonymize/anonymizationJobs</nowiki></code>  | |<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v1/anonymize/anonymizationJobs</nowiki></code>  | ||
|-  | |-  | ||
|  | |Environment АктивныйШлюз  | ||
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v1/anonymize/anonymizationJobs</nowiki></code>  | |<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v1/anonymize/anonymizationJobs</nowiki></code>  | ||
|}  | |}  | ||
== Аутентификация ==  | == Аутентификация ==  | ||
Чтобы выполнить этот запрос, вам необходимо разрешение Анонимизировать данные сеанса пользователя по соображениям конфиденциальности данных ( <code>UserSessionAnonymization</code>) , назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .  | Чтобы выполнить этот запрос, вам необходимо разрешение '''Анонимизировать данные сеанса пользователя по соображениям конфиденциальности данных''' ( <code>UserSessionAnonymization</code>) , назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] .  | ||
== Параметры ==  | == Параметры ==  | ||
| Строка 28: | Строка 28: | ||
!Тип  | !Тип  | ||
!Описание  | !Описание  | ||
!  | !In  | ||
!  | !Необходимость  | ||
|-  | |-  | ||
|startTimestamp  | |startTimestamp  | ||
|  | |integer  | ||
|Отметка времени начала сеанса пользователя для анонимизации в миллисекундах UTC.  | |Отметка времени начала сеанса пользователя для анонимизации в миллисекундах UTC.  | ||
Если не установлено, используется самое раннее доступное время.  | Если не установлено, используется самое раннее доступное время.  | ||
|запрос  | |запрос  | ||
|  | |необязательно  | ||
|-  | |-  | ||
|endTimestamp  | |endTimestamp  | ||
|  | |integer  | ||
|Отметка времени окончания сеанса пользователя для анонимизации в миллисекундах UTC.  | |Отметка времени окончания сеанса пользователя для анонимизации в миллисекундах UTC.  | ||
Если не установлено, используется текущее время.  | Если не установлено, используется текущее время.  | ||
|запрос  | |запрос  | ||
|  | |необязательно  | ||
|-  | |-  | ||
|  | |userIds  | ||
|  | |string[]  | ||
|UserID пользователя для анонимизации.  | |UserID пользователя для анонимизации.  | ||
Вы можете указать несколько идентификаторов в следующем формате: <code>userIds=user1&userIds=user2</code>.  | Вы можете указать несколько идентификаторов в следующем формате: <code>userIds=user1&userIds=user2</code>.  | ||
|запрос  | |запрос  | ||
|  | |необязательно  | ||
|-  | |-  | ||
|ips  | |ips  | ||
|  | |string[]  | ||
|IP-адрес пользователя для анонимизации. Все сеансы пользователей с этого IP будут анонимными.  | |IP-адрес пользователя для анонимизации. Все сеансы пользователей с этого IP будут анонимными.  | ||
Вы можете указать несколько IP-адресов в следующем формате: <code>ips=ip1&ips=ip2</code>.  | Вы можете указать несколько IP-адресов в следующем формате: <code>ips=ip1&ips=ip2</code>.  | ||
|запрос  | |запрос  | ||
|  | |необязательно  | ||
|-  | |-  | ||
|  | |additionalField  | ||
|  | |string[]  | ||
|Список полей для анонимизации.  | |Список полей для анонимизации.  | ||
| Строка 71: | Строка 71: | ||
Элемент может содержать эти значения  | Элемент может содержать эти значения  | ||
|запрос  | |запрос  | ||
|  | |необязательно  | ||
|}  | |}  | ||
Версия 09:18, 9 марта 2022
Пользователю гарантировано право на удаление личных данных. Этот эндпойнт предоставляет вам средства для выполнения таких запросов.
Далее рассмотрено создание задания анонимизации сеанса пользователя. Задание анонимизирует все сеансы пользователей в указанный период времени, маскируя идентификатор пользователя ( userIds ) и IP-адрес ( ips ).
Чтобы определить сеансы пользователей, которые должны быть анонимизированы, вы можете указать идентификатор пользователя, IP-адрес или и то, и другое. Если вы укажете и то, и другое, применяется логика ИЛИ — каждый сеанс с указанными идентификаторами пользователей становится анонимным, независимо от того, с какого IP-адреса он пришел; каждый сеанс с указанного IP-адреса становится анонимным, даже если он принадлежит идентификатору пользователя, который не был указан. Вы можете указать несколько идентификаторов пользователей и IP-адресов.
Независимо от того, как вы идентифицируете пользовательские сеансы, и идентификатор пользователя, и IP-адрес маскируются. Вы не можете отменить анонимизацию.
Запрос создает application/jsonполезную нагрузку. Тело ответа содержит идентификатор задания анонимизации, который можно использовать для проверки статуса задания .
| PUT | Managed | https://{your-domain}/e/{your-environment-id}/api/v1/anonymize/anonymizationJobs
 | 
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v1/anonymize/anonymizationJobs
 | |
| Environment АктивныйШлюз | https://{your-activegate-domain}/e/{your-environment-id}/api/v1/anonymize/anonymizationJobs
 | 
Аутентификация
Чтобы выполнить этот запрос, вам необходимо разрешение Анонимизировать данные сеанса пользователя по соображениям конфиденциальности данных ( UserSessionAnonymization) , назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
| Параметр | Тип | Описание | In | Необходимость | 
|---|---|---|---|---|
| startTimestamp | integer | Отметка времени начала сеанса пользователя для анонимизации в миллисекундах UTC.
 Если не установлено, используется самое раннее доступное время.  | 
запрос | необязательно | 
| endTimestamp | integer | Отметка времени окончания сеанса пользователя для анонимизации в миллисекундах UTC.
 Если не установлено, используется текущее время.  | 
запрос | необязательно | 
| userIds | string[] | UserID пользователя для анонимизации.
 Вы можете указать несколько идентификаторов в следующем формате:   | 
запрос | необязательно | 
| ips | string[] | IP-адрес пользователя для анонимизации. Все сеансы пользователей с этого IP будут анонимными.
 Вы можете указать несколько IP-адресов в следующем формате:   | 
запрос | необязательно | 
| additionalField | string[] | Список полей для анонимизации.
 Вы можете указать несколько полей в следующем формате:  Элемент может содержать эти значения  | 
запрос | необязательно | 
Ответ
Коды ответов
| Код | Тип | Описание | 
|---|---|---|
| 200 | Идентификатор анонимизации Результат | Успех. Тело ответа содержит идентификатор задания анонимизации. Вы можете использовать идентификатор для проверки статуса задания. | 
| 400 | - | Не удалось. Ввод недействителен. Подробности смотрите в теле ответа. | 
Объекты тела ответа
Объект _ AnonymizationIdResult
| Элемент | Тип | Описание | 
|---|---|---|
| кластеррекуестидс | Идентификатор запроса кластера анонимизации [ ] | Список кортежей ID запроса и имени кластера
 Может быть   | 
| идентификатор запроса | нить | Идентификатор вновь созданного задания анонимизации. Если задействовано несколько центров обработки данных, список должен быть разделен символом «|». будет возвращен
 Может быть   | 
Объект _ AnonymizationClusterRequestID
Список кортежей ID запроса и имени кластера
| Элемент | Тип | Описание | 
|---|---|---|
| я бы | целое число | -
 Может быть   | 
| dcName | нить | -
 Может быть   | 
JSON-модель тела ответа
{
  "clusterRequestIds": [
    {
      "id": 1,
      "dcName": "string"
    }
  ],
  "requestId": "-4013759873546847071|7354684707140137598"
}
Пример
В этом примере запрос запускает задание по анонимизации всех сеансов пользователей john.smith и mary.smith в период между 00:00 1 сентября 2018 г. и 23:59 10 сентября 2018 г. (соответствует временным меткам 1535752800000 и 1536616799000). , соответственно).
Маркер API передается в заголовке авторизации .
Ответ содержит идентификатор задания анонимизации, который можно использовать для проверки его состояния.
Завиток
curl -X PUT \
  'https://mySampleEnv.live.dynatrace.com/api/v1/anonymize/anonymizationJobs?startTimestamp=1535752800000&endTimestamp=1536616799000&userIds=john.smith&userIds=mary.smith' \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
URL-адрес запроса
https://mySampleEnv.live.dynatrace.com/api/v1/anonymize/anonymizationJobs?startTimestamp=1535752800000&endTimestamp=1536616799000&userIds=john.smith&userIds=mary.smith
Содержание ответа
{
  "requestId": "7810238295331327902"
}
Код ответа
200