IBM Cloud Docs
Comment puis-je aider l'assistance IBM à tracer ma demande d'API CLI?

Comment puis-je aider l'assistance IBM à tracer ma demande d'API CLI?

Lors de l'examen de problèmes liés à l'ILC, une traçabilité efficace dépend de la réception de données de demande complètes et correctement formatées. Le nouvel X-Request-ID en-tête dans l'interface CLI d' CIS améliore la transparence et la traçabilité entre les systèmes, ce qui permet au support technique d' IBM de localiser et de résoudre plus facilement les problèmes.

IBM Le support technique pourrait rencontrer des difficultés pour retracer certains appels API initiés par l'interface CLI si les identifiants de requête nécessaires ne figurent pas dans les journaux que vous partagez.

Bien que l'interface de programmation inclue automatiquement l'en-tête X-Request-ID dans chaque demande d'API, cette information peut être exclue par inadvertance lorsque vous collectez et partagez des journaux de suivi. Sans cela, les équipes d'assistance peuvent être dans l'incapacité de suivre la demande dans les systèmes dorsaux.

Pour permettre au support technique d' IBM de suivre et d'analyser correctement la demande, procédez comme suit lorsque vous capturez et partagez les journaux CLI :

  1. Activez la journalisation des traces à partir de l'interface CLI avant de reproduire le problème.

  2. Saisir et partager l'intégralité des journaux de demande et de réponse de l'API, y compris le site X-Request-ID et, s'il est disponible, le site X-Correlation-Id de la réponse.

  3. Recherchez des détails similaires à ceux qui suivent :

    REQUEST: [2025-07-17T19:47:24+05:30]
    POST /v1/crn:v1:staging:public:internet-svcs-ci:global:a/01652b251c3ae2787110a995d8db0135:1a9174b6-0106-417a-844b-c8eb43a72f63::/rules/lists HTTP/1.1
    Host: api-int.cis.dev.cloud.ibm.com
    Accept: application/json
    Authorization: [PRIVATE DATA HIDDEN]
    Content-Type: application/json
    X-Auth-User-Token: [PRIVATE DATA HIDDEN]
    
    {"name":"ac","kind":"asn"}
    
    RESPONSE: [2025-07-17T19:47:25+05:30] Elapsed: 1189ms
    HTTP/2.0 200 OK
    Cache-Control: no-cache, no-store, must-revalidate
    Cf-Cache-Status: DYNAMIC
    Cf-Ray: 960a5cd87e565520-DEL
    Content-Security-Policy: frame-ancestors 'none'; default-src 'self'; form-action 'self'
    Content-Type: application/json
    Date: Thu, 17 Jul 2025 14:17:25 GMT
    Server: cloudflare
    Strict-Transport-Security: max-age=31536000; includeSubdomains
    X-Content-Type-Options: nosniff
    X-Correlation-Id: f9e06c3c-8276-4436-9ad3-0bf63c27291c
    X-Envoy-Upstream-Service-Time: 842
    
  4. Joignez ces informations à votre demande d'assistance afin d'aider le service d'assistance IBM à isoler et à résoudre rapidement le problème.

    Veillez à expurger les données sensibles, telles que les jetons d'autorisation, avant de partager les journaux avec l'extérieur.