Skip to main content
Astra Automation
Une version plus récente de ce produit est disponible.
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Récupérer un événement

PDF

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

Renvoie la ressource Event API stockée dans le corps de la réponse JSON.

Paramètres

Nom Type Dans Obligatoire Description

identifiant_compte

chaîne

chemin

Vrai

ID de la ressource de compte conteneur

  • exemple: {{.Account}}

id_événement

chaîne

chemin

Vrai

ID de la collection d'événements à lister

Réponse

Status: 200, Returns the stored Event API resource in the JSON response body.
Nom Type Obligatoire Description

type

chaîne

Vrai

Type de média de la ressource. Les valeurs définies sont :

  • "application/astra-event"

version

chaîne

Vrai

Version de la ressource. Les valeurs définies sont :

  • "1,0"

  • "1,1"

  • "1,2"

  • "1,3"

  • "1,4"

id

chaîne

Vrai

Identifiant unique global de la ressource. Les valeurs définies sont :

  • Conforme au schéma UUIDv4

nom

chaîne

Vrai

Chaîne JSON contenant un nom hiérarchique pour l'événement en notation point (.). Les valeurs définies sont :

  • Longueur minimale : 3

  • Longueur maximale : 127

  • L'expression régulière définie est : "^[a-z])(\.([a-z])+$"

sequenceCount

nombre

Vrai

Numéro JSON contenant un compteur de séquence. Le numéro est incrémenté par le système à chaque fois qu’un nouvel événement est reçu.

résumé

chaîne

Vrai

Chaîne JSON contenant le résumé abrégé (moins de 40 caractères) de l'événement. Les valeurs définies sont :

  • Longueur minimale : 3

  • Longueur maximale : 79

eventTime

chaîne

Vrai

Chaîne JSON contenant un horodatage indiquant le moment où un événement s'est produit. Les valeurs définies sont :

  • Conforme au schéma de date et d'heure ISO-8601

source

chaîne

Vrai

Chaîne JSON contenant le nom en minuscules du service générant un événement. Les valeurs définies sont :

  • Longueur minimale : 1

  • Longueur maximale : 19

  • L'expression régulière définie est : "^([a-z-])*$"

identifiant de ressource

chaîne

Vrai

Chaîne JSON contenant l'identifiant de la ressource associée à un événement. Les valeurs définies sont :

  • Conforme au schéma d'identifiant Astra

identifiants de ressources supplémentaires

tableau[chaîne]

Vrai

Tableau JSON de chaînes de caractères JSON, chacune contenant un identifiant de ressource supplémentaire associée à l'événement. Alors que le champ « resourceID » contient la ressource principale associée à cet événement, ce champ contient n'importe quel nombre d'identifiants de ressources supplémentaires à associer aux mêmes événements. Si aucune ressource supplémentaire n'est associée à l'événement, le tableau sera vide. Les valeurs définies sont :

  • Conforme au schéma d'identifiant Astra

resourceType

chaîne

Vrai

Chaîne JSON contenant le type de média de la ressource associée à un événement. Les valeurs définies sont :

  • Longueur minimale : 4

  • Longueur maximale : 79

  • L'expression régulière définie est : "^application\/astra-([a-zA-Z])+$"

identifiant de corrélation

chaîne

Vrai

Chaîne JSON contenant un identifiant de corrélation UUIDv4 permettant de regrouper les événements associés. Les valeurs définies sont :

  • Conforme au schéma d'identifiant Astra

gravité

chaîne

Vrai

Chaîne JSON contenant l'une des valeurs suivantes indiquant la gravité d'un événement. Les valeurs définies sont :

  • « Résolu » : indique qu’un événement précédemment signalé décrivant une condition n’est plus actif. Un événement dont la gravité est « cleared » conservera le même résumé et le même identifiant de corrélation pour permettre son association.

  • « indeterminate » – Indique que la gravité ne peut pas être déterminée.

  • « informationnel » - Indique un changement d'état à la fois attendu et normal (non défini dans X.733).

  • « warning » : Indique la détection d’un défaut potentiel ou imminent affectant le service avant que des effets significatifs ne se fassent sentir.

  • « critical » : Indique qu’un incident affectant le service s’est produit et qu’une action corrective immédiate est requise. Les définitions de « cleared », « indeterminate », « warning » et « critical » sont basées sur les définitions de la clause 8.1.2.3 du CCITT X.733.

classe

chaîne

Vrai

Chaîne JSON contenant l'une des valeurs suivantes indiquant la classe de l'événement. Les valeurs définies sont :

  • « système » - L'événement est lié à un événement ou une requête interne.

  • « utilisateur » - L'événement est lié à une action ou une requête initiée par l'utilisateur.

  • « sécurité » - L'événement est lié à un problème de sécurité.

description

chaîne

Vrai

Chaîne JSON contenant un texte descriptif long concernant l'événement. Les valeurs définies sont :

  • Longueur minimale : 3

  • Longueur maximale : 1023

URL de description

chaîne

Faux

Chaîne JSON contenant l'URL qui active et lie un bouton de la bannière à la documentation externe. Les valeurs définies sont :

  • Longueur minimale : 3

  • Longueur maximale : 4095

correctiveAction

chaîne

Faux

Chaîne JSON contenant un texte descriptif détaillé sur les mesures correctives à prendre suite à l'événement. Les valeurs définies sont :

  • Longueur minimale : 3

  • Longueur maximale : 1023

URL de l'action corrective

chaîne

Faux

Chaîne JSON contenant l'URL qui relie un bouton de la bannière à une page de l'interface utilisateur permettant de résoudre le problème. Les valeurs définies sont :

  • Longueur minimale : 3

  • Longueur maximale : 4095

visibilité

tableau[chaîne]

Faux

Tableau JSON de chaînes JSON, chacune indiquant un rôle RBAC autorisé à consulter l'événement. Les rôles sont définis par un OU logique. Facultatif. Si omis, un utilisateur disposant de n'importe quel rôle RBAC peut consulter l'événement. Les valeurs définies sont :

  • Longueur minimale : 1

  • Longueur maximale : 63

destinations

tableau[chaîne]

Faux

Tableau JSON de chaînes JSON, chacune indiquant une destination supplémentaire pour l'événement. Ces chaînes permettent à un service de fournir des indications sur la destination d'un événement en complément du journal d'activité. Facultatif. Les valeurs définies sont :

  • « notification » - L'événement est marqué comme une notification et sera accessible via le point de terminaison de l'API de notifications.

  • "bannière" - L'événement est marqué comme une bannière.

  • « support » - L'événement est marqué comme un événement lié au support.

URI de ressource

chaîne

Faux

Chaîne JSON contenant l'URI associée à l'événement. Uniquement incluse pour les événements liés aux opérations d'API. Les valeurs définies sont :

  • Longueur minimale : 3

  • Longueur maximale : 4095

URL de la collection de ressources

tableau[chaîne]

Faux

Tableau JSON de chaînes JSON, chacune indiquant l'URL d'accès complète de la ressource associée à l'événement. Les valeurs définies sont :

  • Longueur minimale : 1

  • Longueur maximale : 1023

resourceMethod

chaîne

Faux

Chaîne JSON contenant la méthode HTTP appelée. Uniquement incluse pour les événements liés aux opérations d'API. Les valeurs définies sont :

  • "options" - Opération de l'API OPTIONS

  • "post" - Opération API POST

  • "get" - Opération API GET

  • « put » - Opération d'API PUT

  • « supprimer » - Opération d'API DELETE

resourceMethodResult

chaîne

Faux

Chaîne JSON contenant le résultat de la méthode HTTP appelée. Uniquement incluse pour les événements liés aux opérations de l'API. Les valeurs définies sont :

  • L'expression régulière définie est : "^[1-5][0-9]{2}$"

ID de l'utilisateur

chaîne

Faux

Chaîne JSON contenant l'identifiant utilisateur associé à un événement. Uniquement inclus pour les événements liés à des actions initiées par l'utilisateur. Les valeurs définies sont :

  • Conforme au schéma d'identifiant Astra

identifiant de compte

chaîne

Faux

Chaîne JSON contenant l'identifiant du compte associé à un événement. Uniquement inclus pour les événements associés à un compte. Les valeurs définies sont :

  • Conforme au schéma d'identifiant Astra

données

"données"

Faux

Objet JSON contenant des informations supplémentaires spécifiques à l'événement.

les métadonnées

"type_astra_metadata"

Vrai

Métadonnées spécifiques au client et au service associées à la ressource. Les valeurs définies sont :

  • Conforme au schéma de métadonnées Astra
Exemple de réponse 
{
  "type": "application/astra-event",
  "version": "1.4",
  "id": "c32df10b-8cfb-5a1e-9510-2a262b476009",
  "name": "astra.app.discovery.failed",
  "sequenceCount": 48923,
  "summary": "Application Discovery Failed",
  "eventTime": "2020-08-06T12:24:51.846543Z",
  "source": "composite-compute",
  "resourceID": "f670bf11-8850-44bd-b330-815af6186a06",
  "additionalResourceIDs": [
    "84dfee99-b7b2-46d2-9021-0a1a9a5df1d6",
    "abb32003-07b9-49b1-9938-1cf6d2f33566"
  ],
  "resourceType": "application/astra-app",
  "correlationID": "3c603442-cfca-4af9-9f1b-40dde5c7a806",
  "severity": "warning",
  "class": "user",
  "description": "Discovering the application 'mysql' was unsuccessful. K8s error 442. Application marked in state 'error'.",
  "resourceURI": "/accounts/fdaa655c-15ab-4d34-aa61-1e9098e67be0/topology/v1/managedClusters/dfd9de2d-6f0b-437b-a737-c8f7f176cd14/apps/f670bf11-8850-44bd-b330-815af6186a06",
  "resourceCollectionURL": [
    "https://www.astra.io/accounts/fdaa655c-15ab-4d34-aa61-1e9098e67be0/topology/v1/clouds/0df3f1a0-7203-4c12-aabf-a7bee6302671/clusters/dfd9de2d-6f0b-437b-a737-c8f7f176cd14/namespaces/f8b58091-4b9c-4c64-9b40-018dbaf7c5de/apps/f670bf11-8850-44bd-b330-815af6186a06",
    "https://www.astra.io/accounts/fdaa655c-15ab-4d34-aa61-1e9098e67be0/topology/v1/clouds/0df3f1a0-7203-4c12-aabf-a7bee6302671/clusters/dfd9de2d-6f0b-437b-a737-c8f7f176cd14/namespaces/923708f8-0435-45b5-8c00-fbdef3ffaf25/apps/f670bf11-8850-44bd-b330-815af6186a06"
  ],
  "userID": "abda967f-cd2c-4237-908e-99266648c553",
  "accountID": "f126d214-bccf-4558-86b4-2137a41e734f",
  "metadata": {
    "labels": [],
    "creationTimestamp": "2022-10-06T20:58:16.305662Z",
    "modificationTimestamp": "2022-10-06T20:58:16.305662Z",
    "createdBy": "8f84cf09-8036-51e4-b579-bd30cb07b269"
  }
}

Réponse

Status: 401, Unauthorized
Nom Type Obligatoire Description

type

chaîne

Vrai

titre

chaîne

Vrai

détail

chaîne

Vrai

statut

chaîne

Vrai

identifiant de corrélation

chaîne

Faux
Exemple de réponse 
{
  "type": "https://astra.netapp.io/problems/3",
  "title": "Missing bearer token",
  "detail": "The request is missing the required bearer token.",
  "status": "401"
}

Réponse

Status: 400, Bad request
Nom Type Obligatoire Description

type

chaîne

Vrai

titre

chaîne

Vrai

détail

chaîne

Vrai

statut

chaîne

Vrai

identifiant de corrélation

chaîne

Faux

invalidParams

tableau["invalidParams"]

Faux

Liste des paramètres de requête invalides
Exemple de réponse 
{
  "type": "https://astra.netapp.io/problems/5",
  "title": "Invalid query parameters",
  "detail": "The supplied query parameters are invalid.",
  "status": "400"
}

Réponse

Status: 403, Forbidden
Nom Type Obligatoire Description

type

chaîne

Vrai

titre

chaîne

Vrai

détail

chaîne

Vrai

statut

chaîne

Vrai

identifiant de corrélation

chaîne

Faux
Exemple de réponse 
{
  "type": "https://astra.netapp.io/problems/11",
  "title": "Operation not permitted",
  "detail": "The requested operation isn't permitted.",
  "status": "403"
}

Erreur

Status: 404, Not found
Nom Type Obligatoire Description

type

chaîne

Vrai

titre

chaîne

Vrai

détail

chaîne

Vrai

statut

chaîne

Vrai

identifiant de corrélation

chaîne

Faux
Exemple de réponse d'erreur 
{
  "type": "https://astra.netapp.io/problems/2",
  "title": "Collection not found",
  "detail": "The collection specified in the request URI wasn't found.",
  "status": "404"
}

Définitions

Voir les définitions

données

Objet JSON contenant des informations supplémentaires spécifiques à l'événement.

Nom Type Obligatoire Description

ttl

nombre

Faux

Nombre JSON indiquant le nombre de secondes (depuis le eventTime) pendant lesquelles l'événement sera conservé. Ce champ est uniquement inclus lorsque l'événement est automatiquement supprimé après le nombre de secondes spécifié. Lors de la suppression, si l'événement a une destination de notification, toutes les notifications associées sont également supprimées. Lors de la suppression, si l'événement a une destination de bannière, la bannière est également supprimée. L'absence de ce champ (ou une valeur de « 0 ») signifie qu'un événement ne sera pas automatiquement supprimé.

isAcknowledgeable

chaîne

Faux

Chaîne JSON indiquant si la bannière peut être masquée. Les valeurs définies sont :

  • "true" - La bannière est escamotable

  • « false » - La bannière ne peut pas être supprimée

type_astra_label

Nom Type Obligatoire Description

nom

chaîne

Vrai

valeur

chaîne

Vrai

type_astra_metadata

Métadonnées spécifiques au client et au service associées à la ressource. Les valeurs définies sont :

  • Conforme au schéma de métadonnées Astra

Nom Type Obligatoire Description

étiquettes

tableau["type_astra_label"]

Vrai

CréationTimestamp

chaîne

Vrai

ModificationTimestamp

chaîne

Vrai

CreatedBy

chaîne

Vrai

modifiedBy

chaîne

Faux

invalidParams

Nom Type Obligatoire Description

nom

chaîne

Vrai

Nom du paramètre de requête invalide

raison

chaîne

Vrai

Raison pour laquelle le paramètre de requête est invalide