Endpoint "Alert Subscriptions"
Adobe Experience Platform Query Service consente di ricevere avvisi sia per le query ad hoc che per quelle pianificate. Gli avvisi possono essere ricevuti tramite e-mail, nell’interfaccia di Platform o in entrambe le modalità. Il contenuto della notifica è lo stesso per gli avvisi e-mail in-Platform.
Introduzione
Gli endpoint utilizzati in questa guida fanno parte dell'API Query Service di Adobe Experience Platform. Prima di continuare, consulta la guida introduttiva per informazioni importanti che devi conoscere per effettuare correttamente chiamate all'API, incluse le intestazioni richieste e la lettura delle chiamate API di esempio.
Tipi di avviso alert-types
La tabella seguente spiega i tipi di avviso per le query supportati:
delay
o Ritardo esecuzione query non è attualmente supportato dall'API del servizio query. Questo avviso notifica se si verifica un ritardo nell'esecuzione di una query pianificata oltre una soglia specificata. Per utilizzare questo avviso, è necessario impostare un'ora personalizzata che attivi un avviso quando la query viene eseguita per tale durata senza completare o non riuscire. Per informazioni su come impostare questo avviso nell'interfaccia utente, consulta la documentazione pianificazioni query o la guida alle azioni query in linea.start
success
failed
quarantine
Gli avvisi seguenti si applicano senza un abbonamento agli avvisi:
- Al termine di un processo di query batch, gli utenti ricevono una notifica.
- Quando la durata di un processo di query batch supera una soglia, viene attivato un avviso per la persona che ha pianificato la query.
Chiamate API di esempio
Le sezioni seguenti descrivono le varie chiamate API che è possibile effettuare utilizzando l’API di Query Service. Ogni chiamata include il formato API generale, una richiesta di esempio che mostra le intestazioni richieste e una risposta di esempio.
Recuperare un elenco di tutti gli avvisi per un’organizzazione e una sandbox get-list-of-org-alert-subs
Recuperare un elenco di tutti gli avvisi per una sandbox dell'organizzazione effettuando una richiesta GET all'endpoint /alert-subscriptions
.
Formato API
GET /alert-subscriptions
GET /alert-subscriptions?{QUERY_PARAMETERS}
{QUERY_PARAMETERS}
Parametri query
Di seguito è riportato un elenco dei parametri di query disponibili per l'elenco delle query. Tutti questi parametri sono facoltativi. Effettuando una chiamata a questo endpoint senza parametri, verranno recuperate tutte le query disponibili per la tua organizzazione.
orderby
created
e updated
. Anteporre il nome della proprietà con +
per crescente e -
per decrescente. Il valore predefinito è -created
. Il segno più (+
) deve essere preceduto da un carattere di escape con %2B
. Ad esempio %2Bcreated
è il valore per un ordine creato crescente.pagesize
page
property
Filtra i risultati in base ai campi selezionati. I filtri devono avere escape HTML. Le virgole vengono utilizzate per combinare più set di filtri. Le seguenti proprietà consentono l’applicazione di filtri:
- id
- assetId
- stato
- alertType
Gli operatori supportati sono ==
(uguale a). Ad esempio, id==6ebd9c2d-494d-425a-aa91-24033f3abeec
restituirà l'avviso con un ID corrispondente.
Richiesta
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}'
Risposta
In caso di esito positivo, la risposta restituisce lo stato HTTP 200 e l'array alerts
con informazioni sulla paginazione e sulla versione. L'array alerts
contiene i dettagli di tutti gli avvisi per un'organizzazione e una particolare sandbox. Per ogni risposta sono disponibili al massimo tre avvisi, uno per ogni tipo di avviso è contenuto nel corpo della risposta.
alerts._links
nell'array alerts
è stato troncato per brevità. Un esempio completo dell'oggetto alerts._links
è disponibile nella risposta della richiesta 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
e dall'ID di flusso. Le informazioni sugli avvisi disponibili sono disponibili nella documentazione del dashboard degli avvisi di Platform.alerts.status
enabled
, enabling
, disabled
e disabling
. Un avviso è l’ascolto attivo degli eventi, messo in pausa per utilizzi futuri mantenendo tutti gli abbonati e le impostazioni rilevanti, oppure la transizione tra questi stati.alerts.alertType
Tipo di avviso. Sono disponibili cinque stati di avviso per le query pianificate, anche se sono disponibili solo quattro stati di avviso per le query ad hoc. L'avviso quarantine
è disponibile solo per le query pianificate. Inoltre, è possibile impostare l'avviso delay
solo dall'interfaccia utente di Platform. Per questo motivo delay
non è descritto qui. Gli avvisi disponibili sono:
start
: notifica a un utente l'avvio dell'esecuzione della query.success
: invia una notifica all'utente al completamento della query.failure
: invia una notifica all'utente se la query non riesce.quarantine
: si attiva quando una query pianificata viene messa in quarantena.
alerts._links
_page
_links
Recuperare le informazioni sulla sottoscrizione dell’avviso per una particolare query o ID pianificazione retrieve-all-alert-subscriptions-by-id
Recuperare le informazioni sulla sottoscrizione dell'avviso per un ID di query o un ID di pianificazione specifico effettuando una richiesta di GET all'endpoint /alert-subscriptions/{QUERY_ID}
o /alert-subscriptions/{SCHEDULE_ID}
.
Formato API
GET /alert-subscriptions/{QUERY_ID}
GET /alert-subscriptions/{SCHEDULE_ID}
{QUERY_ID}
{SCHEDULE_ID}
Richiesta
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}'
Risposta
In caso di esito positivo, la risposta restituisce lo stato HTTP 200 e l’array alerts
che contiene le informazioni sulla sottoscrizione per l’ID di query o pianificazione fornito.
{
"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
e dall'ID di flusso. Le informazioni sugli avvisi disponibili sono disponibili nella documentazione del dashboard degli avvisi di Platform.status
enabled
, enabling
, disabled
e disabling
. Un avviso è l’ascolto attivo degli eventi, messo in pausa per utilizzi futuri mantenendo tutti gli abbonati e le impostazioni rilevanti, oppure la transizione tra questi stati.alertType
Ogni avviso può avere tre tipi diversi di avviso. Sono:
start
: notifica a un utente l'avvio dell'esecuzione della query.success
: invia una notifica all'utente al completamento della query.failure
: invia una notifica all'utente se la query non riesce.
subscriptions.emailNotifications
subscriptions.inContextNotifications
Recuperare le informazioni di sottoscrizione degli avvisi per una query o un ID pianificazione e un tipo di avviso specifici get-alert-info-by-id-and-alert-type
Recuperare le informazioni sulla sottoscrizione degli avvisi per un ID e un tipo di avviso specifici effettuando una richiesta di GET all'endpoint /alert-subscriptions/{QUERY_ID}/{ALERT_TYPE}
. Questo è applicabile sia agli ID query che a quelli pianificati.
Formato API
GET /alert-subscriptions/{QUERY_ID}/{ALERT_TYPE}
GET /alert-subscriptions/{SCHEDULE_ID}/{ALERT_TYPE}
ALERT_TYPE
Questa proprietà descrive lo stato di esecuzione della query che attiva un avviso. La risposta includerà solo le informazioni di abbonamento agli avvisi per avvisi di questo tipo. Ogni avviso può avere tre tipi diversi di avviso. Sono:
start
: notifica a un utente l'avvio dell'esecuzione della query.success
: invia una notifica all'utente al completamento della query.failure
: invia una notifica all'utente se la query non riesce.
QUERY_ID
SCHEDULE_ID
Richiesta
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}'
Risposta
In caso di esito positivo, la risposta restituisce lo stato HTTP 200 e tutti gli avvisi a cui è abbonato. Ciò include l’ID dell’avviso, il tipo di avviso, gli ID e-mail registrati dell’Adobe dell’abbonato e il relativo canale di notifica preferito.
{
"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
Tipo di avviso. Sono disponibili cinque stati di avviso per le query pianificate, anche se sono disponibili solo quattro stati di avviso per le query ad hoc. L'avviso quarantine
è disponibile solo per le query pianificate. Inoltre, è possibile impostare l'avviso delay
solo dall'interfaccia utente di Platform. Per questo motivo delay
non è descritto qui. Gli avvisi disponibili sono:
start
: notifica a un utente l'avvio dell'esecuzione della query.success
: invia una notifica all'utente al completamento della query.failure
: invia una notifica all'utente se la query non riesce.quarantine
: si attiva quando una query pianificata viene messa in quarantena.
subscriptions
subscriptions.inContextNotifications
subscriptions.emailNotifications
Recuperare un elenco di tutti gli avvisi a cui è abbonato un utente get-alert-subscription-list
Recuperare un elenco di tutti gli avvisi a cui un utente è abbonato effettuando una richiesta GET all'endpoint /alert-subscriptions/user-subscriptions/{EMAIL_ID}
. La risposta include il nome, gli ID, lo stato, il tipo di avviso e i canali di notifica dell’avviso.
Formato API
GET /alert-subscriptions/user-subscriptions/{EMAIL_ID}
{EMAIL_ID}
orderby
created
e updated
. Anteporre il nome della proprietà con +
per crescente e -
per decrescente. Il valore predefinito è -created
. Il segno più (+
) deve essere preceduto da un carattere di escape con %2B
. Ad esempio %2Bcreated
è il valore per un ordine creato crescente.pagesize
page
property
Filtra i risultati in base ai campi selezionati. I filtri devono avere escape HTML. Le virgole vengono utilizzate per combinare più set di filtri. Le seguenti proprietà consentono il filtraggio:
- id
- assetId
- stato
- alertType
Gli operatori supportati sono ==
(uguale a). Ad esempio, id==6ebd9c2d-494d-425a-aa91-24033f3abeec
restituirà l'avviso con un ID corrispondente.
Richiesta
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}'
Risposta
In caso di esito positivo, la risposta restituisce lo stato HTTP 200 e l’array items
con i dettagli degli avvisi a cui è abbonato emailId
fornito.
{
"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
e dall'ID di flusso. Le informazioni sugli avvisi disponibili sono disponibili nella documentazione del dashboard degli avvisi di Platform.assetId
status
enabled
, enabling
, disabled
e disabling
. Un avviso è l’ascolto attivo degli eventi, messo in pausa per utilizzi futuri mantenendo tutti gli abbonati e le impostazioni rilevanti, oppure la transizione tra questi stati.alertType
Tipo di avviso. Sono disponibili cinque stati di avviso per le query pianificate, anche se sono disponibili solo quattro stati di avviso per le query ad hoc. L'avviso quarantine
è disponibile solo per le query pianificate. Inoltre, è possibile impostare l'avviso delay
solo dall'interfaccia utente di Platform. Per questo motivo delay
non è descritto qui. Gli avvisi disponibili sono:
start
: notifica a un utente l'avvio dell'esecuzione della query.success
: invia una notifica all'utente al completamento della query.failure
: invia una notifica all'utente se la query non riesce.quarantine
: si attiva quando una query pianificata viene messa in quarantena.
subscriptions
subscriptions.inContextNotifications
true
conferma che gli avvisi devono essere forniti tramite l'interfaccia utente. Un valore false
garantisce che gli utenti non ricevano notifiche tramite tale canale.subscriptions.emailNotifications
true
conferma che gli avvisi devono essere forniti tramite e-mail. Un valore false
garantisce che gli utenti non ricevano notifiche tramite tale canale.Creare un avviso e abbonare gli utenti subscribe-users
Per creare un avviso e sottoscrivere un utente per riceverlo, effettuare una richiesta POST
all'endpoint /alert-subscriptions
. Questa richiesta associa una query a un avviso appena creato utilizzando una proprietà assetId
e sottoscrive gli utenti agli avvisi per tale query tramite l'utilizzo di emailIds
.
Formato API
POST /alert-subscriptions
Richiesta
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
Tipo di avviso. Sono disponibili cinque stati di avviso per le query pianificate, anche se sono disponibili solo quattro stati di avviso per le query ad hoc. L'avviso quarantine
è disponibile solo per le query pianificate. Inoltre, è possibile impostare l'avviso delay
solo dall'interfaccia utente di Platform. Per questo motivo delay
non è descritto qui. Gli avvisi disponibili sono:
start
: notifica a un utente l'avvio dell'esecuzione della query.success
: invia una notifica all'utente al completamento della query.failure
: invia una notifica all'utente se la query non riesce.quarantine
: si attiva quando una query pianificata viene messa in quarantena.
subscriptions
subscriptions.emailIds
subscriptions.inContextNotifications
true
conferma che gli avvisi devono essere forniti tramite l'interfaccia utente. Un valore false
garantisce che gli utenti non ricevano notifiche tramite tale canale.subscriptions.emailNotifications
true
conferma che gli avvisi devono essere forniti tramite e-mail. Un valore false
garantisce che gli utenti non ricevano notifiche tramite tale canale.Risposta
In caso di esito positivo, la risposta restituisce lo stato HTTP 202 (Accettato) con i dettagli dell’avviso appena creato.
{
"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
e dall'ID di flusso. Le informazioni sugli avvisi disponibili sono disponibili nella documentazione del dashboard degli avvisi di Platform._links
Attivare o disattivare un avviso enable-or-disable-alert
Questa richiesta fa riferimento a un determinato avviso utilizzando un ID di query o pianificazione e un tipo di avviso e aggiorna lo stato dell'avviso a enable
o disable
. È possibile aggiornare lo stato di un avviso effettuando una richiesta PATCH
all'endpoint /alert-subscriptions/{queryId}/{alertType}
o /alert-subscriptions/{scheduleId}/{alertType}
.
Formato API
PATCH /alert-subscriptions/{QUERY_ID}/{ALERT_TYPE}
PATCH /alert-subscriptions/{SCHEDULE_ID}/{ALERT_TYPE}
ALERT_TYPE
Tipo di avviso. Sono disponibili cinque stati di avviso per le query pianificate, anche se sono disponibili solo quattro stati di avviso per le query ad hoc. L'avviso quarantine
è disponibile solo per le query pianificate. Inoltre, è possibile impostare l'avviso delay
solo dall'interfaccia utente di Platform. Per questo motivo delay
non è descritto qui. Gli avvisi disponibili sono:
start
: notifica a un utente l'avvio dell'esecuzione della query.success
: invia una notifica all'utente al completamento della query.failure
: invia una notifica all'utente se la query non riesce.quarantine
: si attiva quando una query pianificata viene messa in quarantena.
È necessario specificare il tipo di avviso corrente nello spazio dei nomi dell'endpoint per modificarlo.
QUERY_ID
SCHEDULE_ID
Richiesta
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
dell'avviso. Attualmente, i valori accettati sono enable
o disable
.Risposta
In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con i dettagli dello stato, del tipo e dell’ID dell’avviso, nonché la query a cui si riferisce.
{
"id" : "query_service_flow_run_success-4422fc69-eaa7-464e-945b-63cfd435d3d1",
"assetId": "4422fc69-eaa7-464e-945b-63cfd435d3d1",
"alertType": "start",
"status": "enabled"
}
id
alertType
e dall'ID di flusso. Le informazioni sugli avvisi disponibili sono disponibili nella documentazione del dashboard degli avvisi di Platform.assetId
alertType
Ogni avviso può avere tre tipi diversi di avviso. Sono:
start
: notifica a un utente l'avvio dell'esecuzione della query.success
: invia una notifica all'utente al completamento della query.failure
: invia una notifica all'utente se la query non riesce.
status
enabled
, enabling
, disabled
e disabling
. Un avviso è l’ascolto attivo degli eventi, messo in pausa per utilizzi futuri mantenendo tutti gli abbonati e le impostazioni rilevanti, oppure la transizione tra questi stati.Eliminare l'avviso per una query e un tipo di avviso specifici delete-alert-info-by-id-and-alert-type
Eliminare un avviso per un determinato ID di query o pianificazione e tipo di avviso effettuando una richiesta DELETE all'endpoint /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
Tipo di avviso. Sono disponibili cinque stati di avviso per le query pianificate, anche se sono disponibili solo quattro stati di avviso per le query ad hoc. L'avviso quarantine
è disponibile solo per le query pianificate. Inoltre, è possibile impostare l'avviso delay
solo dall'interfaccia utente di Platform. Per questo motivo delay
non è descritto qui. Gli avvisi disponibili sono:
start
: notifica a un utente l'avvio dell'esecuzione della query.success
: invia una notifica all'utente al completamento della query.failure
: invia una notifica all'utente se la query non riesce.quarantine
: si attiva quando una query pianificata viene messa in quarantena.
La richiesta DELETE si applica solo al tipo di avviso specifico fornito.
QUERY_ID
SCHEDULE_ID
Richiesta
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}'
Risposta
In caso di esito positivo, la risposta restituisce lo stato HTTP 200 e un messaggio di conferma che include l’ID della risorsa e il tipo di avviso dell’avviso eliminato.
{
"message": "Alert Deleted Successfully for assetId: 6df22232-f427-4250-a4e1-43cd30990641 and alertType: success",
"statusCode": 200
}
Passaggi successivi
Questa guida descrive l'utilizzo dell'endpoint /alert-subscriptions
nell'API Query Service. Dopo aver letto questa guida, avrai acquisito maggiori informazioni su come creare un avviso per una query, abbonare gli utenti all’avviso, i tipi di avvisi disponibili e come recuperare, aggiornare ed eliminare le informazioni di abbonamento agli avvisi.
Per ulteriori informazioni su altre funzioni e operazioni disponibili, consulta la guida API di Query Service.