Выполнение задания анонимизации: различия между версиями
ENetrebin (обсуждение | вклад)  | 
				ENetrebin (обсуждение | вклад)   | 
				||
| Строка 69: | Строка 69: | ||
Вы можете указать несколько полей в следующем формате: <code>additionalField=field1&additionalField=field2</code>.  | Вы можете указать несколько полей в следующем формате: <code>additionalField=field1&additionalField=field2</code>.  | ||
Элемент может содержать   | Элемент может содержать следующие значения:  | ||
* <code>ip</code>  | |||
* <code>content</code>  | |||
* <code>country</code>  | |||
* <code>region</code>  | |||
* <code>city</code>  | |||
* <code>userId</code>  | |||
* <code>isp</code>  | |||
* <code>stringProperties</code>  | |||
* <code>longProperties</code>  | |||
* <code>doubleProperties</code>  | |||
* <code>dateProperties</code>  | |||
* <code>carrier</code>  | |||
* <code>userActions.name</code>  | |||
* <code>userActions.domain</code>  | |||
* <code>userActions.targetUrl</code>  | |||
* <code>userActions.syntheticEvent</code>  | |||
* <code>userActions.stringProperties</code>  | |||
* <code>userActions.longProperties</code>  | |||
* <code>userActions.doubleProperties</code>  | |||
* <code>userActions.dateProperties</code>  | |||
* <code>events.name</code>  | |||
* <code>events.domain</code>  | |||
* <code>events.page</code>  | |||
* <code>events.pageGroup</code>  | |||
* <code>events.pageReferrer</code>  | |||
* <code>events.pageReferrerGroup</code>  | |||
|запрос  | |запрос  | ||
|необязательно  | |необязательно  | ||
Версия 09:23, 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