baiducloud-python-sdk-bls 0.0.1__py3-none-any.whl

baiducloud_python_sdk_bls/__init__.py

@@ -0,0 +1,5 @@
+"""
+This module defines some common string constants.
+"""
+
+SDK_VERSION = b'0.0.1'

baiducloud_python_sdk_bls/api/bls_client.py

@@ -0,0 +1,378 @@
+"""
+Example for bls client.
+"""
+
+import copy
+import logging
+
+from baiducloud_python_sdk_core import utils, bce_base_client
+from baiducloud_python_sdk_core.auth import bce_v1_signer
+from baiducloud_python_sdk_core.bce_base_client import BceBaseClient
+from baiducloud_python_sdk_core.http import bce_http_client
+from baiducloud_python_sdk_core.http import handler
+from baiducloud_python_sdk_core.http import http_methods
+from baiducloud_python_sdk_bls.models.create_project_response import CreateProjectResponse
+from baiducloud_python_sdk_bls.models.delete_project_response import DeleteProjectResponse
+from baiducloud_python_sdk_bls.models.describe_project_response import DescribeProjectResponse
+from baiducloud_python_sdk_bls.models.list_project_response import ListProjectResponse
+from baiducloud_python_sdk_bls.models.pull_log_record_response import PullLogRecordResponse
+from baiducloud_python_sdk_bls.models.push_log_record_response import PushLogRecordResponse
+from baiducloud_python_sdk_bls.models.query_log_histogram_response import QueryLogHistogramResponse
+from baiducloud_python_sdk_bls.models.query_log_record_response import QueryLogRecordResponse
+from baiducloud_python_sdk_bls.models.update_project_response import UpdateProjectResponse
+
+_logger = logging.getLogger(__name__)
+
+
+class BlsClient(BceBaseClient):
+    """
+    bls base sdk client
+    """
+
+    VERSION_V1 = b'/v1'
+
+    VERSION_V2 = b'/v2'
+
+    CONSTANT_PROJECT = b'project'
+
+    CONSTANT_LOGSTORE = b'logstore'
+
+    CONSTANT_LOGRECORD = b'logrecord'
+
+    CONSTANT_LIST = b'list'
+
+    CONSTANT_LOGHISTOGRAM = b'loghistogram'
+
+    def __init__(self, config=None):
+        """
+        Initialize the bls client.
+
+        :param config: Client configuration
+        :type config: baidubce.BceClientConfiguration
+        """
+        bce_base_client.BceBaseClient.__init__(self, config)
+
+    def create_project(self, request, config=None):
+        """
+        create_project
+
+        :param request: Request entity containing all parameters
+        :type request: BlsClientRequest
+        :param config: Optional request configuration override
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+
+        :return: API response containing CreateProjectResponse data
+        :rtype: CreateProjectResponse
+
+        :raises BceClientError: Client error (network failure, invalid parameters, etc.)
+        :raises BceServerError: Server error (4xx/5xx HTTP status codes)
+        """
+        path = utils.append_uri(BlsClient.VERSION_V1, BlsClient.CONSTANT_PROJECT)
+        headers = None
+        merged_config = self._create_request_with_host(request, config)
+        return self._send_request(
+            http_methods.POST,
+            path=path,
+            body=request.to_json_string(),
+            config=merged_config,
+            model=CreateProjectResponse,
+        )
+
+    def delete_project(self, request, config=None):
+        """
+        delete_project
+
+        :param request: Request entity containing all parameters
+        :type request: BlsClientRequest
+        :param config: Optional request configuration override
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+
+        :return: API response containing DeleteProjectResponse data
+        :rtype: DeleteProjectResponse
+
+        :raises BceClientError: Client error (network failure, invalid parameters, etc.)
+        :raises BceServerError: Server error (4xx/5xx HTTP status codes)
+        """
+        path = utils.append_uri(BlsClient.VERSION_V1, BlsClient.CONSTANT_PROJECT, request.uuid)
+        headers = None
+        merged_config = self._create_request_with_host(request, config)
+        return self._send_request(http_methods.DELETE, path=path, config=merged_config, model=DeleteProjectResponse)
+
+    def describe_project(self, request, config=None):
+        """
+        describe_project
+
+        :param request: Request entity containing all parameters
+        :type request: BlsClientRequest
+        :param config: Optional request configuration override
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+
+        :return: API response containing DescribeProjectResponse data
+        :rtype: DescribeProjectResponse
+
+        :raises BceClientError: Client error (network failure, invalid parameters, etc.)
+        :raises BceServerError: Server error (4xx/5xx HTTP status codes)
+        """
+        path = utils.append_uri(BlsClient.VERSION_V1, BlsClient.CONSTANT_PROJECT, request.uuid)
+        headers = None
+        merged_config = self._create_request_with_host(request, config)
+        return self._send_request(http_methods.GET, path=path, config=merged_config, model=DescribeProjectResponse)
+
+    def list_project(self, request, config=None):
+        """
+        list_project
+
+        :param request: Request entity containing all parameters
+        :type request: BlsClientRequest
+        :param config: Optional request configuration override
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+
+        :return: API response containing ListProjectResponse data
+        :rtype: ListProjectResponse
+
+        :raises BceClientError: Client error (network failure, invalid parameters, etc.)
+        :raises BceServerError: Server error (4xx/5xx HTTP status codes)
+        """
+        path = utils.append_uri(BlsClient.VERSION_V1, BlsClient.CONSTANT_PROJECT, BlsClient.CONSTANT_LIST)
+        headers = None
+        merged_config = self._create_request_with_host(request, config)
+        return self._send_request(
+            http_methods.POST,
+            path=path,
+            body=request.to_json_string(),
+            config=merged_config,
+            model=ListProjectResponse,
+        )
+
+    def pull_log_record(self, request, config=None):
+        """
+        pull_log_record
+
+        :param request: Request entity containing all parameters
+        :type request: BlsClientRequest
+        :param config: Optional request configuration override
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+
+        :return: API response containing PullLogRecordResponse data
+        :rtype: PullLogRecordResponse
+
+        :raises BceClientError: Client error (network failure, invalid parameters, etc.)
+        :raises BceServerError: Server error (4xx/5xx HTTP status codes)
+        """
+        path = utils.append_uri(
+            BlsClient.VERSION_V1, BlsClient.CONSTANT_LOGSTORE, request.log_store_name, BlsClient.CONSTANT_LOGRECORD
+        )
+        headers = None
+        params = {}
+        if request.log_stream_name is not None:
+            params['logStreamName'] = request.log_stream_name
+        if request.start_date_time is not None:
+            params['startDateTime'] = request.start_date_time
+        if request.end_date_time is not None:
+            params['endDateTime'] = request.end_date_time
+        if request.project is not None:
+            params['project'] = request.project
+        if request.limit is not None:
+            params['limit'] = request.limit
+        if request.marker is not None:
+            params['marker'] = request.marker
+        merged_config = self._create_request_with_host(request, config)
+        return self._send_request(
+            http_methods.GET, path=path, params=params, config=merged_config, model=PullLogRecordResponse
+        )
+
+    def push_log_record(self, request, config=None):
+        """
+        push_log_record
+
+        :param request: Request entity containing all parameters
+        :type request: BlsClientRequest
+        :param config: Optional request configuration override
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+
+        :return: API response containing PushLogRecordResponse data
+        :rtype: PushLogRecordResponse
+
+        :raises BceClientError: Client error (network failure, invalid parameters, etc.)
+        :raises BceServerError: Server error (4xx/5xx HTTP status codes)
+        """
+        path = utils.append_uri(
+            BlsClient.VERSION_V1, BlsClient.CONSTANT_LOGSTORE, request.log_store_name, BlsClient.CONSTANT_LOGRECORD
+        )
+        headers = None
+        params = {}
+        if request.project is not None:
+            params['project'] = request.project
+        merged_config = self._create_request_with_host(request, config)
+        return self._send_request(
+            http_methods.POST,
+            path=path,
+            body=request.to_json_string(),
+            params=params,
+            config=merged_config,
+            model=PushLogRecordResponse,
+        )
+
+    def query_log_histogram(self, request, config=None):
+        """
+        query_log_histogram
+
+        :param request: Request entity containing all parameters
+        :type request: BlsClientRequest
+        :param config: Optional request configuration override
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+
+        :return: API response containing QueryLogHistogramResponse data
+        :rtype: QueryLogHistogramResponse
+
+        :raises BceClientError: Client error (network failure, invalid parameters, etc.)
+        :raises BceServerError: Server error (4xx/5xx HTTP status codes)
+        """
+        path = utils.append_uri(
+            BlsClient.VERSION_V2, BlsClient.CONSTANT_LOGSTORE, request.log_store_name, BlsClient.CONSTANT_LOGHISTOGRAM
+        )
+        headers = None
+        params = {}
+        if request.query is not None:
+            params['query'] = request.query
+        if request.start_date_time is not None:
+            params['startDateTime'] = request.start_date_time
+        if request.end_date_time is not None:
+            params['endDateTime'] = request.end_date_time
+        if request.project is not None:
+            params['project'] = request.project
+        if request.log_stream_name is not None:
+            params['logStreamName'] = request.log_stream_name
+        merged_config = self._create_request_with_host(request, config)
+        return self._send_request(
+            http_methods.GET, path=path, params=params, config=merged_config, model=QueryLogHistogramResponse
+        )
+
+    def query_log_record(self, request, config=None):
+        """
+        query_log_record
+
+        :param request: Request entity containing all parameters
+        :type request: BlsClientRequest
+        :param config: Optional request configuration override
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+
+        :return: API response containing QueryLogRecordResponse data
+        :rtype: QueryLogRecordResponse
+
+        :raises BceClientError: Client error (network failure, invalid parameters, etc.)
+        :raises BceServerError: Server error (4xx/5xx HTTP status codes)
+        """
+        path = utils.append_uri(
+            BlsClient.VERSION_V1, BlsClient.CONSTANT_LOGSTORE, request.log_store_name, BlsClient.CONSTANT_LOGRECORD
+        )
+        headers = None
+        params = {}
+        if request.query is not None:
+            params['query'] = request.query
+        if request.start_date_time is not None:
+            params['startDateTime'] = request.start_date_time
+        if request.end_date_time is not None:
+            params['endDateTime'] = request.end_date_time
+        if request.project is not None:
+            params['project'] = request.project
+        if request.log_stream_name is not None:
+            params['logStreamName'] = request.log_stream_name
+        if request.marker is not None:
+            params['marker'] = request.marker
+        if request.limit is not None:
+            params['limit'] = request.limit
+        if request.sort is not None:
+            params['sort'] = request.sort
+        if request.page_no is not None:
+            params['pageNo'] = request.page_no
+        if request.page_size is not None:
+            params['pageSize'] = request.page_size
+        merged_config = self._create_request_with_host(request, config)
+        return self._send_request(
+            http_methods.GET, path=path, params=params, config=merged_config, model=QueryLogRecordResponse
+        )
+
+    def update_project(self, request, config=None):
+        """
+        update_project
+
+        :param request: Request entity containing all parameters
+        :type request: BlsClientRequest
+        :param config: Optional request configuration override
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+
+        :return: API response containing UpdateProjectResponse data
+        :rtype: UpdateProjectResponse
+
+        :raises BceClientError: Client error (network failure, invalid parameters, etc.)
+        :raises BceServerError: Server error (4xx/5xx HTTP status codes)
+        """
+        path = utils.append_uri(BlsClient.VERSION_V1, BlsClient.CONSTANT_PROJECT)
+        headers = None
+        merged_config = self._create_request_with_host(request, config)
+        return self._send_request(
+            http_methods.PUT,
+            path=path,
+            body=request.to_json_string(),
+            config=merged_config,
+            model=UpdateProjectResponse,
+        )
+
+    def _merge_config(self, config=None):
+        """
+        :param config:
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+        """
+        if config is None:
+            return self.config
+        else:
+            new_config = copy.copy(self.config)
+            new_config.merge_non_none_values(config)
+            return new_config
+
+    def _send_request(
+        self, http_method, path, body=None, headers=None, params=None, config=None, body_parser=None, model=None
+    ):
+        """
+        Send an HTTP request to the service endpoint.
+
+        :param http_method: HTTP method (GET, POST, PUT, DELETE, etc.)
+        :type http_method: bytes
+        :param path: Request path
+        :type path: bytes
+        :param body: Optional request body
+        :type body: str or bytes
+        :param headers: Optional HTTP headers
+        :type headers: dict
+        :param params: Optional query parameters
+        :type params: dict
+        :param config: Optional request configuration override
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+        :param body_parser: Optional custom body parser function
+        :type body_parser: callable
+        :param model: Optional response model class for deserialization
+        :type model: class
+
+        :return: API response
+        :rtype: baiducloud_python_sdk_core.bce_response.BceResponse
+
+        :raises BceClientError: Client error (network connection failure, SSL errors, etc.)
+        :raises BceServerError: Server returned error response
+        """
+        config = self._merge_config(config)
+        if body_parser is None:
+            body_parser = handler.parse_json
+        if headers is None:
+            headers = {b'Accept': b'*/*', b'Content-Type': b'application/json;charset=utf-8'}
+        return bce_http_client.send_request(
+            config,
+            bce_v1_signer.sign,
+            [handler.parse_error, body_parser],
+            http_method,
+            path,
+            body,
+            headers,
+            params,
+            model=model,
+        )

baiducloud_python_sdk_bls/models/__init__.py

@@ -0,0 +1,33 @@
+"""
+Models for bls SDK.
+"""
+
+from .bucket import Bucket
+from .create_project_request import CreateProjectRequest
+from .create_project_response import CreateProjectResponse
+from .dataset_scan_info import DatasetScanInfo
+from .delete_project_response import DeleteProjectResponse
+from .describe_project_response import DescribeProjectResponse
+from .list_project_request import ListProjectRequest
+from .list_project_response import ListProjectResponse
+from .log_record import LogRecord
+from .log_tag import LogTag
+from .project import Project
+from .project_list_result import ProjectListResult
+from .project_result import ProjectResult
+from .pull_log_record_response import PullLogRecordResponse
+from .push_log_record_request import PushLogRecordRequest
+from .push_log_record_response import PushLogRecordResponse
+from .query_log_histogram_response import QueryLogHistogramResponse
+from .query_log_record_response import QueryLogRecordResponse
+from .result_set import ResultSet
+from .search_info import SearchInfo
+from .search_statistic import SearchStatistic
+from .statistics import Statistics
+from .update_project_request import UpdateProjectRequest
+from .update_project_response import UpdateProjectResponse
+from .describe_project_request import DescribeProjectRequest
+from .delete_project_request import DeleteProjectRequest
+from .query_log_record_request import QueryLogRecordRequest
+from .query_log_histogram_request import QueryLogHistogramRequest
+from .pull_log_record_request import PullLogRecordRequest

baiducloud_python_sdk_bls/models/bucket.py

@@ -0,0 +1,66 @@
+"""
+Bucket information
+"""
+
+from baiducloud_python_sdk_core.abstract_model import AbstractModel
+
+
+class Bucket(AbstractModel):
+    """
+    Bucket
+    """
+
+    def __init__(self, key=None, doc_count=None):
+        """
+        Initialize Bucket instance.
+
+        :param key: key attribute
+        :type key: int (optional)
+
+        :param doc_count: 时间区间内的文档数量
+        :type doc_count: int (optional)
+        """
+        super().__init__()
+        self.key = key
+        self.doc_count = doc_count
+
+    def to_dict(self):
+        """
+        Convert the model instance to a dictionary representation.
+
+        Nested model objects are recursively converted to dictionaries.
+
+        :return: Dictionary representation of the model
+        :rtype: dict
+        """
+        _map = super().to_dict()
+        if _map is not None:
+            return _map
+        result = dict()
+        if self.key is not None:
+            result['key'] = self.key
+        if self.doc_count is not None:
+            result['doc_count'] = self.doc_count
+        return result
+
+    def from_dict(self, m):
+        """
+        Populate the model instance from a dictionary.
+
+        Nested dictionaries are recursively converted to model objects.
+
+        :param m: Dictionary containing model data
+        :type m: dict
+
+        :return: Self reference for method chaining
+        :rtype: Bucket
+
+        :raises TypeError: If input is not a dictionary type
+        :raises ValueError: If nested model conversion fails
+        """
+        m = m or dict()
+        if m.get('key') is not None:
+            self.key = m.get('key')
+        if m.get('doc_count') is not None:
+            self.doc_count = m.get('doc_count')
+        return self

baiducloud_python_sdk_bls/models/create_project_request.py

@@ -0,0 +1,68 @@
+"""
+Request entity for CreateProjectRequest information.
+"""
+
+from baiducloud_python_sdk_core.abstract_model import AbstractModel
+
+
+class CreateProjectRequest(AbstractModel):
+    """
+    Request entity for CreateProjectRequest operation.
+
+    This class encapsulates all parameters for the API request.
+    """
+
+    def __init__(self, name, description=None):
+        """
+        Initialize CreateProjectRequest request entity.
+
+        :param name: 日志组名称
+        :type name: str (required)
+
+        :param description: 日志组描述
+        :type description: str (optional)
+        """
+        super().__init__()
+        self.name = name
+        self.description = description
+
+    def to_dict(self):
+        """
+        Convert the request entity to a dictionary representation.
+
+        Nested model objects are recursively converted to dictionaries.
+
+        :return: Dictionary representation of the request
+        :rtype: dict
+        """
+        _map = super().to_dict()
+        if _map is not None:
+            return _map
+        result = dict()
+        if self.name is not None:
+            result['name'] = self.name
+        if self.description is not None:
+            result['description'] = self.description
+        return result
+
+    def from_dict(self, m):
+        """
+        Populate the request entity from a dictionary.
+
+        Nested dictionaries are recursively converted to model objects.
+
+        :param m: Dictionary containing request data
+        :type m: dict
+
+        :return: Self reference for method chaining
+        :rtype: CreateProjectRequest
+
+        :raises TypeError: If input is not a dictionary or field type mismatch
+        :raises ValueError: If nested model conversion fails
+        """
+        m = m or dict()
+        if m.get('name') is not None:
+            self.name = m.get('name')
+        if m.get('description') is not None:
+            self.description = m.get('description')
+        return self

baiducloud_python_sdk_bls/models/create_project_response.py

@@ -0,0 +1,78 @@
+"""
+CreateProjectResponse information
+"""
+
+from baiducloud_python_sdk_core.bce_response import BceResponse
+
+
+class CreateProjectResponse(BceResponse):
+    """
+    CreateProjectResponse
+    """
+
+    def __init__(self, success=None, code=None, message=None):
+        """
+        Initialize CreateProjectResponse instance.
+
+        :param success: 请求是否成功
+        :type success: bool (optional)
+
+        :param code: 请求码，成功为OK，错误为具体的错误码
+        :type code: str (optional)
+
+        :param message: 请求成功为空，失败为具体的错误信息
+        :type message: str (optional)
+        """
+        super().__init__()
+        self.success = success
+        self.code = code
+        self.message = message
+
+    def to_dict(self):
+        """
+        Convert the model instance to a dictionary representation.
+
+        Nested model objects are recursively converted to dictionaries.
+
+        Includes metadata from the parent BceResponse class.
+
+        :return: Dictionary representation of the model
+        :rtype: dict
+        """
+        _map = super().to_dict()
+        if _map is not None:
+            return _map
+        result = dict()
+        if self.metadata is not None:
+            result['metadata'] = dict(self.metadata)
+        if self.success is not None:
+            result['success'] = self.success
+        if self.code is not None:
+            result['code'] = self.code
+        if self.message is not None:
+            result['message'] = self.message
+        return result
+
+    def from_dict(self, m):
+        """
+        Populate the model instance from a dictionary.
+
+        Nested dictionaries are recursively converted to model objects.
+
+        :param m: Dictionary containing model data
+        :type m: dict
+
+        :return: Self reference for method chaining
+        :rtype: CreateProjectResponse
+
+        :raises TypeError: If input is not a dictionary type
+        :raises ValueError: If nested model conversion fails
+        """
+        m = m or dict()
+        if m.get('success') is not None:
+            self.success = m.get('success')
+        if m.get('code') is not None:
+            self.code = m.get('code')
+        if m.get('message') is not None:
+            self.message = m.get('message')
+        return self