ジョブの同期状況を一覧表示
get
/cdi/integrations/{integration_id}/job_sync_status
このエンドポイントを使用して、指定した統合の過去の同期ステータスのリストを返します。
note:
このエンドポイントを使用するには、cdi.integration_job_status
パーミッションを持つ API キーを生成する必要があります。
レート制限
This endpoint has a rate limit of 100 requests per minute.
経路パラメータ
パラメータ|必須|データ型|説明 | |||
---|---|---|---|
integration_id |
必須 | 文字列 | 統合 ID。 |
クエリパラメーター
このエンドポイントを呼び出すと、10個のアイテムが返される。10回以上の同期がある統合では、次の応答例に示すように、Link
ヘッダーを使用して、次のページのデータを取得します。
パラメータ|必須|データ型|説明 |
---|
cursor |オプション|文字列|同期ステータスのページ分割を決定します。 |
リクエスト例
カーソルなし
1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/cdi/integrations/00000000-0000-0000-0000-000000000000/job_sync_status' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
カーソル付き
1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/cdi/integrations/00000000-0000-0000-0000-000000000000/job_sync_status?cursor=c2tpcDow' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
応答
成功応答例
ステータスコード200
、以下のレスポンスボディを返すことができる。
note:
Link
ヘッダーは、シンクの合計が10以下の場合は存在しない。カーソルのない通話では、prev
。アイテムの最後のページを見るとき、next
は表示されません。
1
Link: </cdi/integrations/00000000-0000-0000-0000-000000000000/job_sync_status?cursor=c2tpcDow>; rel="prev",</cdi/integrations00000000-0000-0000-0000-000000000000/job_sync_status?cursor=c2tpcDoxMDA=>; rel="next"
1
2
3
4
5
6
7
8
9
10
11
12
13
{
"results": [
{
"job_status": (string) status of the sync, see below for explanation of different statuses,
"sync_start_time": (string) time the sync started in ISO 8601,
"sync_finish_time": (string) time the sync finished in ISO 8601,
"last_timestamp_synced": (string) last UPDATED_AT timestamp processed by the sync in ISO 8601,
"rows_synced": (integer) number of rows successfully synced to Braze,
"rows_failed_with_errors": (integer) number of rows failed because of errors,
},
],
"message": "success"
}
|job_status|ジョブステータス
| — | — |
|running
| ジョブは現在実行中です。|
|success
|すべての行が正常に同期されました。|
|partial
| エラーにより一部の行の同期に失敗しました。|
|error
| 同期された行はありません。|
|config_error
|統合設定にエラーが発生しました。統合設定を確認してください。|
トラブルシューティング
次の表は、返される可能性のあるエラーと、それに関連するトラブルシューティングの手順を示したものです。
トラブルシューティング |
---|
400 Invalid cursor |cursor |が有効であることを確認する。 |
400 Invalid integration ID |integration_id |が有効であることを確認する。 |
その他のステータスコードと関連するエラーメッセージについては、致命的なエラーと応答を参照してください。