Выполнение задания анонимизации: различия между версиями
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