Extremo de suscripciones de alerta
El servicio de consultas de Adobe Experience Platform le permite suscribirse a alertas para consultas ad hoc y programadas. Las alertas se pueden recibir por correo electrónico, en la interfaz de usuario de Platform o en ambas. El contenido de notificación es el mismo para las alertas en la plataforma y las alertas por correo electrónico.
Introducción
Los extremos utilizados en esta guía forman parte de la API de Adobe Experience Platform Query Service. Antes de continuar, revisa la guía de introducción para obtener información importante que necesitas conocer para poder realizar llamadas a la API correctamente, incluidos los encabezados requeridos y cómo leer llamadas de API de ejemplo.
Tipos de alerta alert-types
En la tabla siguiente se explican los tipos de alertas de consulta admitidos:
delay
o Retraso en la ejecución de la consulta no es compatible actualmente con la API del servicio de consultas. Esta alerta le notifica si hay un retraso en el resultado de una ejecución de consulta programada más allá de un umbral especificado. Para utilizar esta alerta, debe establecer una hora personalizada que ponga en déclencheur una alerta cuando la consulta se ejecute durante ese tiempo sin completarse ni producirse errores. Para obtener información sobre cómo establecer esta alerta en la interfaz de usuario, consulte la documentación de programaciones de consultas o la guía para acciones de consultas en línea.start
success
failed
quarantine
Las siguientes alertas se aplican sin una suscripción de alerta:
- Cuando finaliza un trabajo de consulta por lotes, los usuarios reciben una notificación.
- Cuando la duración de un trabajo de consulta por lotes supera un umbral, se activa una alerta para la persona que programó la consulta.
Llamadas de API de muestra
Las siguientes secciones describen las distintas llamadas a la API que puede realizar mediante la API del servicio de consultas. Cada llamada a incluye el formato de API general, una solicitud de ejemplo que muestra los encabezados necesarios y una respuesta de ejemplo.
Recuperación de una lista de todas las alertas de una organización y una zona protegida get-list-of-org-alert-subs
Recupere una lista de todas las alertas de una zona protegida de la organización realizando una solicitud de GET al extremo /alert-subscriptions
.
Formato de API
GET /alert-subscriptions
GET /alert-subscriptions?{QUERY_PARAMETERS}
{QUERY_PARAMETERS}
Parámetros de consulta
A continuación se muestra una lista de los parámetros de consulta disponibles para enumerar consultas. Todos estos parámetros son opcionales. Si realiza una llamada a este extremo sin parámetros, se recuperarán todas las consultas disponibles para su organización.
orderby
created
y updated
. Anteponga el nombre de la propiedad con +
para orden ascendente y -
para orden descendente. El valor predeterminado es -created
. Tenga en cuenta que el signo más (+
) debe especificarse como escape con %2B
. Por ejemplo %2Bcreated
es el valor de un orden creado ascendente.pagesize
page
property
Filtre los resultados en función de los campos seleccionados. Los filtros deben ser de escape de HTML. Las comas se utilizan para combinar varios conjuntos de filtros. Las siguientes propiedades permiten el filtrado:
- Identificación
- assetId
- estado
- alertType
Los operadores admitidos son ==
(igual a). Por ejemplo, id==6ebd9c2d-494d-425a-aa91-24033f3abeec
devolverá la alerta con un identificador coincidente.
Solicitud
curl -X GET 'https://platform.adobe.io/data/foundation/query/alert-subscriptions' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-H 'x-sandbox-id: {SANDBOX_ID}'
Respuesta
Una respuesta correcta devuelve un estado HTTP 200 y la matriz alerts
con información de paginación y versión. La matriz alerts
contiene detalles de todas las alertas de una organización y de una zona protegida concreta. Hay un máximo de tres alertas disponibles por respuesta; el cuerpo de la respuesta contiene una alerta por cada tipo de alerta.
alerts._links
de la matriz alerts
se ha truncado para que sea más breve. Se puede encontrar un ejemplo completo del objeto alerts._links
en la respuesta de la solicitud del POST.{
"alerts": [
{
"assetId": "0ca168f4-e46b-4f7f-be6a-bdc386271b4a",
"id": "query_service_flow_run_start-dcf7b4be-ccd7-4c73-ae0c-a4bb34a40adada84",
"status": "enabled",
"alertType": "start",
"_links":{
"self": {…},
"subscribe": {…},
"patch_status": {…},
"get_list_of_subscribers_by_alert_type": {…},
"delete": {…}
}
},
{
"assetId": "0ca168f4-e46b-4f7f-be6a-bdc386271b4a",
"id": "query_service_flow_run_success-dcf7b4be-ccd7-4c73-ae0c-a4bb34a40adada84",
"status": "enabled",
"alertType": "success",
"_links":{
"self": {…},
"subscribe": {…},
"patch_status": {…},
"get_list_of_subscribers_by_alert_type": {…},
"delete": {…}
}
},
{
"assetId": "700d43d9-3b99-4d4c-8dbb-29c911c0e0df",
"id": "query_service_flow_run_start-75da972a-e859-47a5-934c-629904daa1ef",
"status": "enabled",
"alertType": "start",
"_links":{
"self": {…},
"subscribe": {…},
"patch_status": {…},
"get_list_of_subscribers_by_alert_type": {…},
"delete": {…}
}
}
],
"_page": {
"orderby": "-created",
"page": 1,
"count": 26,
"pageSize": 50
},
"_links": {
"next": {
"href": "https://platform.adobe.io/data/foundation/query/queries/alert-subscriptions?orderby=-created&page=2"
},
"prev": {
"href": "https://platform.adobe.io/data/foundation/query/queries/alert-subscriptions?orderby=-created&page=0"
}
},
"version": 1
}
alerts.assetId
alerts.id
alertType
y el ID de flujo. Encontrará información sobre las alertas disponibles en la documentación del panel de alertas de plataforma.alerts.status
enabled
, enabling
, disabled
y disabling
. Una alerta escucha activamente los eventos, se pone en pausa para un uso futuro mientras conserva todos los suscriptores y la configuración relevantes o realiza la transición entre estos estados.alerts.alertType
El tipo de alerta. Hay cinco estados de alerta disponibles para las consultas programadas, aunque solo hay cuatro estados de alerta disponibles para las consultas ad hoc. La alerta quarantine
solo está disponible para consultas programadas. Además, solo puede establecer la alerta delay
desde la interfaz de usuario de Platform. Por ese motivo delay
no se describe aquí. Las alertas disponibles son:
start
: notifica a un usuario cuando ha comenzado la ejecución de la consulta.success
: notifica al usuario cuando finaliza la consulta.failure
: notifica al usuario si la consulta falla.quarantine
: se activa cuando una ejecución de consulta programada se pone en estado de cuarentena.
alerts._links
_page
_links
Recuperar la información de suscripción de alerta de una consulta o ID de programación determinados retrieve-all-alert-subscriptions-by-id
Recupere la información de suscripción de alerta para un ID de consulta o ID de programación concreto realizando una solicitud de GET al extremo /alert-subscriptions/{QUERY_ID}
o /alert-subscriptions/{SCHEDULE_ID}
.
Formato de API
GET /alert-subscriptions/{QUERY_ID}
GET /alert-subscriptions/{SCHEDULE_ID}
{QUERY_ID}
{SCHEDULE_ID}
Solicitud
curl -X GET 'https://platform.adobe.io/data/foundation/query/alert-subscriptions/4422fc69-eaa7-464e-945b-63cfd435d3d1' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-H 'x-sandbox-id: {SANDBOX_ID}'
Respuesta
Una respuesta correcta devuelve un estado HTTP de 200 y la matriz alerts
que contiene información de suscripción para la consulta o el ID de programación proporcionados.
{
"alerts": [
{
"assetId": "6df22232-f427-4250-a4e1-43cd30990641",
"id": "query_service_flow_run_failure-5cdc3bbe-750a-4d80-9c43-96e5e09f1a96",
"status": "enabled",
"alertType": "failure",
"subscriptions": {
"emailNotifications": [
"rrunner@adobe.com",
"jsnow@adobe.com",
"keverdeen@adobe.com"
],
"inContextNotifications": [
"rrunner@adobe.com",
"jsnow@adobe.com",
"keverdeen@adobe.com"
]
},
"_links": {
"self": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928",
"method": "GET"
},
"subscribe": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions",
"method": "POST",
"body": "{\"assetId\": \"queryId/scheduleId\", \"alertType\": \"start/success/failure\", \"subscriptions\": {\n\"emailIds\": [\"xyz@example.com\", \"abc@example.com\"], \"email\": true, \"inContext\": false}}"
},
"patch_status": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928/failure",
"method": "PATCH",
"body": "{ \"op\": \"replace\", \"path\": \"/status\", \"value\": \"enable/disable\" }"
},
"get_list_of_subscribers_by_alert_type": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928/failure",
"method": "GET"
},
"delete": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928/failure",
"method": "DELETE"
}
}
},
{
"assetId": "6df22232-f427-4250-a4e1-43cd30990641",
"id": "query_service_flow_run_start-5cdc3bbe-750a-4d80-9c43-96e5e09f1a96",
"status": "enabled",
"alertType": "start",
"subscriptions": {
"emailNotifications": [
"rrunner@adobe.com"
],
"inContextNotifications": [
"rrunner@adobe.com"
]
},
"_links": {
"self": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928",
"method": "GET"
},
"subscribe": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions",
"method": "POST",
"body": "{\"assetId\": \"queryId/scheduleId\", \"alertType\": \"start/success/failure\", \"subscriptions\": {\n\"emailIds\": [\"xyz@example.com\", \"abc@example.com\"], \"email\": true, \"inContext\": false}}"
},
"patch_status": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928/failure",
"method": "PATCH",
"body": "{ \"op\": \"replace\", \"path\": \"/status\", \"value\": \"enable/disable\" }"
},
"get_list_of_subscribers_by_alert_type": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928/failure",
"method": "GET"
},
"delete": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928/failure",
"method": "DELETE"
}
}
}
]
}
assetId
id
alertType
y el ID de flujo. Encontrará información sobre las alertas disponibles en la documentación del panel de alertas de plataforma.status
enabled
, enabling
, disabled
y disabling
. Una alerta escucha activamente los eventos, se pone en pausa para un uso futuro mientras conserva todos los suscriptores y la configuración relevantes o realiza la transición entre estos estados.alertType
Cada alerta puede tener tres tipos diferentes. Estos son:
start
: notifica a un usuario cuando ha comenzado la ejecución de la consulta.success
: notifica al usuario cuando finaliza la consulta.failure
: notifica al usuario si la consulta falla.
subscriptions.emailNotifications
subscriptions.inContextNotifications
Recuperar información de suscripción de alerta para una consulta o ID de programación y tipo de alerta determinados get-alert-info-by-id-and-alert-type
Recupere la información de suscripción de alerta para un identificador y tipo de alerta determinados realizando una solicitud de GET al extremo /alert-subscriptions/{QUERY_ID}/{ALERT_TYPE}
. Esto es aplicable tanto a las consultas como a los ID de consultas programadas.
Formato de API
GET /alert-subscriptions/{QUERY_ID}/{ALERT_TYPE}
GET /alert-subscriptions/{SCHEDULE_ID}/{ALERT_TYPE}
ALERT_TYPE
Esta propiedad describe el estado de ejecución de una déclencheur. La respuesta solo incluirá información de suscripción de alerta para alertas de este tipo. Cada alerta puede tener tres tipos diferentes. Estos son:
start
: notifica a un usuario cuando ha comenzado la ejecución de la consulta.success
: notifica al usuario cuando finaliza la consulta.failure
: notifica al usuario si la consulta falla.
QUERY_ID
SCHEDULE_ID
Solicitud
curl -X GET 'https://platform.adobe.io/data/foundation/query/alert-subscriptions/4422fc69-eaa7-464e-945b-63cfd435d3d1/start'' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-H 'x-sandbox-id: {SANDBOX_ID}'
Respuesta
Una respuesta correcta devuelve un estado HTTP de 200 y todas las alertas a las que se ha suscrito. Esto incluye el ID de alerta, el tipo de alerta, los ID de correo electrónico registrado de Adobe del suscriptor y su canal de notificación preferido.
{
"alerts": [
{
"assetId": "6df22232-f427-4250-a4e1-43cd30990641",
"id": "query_service_flow_run_success-5cdc3bbe-750a-4d80-9c43-96e5e09f1a96",
"status": "enabled",
"alertType": "success",
"subscriptions": {
"emailNotifications": [
"rrunner@adobe.com",
"jsnow@adobe.com"
],
"inContextNotifications": [
"jsnow@adobe.com"
]
},
"_links": {
"self": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928",
"method": "GET"
},
"subscribe": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions",
"method": "POST",
"body": "{\"assetId\": \"queryId/scheduleId\", \"alertType\": \"start/success/failure\", \"subscriptions\": {\n\"emailIds\": [\"xyz@example.com\", \"abc@example.com\"], \"email\": true, \"inContext\": false}}"
},
"patch_status": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928/failure",
"method": "PATCH",
"body": "{ \"op\": \"replace\", \"path\": \"/status\", \"value\": \"enable/disable\" }"
},
"get_list_of_subscribers_by_alert_type": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928/failure",
"method": "GET"
},
"delete": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928/failure",
"method": "DELETE"
}
}
}
]
}
assetId
alertType
El tipo de alerta. Hay cinco estados de alerta disponibles para las consultas programadas, aunque solo hay cuatro estados de alerta disponibles para las consultas ad hoc. La alerta quarantine
solo está disponible para consultas programadas. Además, solo puede establecer la alerta delay
desde la interfaz de usuario de Platform. Por ese motivo delay
no se describe aquí. Las alertas disponibles son:
start
: notifica a un usuario cuando ha comenzado la ejecución de la consulta.success
: notifica al usuario cuando finaliza la consulta.failure
: notifica al usuario si la consulta falla.quarantine
: se activa cuando una ejecución de consulta programada se pone en estado de cuarentena.
subscriptions
subscriptions.inContextNotifications
subscriptions.emailNotifications
Recuperar una lista de todas las alertas a las que está suscrito un usuario get-alert-subscription-list
Recupere una lista de todas las alertas a las que está suscrito un usuario realizando una solicitud de GET al extremo /alert-subscriptions/user-subscriptions/{EMAIL_ID}
. La respuesta incluye el nombre de la alerta, los ID, el estado, el tipo de alerta y los canales de notificación.
Formato de API
GET /alert-subscriptions/user-subscriptions/{EMAIL_ID}
{EMAIL_ID}
orderby
created
y updated
. Anteponga el nombre de la propiedad con +
para orden ascendente y -
para orden descendente. El valor predeterminado es -created
. Tenga en cuenta que el signo más (+
) debe especificarse como escape con %2B
. Por ejemplo %2Bcreated
es el valor de un orden creado ascendente.pagesize
page
property
Filtre los resultados en función de los campos seleccionados. Los filtros deben ser de escape de HTML. Las comas se utilizan para combinar varios conjuntos de filtros. Las siguientes propiedades permiten el filtrado:
- Identificación
- assetId
- estado
- alertType
Los operadores admitidos son ==
(igual a). Por ejemplo, id==6ebd9c2d-494d-425a-aa91-24033f3abeec
devolverá la alerta con un identificador coincidente.
Solicitud
curl -X GET 'https://platform.adobe.io/data/foundation/query/alert-subscriptions/user-subscriptions/rrunner@adobe.com' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-H 'x-sandbox-id: {SANDBOX_ID}'
Respuesta
Una respuesta correcta devuelve el estado HTTP 200 y la matriz items
con detalles de las alertas suscritas por el emailId
proporcionado.
{
"items": [
{
"name": "query_service_flow_run_success-8f057161-b312-4274-b629-f346c7d15c1f",
"assetId": "39e65373-e47a-4feb-9e5a-dffa2f677bca",
"status": "enabled",
"alertType": "success",
"subscriptions": {
"inContextNotification": true,
"emailNotifications": true
},
"_links": {
"self": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928",
"method": "GET"
},
"subscribe": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions",
"method": "POST",
"body": "{\"assetId\": \"queryId/scheduleId\", \"alertType\": \"start/success/failure\", \"subscriptions\": {\n\"emailIds\": [\"xyz@example.com\", \"abc@example.com\"], \"email\": true, \"inContext\": false}}"
},
"patch_status": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928/failure",
"method": "PATCH",
"body": "{ \"op\": \"replace\", \"path\": \"/status\", \"value\": \"enable/disable\" }"
},
"get_list_of_subscribers_by_alert_type": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928/failure",
"method": "GET"
},
"delete": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928/failure",
"method": "DELETE"
}
}
},
{
"name": "query_service_flow_run_start-8f057161-b312-4274-b629-f346c7d15c1f",
"assetId": "39e65373-e47a-4feb-9e5a-dffa2f677bca",
"status": "enabled",
"alertType": "start",
"subscriptions": {
"inContextNotification": true,
"emailNotifications": true
},
"_links": {
"self": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928",
"method": "GET"
},
"subscribe": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions",
"method": "POST",
"body": "{\"assetId\": \"queryId/scheduleId\", \"alertType\": \"start/success/failure\", \"subscriptions\": {\n\"emailIds\": [\"xyz@example.com\", \"abc@example.com\"], \"email\": true, \"inContext\": false}}"
},
"patch_status": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928/failure",
"method": "PATCH",
"body": "{ \"op\": \"replace\", \"path\": \"/status\", \"value\": \"enable/disable\" }"
},
"get_list_of_subscribers_by_alert_type": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928/failure",
"method": "GET"
},
"delete": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928/failure",
"method": "DELETE"
}
}
}
], "_page": {
"orderby": "-created",
"page": 1,
"count": 26,
"pageSize": 50
},
"_links": {
"next": {
"href": "https://platform-int.adobe.io/data/foundation/query/queries/alert-subscriptions?orderby=-created&page=2"
},
"prev": {
"href": "https://platform-int.adobe.io/data/foundation/query/queries/alert-subscriptions?orderby=-created&page=0"
}
},
"version": 1
}
name
alertType
y el ID de flujo. Encontrará información sobre las alertas disponibles en la documentación del panel de alertas de plataforma.assetId
status
enabled
, enabling
, disabled
y disabling
. Una alerta escucha activamente los eventos, se pone en pausa para un uso futuro mientras conserva todos los suscriptores y la configuración relevantes o realiza la transición entre estos estados.alertType
El tipo de alerta. Hay cinco estados de alerta disponibles para las consultas programadas, aunque solo hay cuatro estados de alerta disponibles para las consultas ad hoc. La alerta quarantine
solo está disponible para consultas programadas. Además, solo puede establecer la alerta delay
desde la interfaz de usuario de Platform. Por ese motivo delay
no se describe aquí. Las alertas disponibles son:
start
: notifica a un usuario cuando ha comenzado la ejecución de la consulta.success
: notifica al usuario cuando finaliza la consulta.failure
: notifica al usuario si la consulta falla.quarantine
: se activa cuando una ejecución de consulta programada se pone en estado de cuarentena.
subscriptions
subscriptions.inContextNotifications
true
confirma que las alertas deben proporcionarse a través de la interfaz de usuario. Un valor false
garantiza que los usuarios no reciban notificaciones a través de ese canal.subscriptions.emailNotifications
true
confirma que las alertas deben proporcionarse por correo electrónico. Un valor false
garantiza que los usuarios no reciban notificaciones a través de ese canal.Creación de una alerta y suscripción de usuarios subscribe-users
Para crear una alerta y suscribir a un usuario para recibirla, realice una solicitud POST
al extremo /alert-subscriptions
. Esta solicitud asocia una consulta a una alerta recién creada mediante una propiedad de assetId
y suscribe a los usuarios a las alertas de esa consulta mediante el uso de emailIds
.
Formato de API
POST /alert-subscriptions
Solicitud
curl -X POST https://platform.adobe.io/data/foundation/query/alert-subscriptions
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
-d '
{
"assetId": "a679dd0e-bcb2-4e69-a610-22d17ba98cac",
"alertType": "failure",
"subscriptions": {
"emailIds": [
"rrunner@adobe.com",
"jsnow@adobe.com"
],
"inContextNotifications": true,
"emailNotifications": true
}
}'
assetId
alertType
El tipo de alerta. Hay cinco estados de alerta disponibles para las consultas programadas, aunque solo hay cuatro estados de alerta disponibles para las consultas ad hoc. La alerta quarantine
solo está disponible para consultas programadas. Además, solo puede establecer la alerta delay
desde la interfaz de usuario de Platform. Por ese motivo delay
no se describe aquí. Las alertas disponibles son:
start
: notifica a un usuario cuando ha comenzado la ejecución de la consulta.success
: notifica al usuario cuando finaliza la consulta.failure
: notifica al usuario si la consulta falla.quarantine
: se activa cuando una ejecución de consulta programada se pone en estado de cuarentena.
subscriptions
subscriptions.emailIds
subscriptions.inContextNotifications
true
confirma que las alertas deben proporcionarse a través de la interfaz de usuario. Un valor false
garantiza que los usuarios no reciban notificaciones a través de ese canal.subscriptions.emailNotifications
true
confirma que las alertas deben proporcionarse por correo electrónico. Un valor false
garantiza que los usuarios no reciban notificaciones a través de ese canal.Respuesta
Una respuesta correcta devuelve el estado HTTP 202 (Aceptado) con detalles de la alerta recién creada.
{
"assetId": "c4f67291-1161-4943-bc29-8736469bb928",
"id": "query_service_flow_run_failure-5f4cb942-b67c-4ea4-a90d-5b6245e60aca",
"alertType": "failure",
"subscriptions": {
"emailIds": [
"{USER_EMAIL_ID}"
],
"inContextNotifications": false,
"emailNotifications": true
},
"_links": {
"self": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928",
"method": "GET"
},
"subscribe": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions",
"method": "POST",
"body": "{\"assetId\": \"queryId/scheduleId\", \"alertType\": \"start/success/failure\", \"subscriptions\": {\n\"emailIds\": [\"xyz@example.com\", \"abc@example.com\"], \"email\": true, \"inContext\": false}}"
},
"patch_status": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928/failure",
"method": "PATCH",
"body": "{ \"op\": \"replace\", \"path\": \"/status\", \"value\": \"enable/disable\" }"
},
"get_list_of_subscribers_by_alert_type": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928/failure",
"method": "GET"
},
"delete": {
"href": "https://platform.adobe.io/data/foundation/query/alert-subscriptions/c4f67291-1161-4943-bc29-8736469bb928/failure",
"method": "DELETE"
}
}
}
id
alertType
y el ID de flujo. Encontrará información sobre las alertas disponibles en la documentación del panel de alertas de plataforma._links
Habilitar o deshabilitar una alerta enable-or-disable-alert
Esta solicitud hace referencia a una alerta concreta mediante una consulta o un id. de programación y un tipo de alerta, y actualiza el estado de alerta a enable
o disable
. Puede actualizar el estado de una alerta realizando una solicitud PATCH
al extremo /alert-subscriptions/{queryId}/{alertType}
o /alert-subscriptions/{scheduleId}/{alertType}
.
Formato de API
PATCH /alert-subscriptions/{QUERY_ID}/{ALERT_TYPE}
PATCH /alert-subscriptions/{SCHEDULE_ID}/{ALERT_TYPE}
ALERT_TYPE
El tipo de alerta. Hay cinco estados de alerta disponibles para las consultas programadas, aunque solo hay cuatro estados de alerta disponibles para las consultas ad hoc. La alerta quarantine
solo está disponible para consultas programadas. Además, solo puede establecer la alerta delay
desde la interfaz de usuario de Platform. Por ese motivo delay
no se describe aquí. Las alertas disponibles son:
start
: notifica a un usuario cuando ha comenzado la ejecución de la consulta.success
: notifica al usuario cuando finaliza la consulta.failure
: notifica al usuario si la consulta falla.quarantine
: se activa cuando una ejecución de consulta programada se pone en estado de cuarentena.
Debe especificar el tipo de alerta actual en el área de nombres de extremo para cambiarlo.
QUERY_ID
SCHEDULE_ID
Solicitud
curl -X PATCH 'https://platform.adobe.io/data/foundation/query/alert-subscriptions/4422fc69-eaa7-464e-945b-63cfd435d3d1/start'' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
-H 'Content-Type: application/json' \
-H 'x-sandbox-id: {SANDBOX_ID}' \
-d '{
"op": "replace",
"path" : "/status",
"value": "enable"
}'
op
replace
.path
/status
.value
status
de la alerta. Actualmente, los valores aceptados son enable
o disable
.Respuesta
Una respuesta correcta devuelve el estado HTTP 200 con detalles del estado, el tipo y el ID de la alerta, así como la consulta a la que se relaciona.
{
"id" : "query_service_flow_run_success-4422fc69-eaa7-464e-945b-63cfd435d3d1",
"assetId": "4422fc69-eaa7-464e-945b-63cfd435d3d1",
"alertType": "start",
"status": "enabled"
}
id
alertType
y el ID de flujo. Encontrará información sobre las alertas disponibles en la documentación del panel de alertas de plataforma.assetId
alertType
Cada alerta puede tener tres tipos diferentes. Estos son:
start
: notifica a un usuario cuando ha comenzado la ejecución de la consulta.success
: notifica al usuario cuando finaliza la consulta.failure
: notifica al usuario si la consulta falla.
status
enabled
, enabling
, disabled
y disabling
. Una alerta escucha activamente los eventos, se pone en pausa para un uso futuro mientras conserva todos los suscriptores y la configuración relevantes o realiza la transición entre estos estados.Eliminar la alerta de una consulta y un tipo de alerta determinados delete-alert-info-by-id-and-alert-type
Elimine una alerta para una consulta o un id. de programación y un tipo de alerta determinados realizando una solicitud de DELETE al extremo /alert-subscriptions/{QUERY_ID}/{ALERT_TYPE}
o /alert-subscriptions/{SCHEDULE_ID}/{ALERT_TYPE}
.
DELETE /alert-subscriptions/{QUERY_ID}/{ALERT_TYPE}
DELETE /alert-subscriptions/{SCHEDULE_ID}/{ALERT_TYPE}
ALERT_TYPE
El tipo de alerta. Hay cinco estados de alerta disponibles para las consultas programadas, aunque solo hay cuatro estados de alerta disponibles para las consultas ad hoc. La alerta quarantine
solo está disponible para consultas programadas. Además, solo puede establecer la alerta delay
desde la interfaz de usuario de Platform. Por ese motivo delay
no se describe aquí. Las alertas disponibles son:
start
: notifica a un usuario cuando ha comenzado la ejecución de la consulta.success
: notifica al usuario cuando finaliza la consulta.failure
: notifica al usuario si la consulta falla.quarantine
: se activa cuando una ejecución de consulta programada se pone en estado de cuarentena.
La solicitud del DELETE solo se aplica al tipo de alerta específico proporcionado.
QUERY_ID
SCHEDULE_ID
Solicitud
curl -X DELETE 'https://platform.adobe.io/data/foundation/query/alert-subscriptions/4422fc69-eaa7-464e-945b-63cfd435d3d1/start' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-H 'x-sandbox-id: {SANDBOX_ID}'
Respuesta
Una respuesta correcta devuelve un estado HTTP 200 y un mensaje de confirmación que incluye el ID de recurso y el tipo de alerta de la alerta eliminada.
{
"message": "Alert Deleted Successfully for assetId: 6df22232-f427-4250-a4e1-43cd30990641 and alertType: success",
"statusCode": 200
}
Pasos siguientes
En esta guía se describe el uso del extremo /alert-subscriptions
en la API del servicio de consultas. Después de leer esta guía, tiene una mejor comprensión de cómo crear una alerta para una consulta, suscribir a los usuarios a la alerta, los tipos de alertas disponibles y cómo se puede recuperar, actualizar y eliminar la información de suscripción de alerta.
Consulte la guía de API del servicio de consultas para obtener más información sobre otras características y operaciones disponibles.