Выполнение задания анонимизации: различия между версиями

Материал из Dynatrace
(Новая страница: «Пользователю гарантировано право на удаление личных данных. Этот эндпойнт предоставляе...»)
 
 
(не показаны 2 промежуточные версии этого же участника)
Строка 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>
|-
|-
|Окружающая среда ActiveGate
|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[]
|Список полей для анонимизации.
|Список полей для анонимизации.


Вы можете указать несколько полей в следующем формате: <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>
|запрос
|запрос
|необязательный
|необязательно
|}
|}


Строка 83: Строка 110:
|-
|-
|200
|200
|Идентификатор анонимизации Результат
|AnonymizationIdResult
|Успех. Тело ответа содержит идентификатор задания анонимизации. Вы можете использовать идентификатор для проверки статуса задания.
|Успех. Тело ответа содержит идентификатор задания анонимизации. Вы можете использовать идентификатор для проверки статуса задания.
|-
|-
Строка 99: Строка 126:
!Описание
!Описание
|-
|-
|кластеррекуестидс
|clusterRequestIds
|Идентификатор запроса кластера анонимизации [ ]
|AnonymizationClusterRequestID[]
|Список кортежей ID запроса и имени кластера
|Список записей ID запроса и имени кластера


Может быть <code>null</code>.
Может быть <code>null</code>.
|-
|-
|идентификатор запроса
|requestId
|нить
|string
|<nowiki>Идентификатор вновь созданного задания анонимизации. Если задействовано несколько центров обработки данных, список должен быть разделен символом «|». будет возвращен</nowiki>
|<nowiki>Идентификатор вновь созданного задания анонимизации. Если задействовано несколько центров обработки данных, список будет разделен символом «|»</nowiki>


Может быть <code>null</code>.
Может быть <code>null</code>.
Строка 113: Строка 140:


==== Объект _ <code>AnonymizationClusterRequestID</code> ====
==== Объект _ <code>AnonymizationClusterRequestID</code> ====
Список кортежей ID запроса и имени кластера
Список записей ID запроса и имени кластера
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 119: Строка 146:
!Описание
!Описание
|-
|-
|я бы
|id
|целое число
|integer
| -
| -
Может быть <code>null</code>.
Может быть <code>null</code>.
|-
|-
|dcName
|dcName
|нить
|string
| -
| -
Может быть <code>null</code>.
Может быть <code>null</code>.
Строка 148: Строка 175:
Ответ содержит идентификатор задания анонимизации, который можно использовать для проверки его состояния.
Ответ содержит идентификатор задания анонимизации, который можно использовать для проверки его состояния.


==== Завиток ====
==== Curl ====
  <code>curl -X PUT \
  <code>curl -X PUT \
   '<nowiki>https://mySampleEnv.live.dynatrace.com/api/v1/anonymize/anonymizationJobs?startTimestamp=1535752800000&endTimestamp=1536616799000&userIds=john.smith&userIds=mary.smith'</nowiki> \
   '<nowiki>https://mySampleEnv.live.dynatrace.com/api/v1/anonymize/anonymizationJobs?startTimestamp=1535752800000&endTimestamp=1536616799000&userIds=john.smith&userIds=mary.smith'</nowiki> \

Текущая версия на 10:07, 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 пользователя для анонимизации.

Вы можете указать несколько идентификаторов в следующем формате: userIds=user1&userIds=user2.

запрос необязательно
ips string[] IP-адрес пользователя для анонимизации. Все сеансы пользователей с этого IP будут анонимными.

Вы можете указать несколько IP-адресов в следующем формате: ips=ip1&ips=ip2.

запрос необязательно
additionalField string[] Список полей для анонимизации.

Вы можете указать несколько полей в следующем формате: additionalField=field1&additionalField=field2.

Элемент может содержать следующие значения:

  • ip
  • content
  • country
  • region
  • city
  • userId
  • isp
  • stringProperties
  • longProperties
  • doubleProperties
  • dateProperties
  • carrier
  • userActions.name
  • userActions.domain
  • userActions.targetUrl
  • userActions.syntheticEvent
  • userActions.stringProperties
  • userActions.longProperties
  • userActions.doubleProperties
  • userActions.dateProperties
  • events.name
  • events.domain
  • events.page
  • events.pageGroup
  • events.pageReferrer
  • events.pageReferrerGroup
запрос необязательно

Ответ

Коды ответов

Код Тип Описание
200 AnonymizationIdResult Успех. Тело ответа содержит идентификатор задания анонимизации. Вы можете использовать идентификатор для проверки статуса задания.
400 - Не удалось. Ввод недействителен. Подробности смотрите в теле ответа.

Объекты тела ответа

Объект _ AnonymizationIdResult

Элемент Тип Описание
clusterRequestIds AnonymizationClusterRequestID[] Список записей ID запроса и имени кластера

Может быть null.

requestId string Идентификатор вновь созданного задания анонимизации. Если задействовано несколько центров обработки данных, список будет разделен символом «|»

Может быть null.

Объект _ AnonymizationClusterRequestID

Список записей ID запроса и имени кластера

Элемент Тип Описание
id integer -

Может быть null.

dcName string -

Может быть null.

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

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