Skip to main content
Astra Automation
此產品有較新版本可以使用。
本繁體中文版使用機器翻譯，譯文僅供參考，若與英文版本牴觸，應以英文版本為準。

列出所有事件

PDF

GET /accounts/{account_id}/core/v1/events

傳回集合中所有符合資源的 JSON 陣列。如果在請求中指定了個別欄位，則項目 JSON 陣列將按指定順序包含每個相符資源所請求的欄位。

參數

Name 類型 在 必要 說明

account_id

字串

路徑

True

包含帳戶資源的 ID

  • 範例：{{.Account}}

包括

字串

查詢

錯誤

指示列出集合時應傳回哪些欄位。

URL 範例：「include=id」、「include=id,name」

OpenAPI 範例："id"

  • 範例：id、summary

限制

字串

查詢

錯誤

表示列出集合時要傳回的資源數量上限。

URL 範例：「limit=2」

OpenAPI 範例：「2」

篩選器

字串

查詢

錯誤

指示在列出集合時，為了傳回資源而應符合哪些欄位。

支援的運算子包括：

  • eq - 等式

  • lt/gt - 小於/大於

  • lte/gte - 小於或等於/大於或等於

URL 範例：「filter=field%20eq%20%27value%27」

OpenAPI 範例："field eq 'value'"

訂單者

字串

查詢

錯誤

指示列出集合時資源的排序順序。

URL 範例：「orderBy=name」、「orderBy=name%20desc」

OpenAPI 範例："name desc"

跳過

字串

查詢

錯誤

表示列出集合時要跳過的資源數量。

URL 範例：「skip=1」

OpenAPI 範例：「1」

數

字串

查詢

錯誤

指出中繼資料物件是否應傳回資源總數。

URL 範例：「count=true」

OpenAPI 範例："true"

繼續

查詢

錯誤

指示要從哪個權杖繼續列出。

URL 範例：「continue=」

OpenAPI 範例：""</continue>

回應

Status: 200, Returns a JSON array of all matching resources in the collection. If individual fields are specified in the request, the items JSON array will contain the fields requested for each matching resource in the order specified.
Name 類型 必要 說明

項目

array[任何： "event_1.4_get_response_body"、array[]]

True

中繼資料

"type_astra_metadata_list"

True
範例回應 
{
  "type": "application/astra-events",
  "version": "1.4",
  "items": [
    [
      "4f8273ee-883d-47f0-a512-9e27b6285f20",
      "Discovering Applications in Cluster"
    ],
    [
      "1cdd26dc-5eb0-4cf4-a0c1-39a9b83720e1",
      "Application Discovered"
    ],
    [
      "2064d1c1-4bc6-466e-9c30-b941a11be16a",
      "Application Discovery Failed"
    ],
    [
      "4325f971-ca9c-4a52-bc9a-da6ec62e6bfe",
      "Application Discovered"
    ]
  ],
  "metadata": {
    "labels": [],
    "creationTimestamp": "2022-10-06T20:58:16.305662Z",
    "modificationTimestamp": "2022-10-06T20:58:16.305662Z",
    "createdBy": "8f84cf09-8036-51e4-b579-bd30cb07b269"
  }
}

回應

Status: 401, Unauthorized
Name 類型 必要 說明

類型

字串

True

標題

字串

True

詳細資料

字串

True

狀態

字串

True

correlationID

字串

錯誤
範例回應 
{
  "type": "https://astra.netapp.io/problems/3",
  "title": "Missing bearer token",
  "detail": "The request is missing the required bearer token.",
  "status": "401"
}

回應

Status: 400, Bad request
Name 類型 必要 說明

類型

字串

True

標題

字串

True

詳細資料

字串

True

狀態

字串

True

correlationID

字串

錯誤

invalidParams

陣列["invalidParams"]

錯誤

無效查詢參數清單
範例回應 
{
  "type": "https://astra.netapp.io/problems/5",
  "title": "Invalid query parameters",
  "detail": "The supplied query parameters are invalid.",
  "status": "400"
}

回應

Status: 403, Forbidden
Name 類型 必要 說明

類型

字串

True

標題

字串

True

詳細資料

字串

True

狀態

字串

True

correlationID

字串

錯誤
範例回應 
{
  "type": "https://astra.netapp.io/problems/11",
  "title": "Operation not permitted",
  "detail": "The requested operation isn't permitted.",
  "status": "403"
}

錯誤

Status: 404, Not found
Name 類型 必要 說明

類型

字串

True

標題

字串

True

詳細資料

字串

True

狀態

字串

True

correlationID

字串

錯誤
範例錯誤回應 
{
  "type": "https://astra.netapp.io/problems/2",
  "title": "Collection not found",
  "detail": "The collection specified in the request URI wasn't found.",
  "status": "404"
}

定義

請參閱定義

資料

包含其他事件特定資訊的 JSON 物件。

Name 類型 必要 說明

ttl

數字

錯誤

JSON 數字，表示事件將保留的秒數（自 eventTime 起）。只有當事件在指定秒數後自動刪除時，才會包含此欄位。刪除時，如果事件有通知目標，則所有關聯的通知也會被刪除。刪除時，如果事件有橫幅目標，則橫幅也會被移除。如果此欄位不存在（或值為「0」），則表示事件不會自動刪除。

isAcknowledgeable

字串

錯誤

指示橫幅是否可關閉的 JSON 字串。定義的值為：

  • 「true」- 橫幅可關閉

  • 「false」- 橫幅無法關閉

type_astra_label

Name 類型 必要 說明

姓名

字串

True

值

字串

True

type_astra_metadata

與資源相關聯的用戶端和服務指定中繼資料。定義的值為：

  • 符合 Astra 中繼資料架構

Name 類型 必要 說明

標籤

陣列["type_astra_label"]

True

建立時間戳記

字串

True

修改時間戳記

字串

True

建立者

字串

True

modifiedBy

字串

錯誤

event_1.4_get_response_body

Name 類型 必要 說明

類型

字串

True

資源的媒體類型。定義的值為：

  • "application/astra-event"

版本

字串

True

資源版本。定義的值為：

  • "1.0"

  • "1.1"

  • "1.2"

  • "1.3"

  • "1.4"

ID

字串

True

資源的全域唯一識別碼。定義的值為：

  • 符合 UUIDv4 架構

姓名

字串

True

包含事件階層名稱（以點號 (.) 表示）的 JSON 字串。定義的值為：

  • 最短長度：3

  • 最大長度：127

  • 定義的正規表示式為："^[a-z])(\.([a-z])+$"

sequenceCount

數字

True

包含序列計數的 JSON 數字。每當收到新事件時，系統都會遞增此數字。

摘要

字串

True

包含事件簡短摘要（少於 40 個字元）的 JSON 字串。定義的值為：

  • 最短長度：3

  • 最大長度：79

eventTime

字串

True

包含時間戳記的 JSON 字串，用於指示事件發生的時間。定義的值為：

  • 符合 ISO-8601 日期時間架構

來源

字串

True

包含產生事件的服務名稱（小寫）的 JSON 字串。定義的值為：

  • 最短長度：1

  • 最大長度：19

  • 定義的正規表示式為："^([a-z-])*$"

resourceID

字串

True

包含與事件相關聯之資源 ID 的 JSON 字串。定義的值為：

  • 符合 Astra 識別符架構

其他資源 ID

陣列［string］

True

JSON 陣列，包含 JSON 字串，每個字串都包含與事件相關聯的其他資源的資源 ID。「resourceID」欄位包含與此事件相關聯的主要資源，而此欄位包含任意數量與相同事件相關聯的其他資源 ID。如果沒有其他資源與事件相關聯，則陣列將為空白。定義的值為：

  • 符合 Astra 識別符架構

resourceType

字串

True

包含與事件相關聯之資源媒體類型的 JSON 字串。定義的值為：

  • 最短長度：4

  • 最大長度：79

  • 定義的正規表示式為："^application\/astra-([a-zA-Z])+$"

correlationID

字串

True

包含 UUIDv4 關聯 ID 的 JSON 字串，可將相關事件分組在一起。定義的值為：

  • 符合 Astra 識別符架構

嚴重性

字串

True

包含以下值之一的 JSON 字串，用於指示事件的嚴重程度。定義的值為：

  • 「已清除」- 表示先前報告的描述某種狀況的事件已不再處於活動狀態。嚴重等級為「已清除」的事件將使用相同的摘要和關聯 ID，以便進行配對。

  • 「不確定」—表示無法確定嚴重性。

  • 「資訊性」- 表示狀態的變化是預期的，也是正常的（未在 X.733 中定義）。

  • 「警告」- 表示在感受到任何重大影響之前，偵測到潛在或即將發生的服務影響故障。

  • 「嚴重」- 表示已發生影響服務狀況的故障，需要立即採取糾正措施。「已清除」、「不確定」、「警告」和「嚴重」的定義是基於 CCITT X.733 第 8.1.2.3 條的定義。

類別

字串

True

包含以下值之一的 JSON 字串，用於指示事件的類別。定義的值為：

  • 「system」- 該事件與內部事件或請求相關。

  • 「user」- 該事件與使用者發起的事件或請求有關。

  • 「安全性」- 此事件與安全性問題相關。

描述

字串

True

包含事件詳細描述文字的 JSON 字串。定義的值為：

  • 最短長度：3

  • 最大長度：1023

描述 URL

字串

錯誤

包含 URL 的 JSON 字串，該 URL 用於啟用橫幅中的按鈕並將其連結到外部文件。定義的值為：

  • 最短長度：3

  • 最大長度：4095

correctiveAction

字串

錯誤

包含詳細描述文字的 JSON 字串，用於說明針對該事件必須採取的糾正措施。定義的值為：

  • 最短長度：3

  • 最大長度：1023

correctiveActionURL

字串

錯誤

包含 URL 的 JSON 字串，該 URL 將橫幅中的按鈕連結到 UI 中的頁面以修復問題。定義的值為：

  • 最短長度：3

  • 最大長度：4095

可見度

陣列［string］

錯誤

JSON 字串的 JSON 陣列，每個字串指示允許檢視事件的 RBAC 角色。角色以 OR 定義在一起。此參數為可選。如果省略，具有任何 RBAC 角色的使用者都可以檢視事件。定義的值為：

  • 最短長度：1

  • 最大長度：63

目的地

陣列［string］

錯誤

包含多個 JSON 字串的 JSON 陣列，每個字串指示事件的另一個目標位置。這些字串允許服務提供有關事件應路由至何處的提示，以及活動記錄。此參數為可選。定義的值為：

  • 「notification」- 該事件被標記為通知，可透過 notification API 端點存取。

  • 「banner」—該事件被標記為 banner。

  • 「support」－該事件被標記為支援相關事件。

resourceURI

字串

錯誤

包含與事件相關聯之 URI 的 JSON 字串。僅包含與 API 操作相關的事件。定義的值為：

  • 最短長度：3

  • 最大長度：4095

resourceCollectionURL

陣列［string］

錯誤

包含多個 JSON 字串的 JSON 陣列，每個字串表示與該事件關聯的資源的完整存取 URL。定義的值為：

  • 最短長度：1

  • 最大長度：1023

resourceMethod

字串

錯誤

包含所呼叫 HTTP 方法的 JSON 字串。僅包含與 API 操作相關的事件。定義的值為：

  • "options" - OPTIONS API 操作

  • "post" - POST API 作業

  • "get" - GET API 操作

  • "put" - PUT API 操作

  • 「刪除」- DELETE API 操作

resourceMethodResult

字串

錯誤

包含所呼叫 HTTP 方法結果的 JSON 字串。僅包含與 API 操作相關的事件。定義的值為：

  • 定義的正規表示式為："^[1-5][0-9]{2}$"

userID

字串

錯誤

包含與事件相關聯之使用者 ID 的 JSON 字串。僅包含與使用者發起之動作相關聯的事件。定義的值為：

  • 符合 Astra 識別符架構

accountID

字串

錯誤

包含與事件相關聯之帳戶 ID 的 JSON 字串。僅包含與帳戶相關聯的事件。定義的值為：

  • 符合 Astra 識別符架構

資料

"資料"

錯誤

包含其他事件特定資訊的 JSON 物件。

中繼資料

"type_astra_metadata"

True

與資源相關聯的用戶端和服務指定中繼資料。定義的值為：

  • 符合 Astra 中繼資料架構

type_astra_metadata_list

Name 類型 必要 說明

繼續

字串

錯誤

數

數字

錯誤

標籤

陣列["type_astra_label"]

錯誤

建立時間戳記

字串

錯誤

修改時間戳記

字串

錯誤

建立者

字串

錯誤

modifiedBy

字串

錯誤

invalidParams

Name 類型 必要 說明

姓名

字串

True

無效查詢參數的名稱

原因

字串

True

查詢參數無效的原因