Taegis SDK for Python における非推奨機能🔗

Taegis SDK for Python は、Taegis API 内の非推奨項目に対する警告をサポートするようになりました。これらの警告は、API の今後の変更についてユーザーや開発者に通知し、サポートされている機能への移行のための十分な時間を提供することを目的としています。非推奨となったフィールドやエンドポイントは、いつでも変更される可能性があります。

非推奨警告の種類:

入力フィールドの警告: API に送信される入力フィールドに対する警告。
出力フィールドの警告: API から返される出力フィールドに対する警告。
エンドポイントの警告: API エンドポイント全体が非推奨となった場合の警告。

非推奨の入力フィールド🔗

SDK は、非推奨の入力フィールドを変更したり修正したりしませんが、これらはいつでも削除される可能性があります。

これらの警告のログ出力は、以下の方法で無効にできます:

import logging

logging.getLogger("taegis_sdk_python.utils").setLevel(logging.ERROR)

非推奨の出力フィールド🔗

Taegis SDK for Python は、生成されるフィールドから非推奨の出力フィールドを削除します。非推奨フィールドが引き続き必要な場合は、GraphQLService コンテキストマネージャ内で output フィールドを変更することで含めることができます。非推奨フィールドのログ出力は引き続き利用可能です。

例:

from taegis_sdk_python import GraphQLService
import logging

service = GraphQLService()
results = service.investigations.query.all_investigations(
    page=1,
    per_page=3,
)
print(results[0].assignee)

GraphQL Query `allInvestigations` is deprecated: 'replaced by investigationsSearch'
Output field `activity_logs` is deprecated: 'Not Supported - Use audit logs', removing from default output...
Output field `assignee` is deprecated: 'No longer supported', removing from default output...
None

from taegis_sdk_python import GraphQLService

service = GraphQLService()

with service(output='id tenant_id ... assignee { id name ... }'):
    results = service.investigations.query.all_investigations(
        page=1,
        per_page=3,
    )
print(results[0].assignee)

注: 可読性のため出力は省略されています。

...
Output field `assignee` is deprecated: 'No longer supported', removing from default output...
Assignee(id='<id>', name='<name>', roles=None, status=None, user_id=None, email=None, email_verified=None, email_normalized=None, family_name=None, given_name=None, tenants=None)

これらの警告のログ出力は、以下の方法で無効にできます:

import logging

logging.getLogger("taegis_sdk_python.utils").setLevel(logging.ERROR)

非推奨のエンドポイント🔗

Taegis SDK for Python は、非推奨のエンドポイントを変更したり修正したりしませんが、これらはいつでも削除される可能性があります。

これらの警告のログ出力は、以下の方法で無効にできます:

すべてのエンドポイント警告:

import logging

logging.getLogger("taegis_sdk_python.services").setLevel(logging.ERROR)

特定のサービス警告:

import logging

# logging.getLogger("taegis_sdk_python.services.<service>").setLevel(logging.ERROR)

logging.getLogger("taegis_sdk_python.services.investigations").setLevel(logging.ERROR)

特定のサービス種別警告:

import logging

# logging.getLogger("taegis_sdk_python.services.<service>.<type>").setLevel(logging.ERROR)

logging.getLogger("taegis_sdk_python.services.investigations.queries").setLevel(logging.ERROR)

追加リソース🔗

ログ出力の処理方法に関する追加オプションは、Python ドキュメントをご参照ください。