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

baiducloud_python_sdk_snic/__init__.py

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

baiducloud_python_sdk_snic/api/snic_client.py

@@ -0,0 +1,309 @@
+"""
+Example for snic 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_snic.models.create_snic_response import CreateSnicResponse
+from baiducloud_python_sdk_snic.models.describe_snic_response import DescribeSnicResponse
+from baiducloud_python_sdk_snic.models.list_snic_response import ListSnicResponse
+from baiducloud_python_sdk_snic.models.query_available_public_services_response import (
+    QueryAvailablePublicServicesResponse,
+)
+
+_logger = logging.getLogger(__name__)
+
+
+class SnicClient(BceBaseClient):
+    """
+    snic base sdk client
+    """
+
+    VERSION_V1 = b'/v1'
+
+    CONSTANT_ENDPOINT = b'endpoint'
+
+    CONSTANT_PUBLIC_SERVICE = b'publicService'
+
+    def __init__(self, config=None):
+        """
+        Initialize the snic client.
+
+        :param config: Client configuration
+        :type config: baidubce.BceClientConfiguration
+        """
+        bce_base_client.BceBaseClient.__init__(self, config)
+
+    def create_snic(self, request, config=None):
+        """
+        create_snic
+
+        :param request: Request entity containing all parameters
+        :type request: SnicClientRequest
+        :param config: Optional request configuration override
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+
+        :return: API response containing CreateSnicResponse data
+        :rtype: CreateSnicResponse
+
+        :raises BceClientError: Client error (network failure, invalid parameters, etc.)
+        :raises BceServerError: Server error (4xx/5xx HTTP status codes)
+        """
+        path = utils.append_uri(SnicClient.VERSION_V1, SnicClient.CONSTANT_ENDPOINT)
+        headers = None
+        params = {}
+        if request.client_token is not None:
+            params['clientToken'] = request.client_token
+        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=CreateSnicResponse,
+        )
+
+    def delete_snic(self, request, config=None):
+        """
+        delete_snic
+
+        :param request: Request entity containing all parameters
+        :type request: SnicClientRequest
+        :param config: Optional request configuration override
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+
+        :return: API response
+        :rtype: baiducloud_python_sdk_core.bce_response.BceResponse
+
+        :raises BceClientError: Client error (network failure, invalid parameters, etc.)
+        :raises BceServerError: Server error (4xx/5xx HTTP status codes)
+        """
+        path = utils.append_uri(SnicClient.VERSION_V1, SnicClient.CONSTANT_ENDPOINT, request.endpoint_id)
+        headers = None
+        params = {}
+        if request.client_token is not None:
+            params['clientToken'] = request.client_token
+        merged_config = self._create_request_with_host(request, config)
+        return self._send_request(http_methods.DELETE, path=path, params=params, config=merged_config)
+
+    def describe_snic(self, request, config=None):
+        """
+        describe_snic
+
+        :param request: Request entity containing all parameters
+        :type request: SnicClientRequest
+        :param config: Optional request configuration override
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+
+        :return: API response containing DescribeSnicResponse data
+        :rtype: DescribeSnicResponse
+
+        :raises BceClientError: Client error (network failure, invalid parameters, etc.)
+        :raises BceServerError: Server error (4xx/5xx HTTP status codes)
+        """
+        path = utils.append_uri(SnicClient.VERSION_V1, SnicClient.CONSTANT_ENDPOINT, request.endpoint_id)
+        headers = None
+        merged_config = self._create_request_with_host(request, config)
+        return self._send_request(http_methods.GET, path=path, config=merged_config, model=DescribeSnicResponse)
+
+    def list_snic(self, request, config=None):
+        """
+        list_snic
+
+        :param request: Request entity containing all parameters
+        :type request: SnicClientRequest
+        :param config: Optional request configuration override
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+
+        :return: API response containing ListSnicResponse data
+        :rtype: ListSnicResponse
+
+        :raises BceClientError: Client error (network failure, invalid parameters, etc.)
+        :raises BceServerError: Server error (4xx/5xx HTTP status codes)
+        """
+        path = utils.append_uri(SnicClient.VERSION_V1, SnicClient.CONSTANT_ENDPOINT)
+        headers = None
+        params = {}
+        if request.vpc_id is not None:
+            params['vpcId'] = request.vpc_id
+        if request.name is not None:
+            params['name'] = request.name
+        if request.ip_address is not None:
+            params['ipAddress'] = request.ip_address
+        if request.status is not None:
+            params['status'] = request.status
+        if request.subnet_id is not None:
+            params['subnetId'] = request.subnet_id
+        if request.service is not None:
+            params['service'] = request.service
+        if request.marker is not None:
+            params['marker'] = request.marker
+        if request.max_keys is not None:
+            params['maxKeys'] = request.max_keys
+        merged_config = self._create_request_with_host(request, config)
+        return self._send_request(
+            http_methods.GET, path=path, params=params, config=merged_config, model=ListSnicResponse
+        )
+
+    def query_available_public_services(self, config=None):
+        """
+        query_available_public_services
+        :param config: Optional request configuration override
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+
+        :return: API response containing QueryAvailablePublicServicesResponse data
+        :rtype: QueryAvailablePublicServicesResponse
+
+        :raises BceClientError: Client error (network failure, invalid parameters, etc.)
+        :raises BceServerError: Server error (4xx/5xx HTTP status codes)
+        """
+        path = utils.append_uri(
+            SnicClient.VERSION_V1, SnicClient.CONSTANT_ENDPOINT, SnicClient.CONSTANT_PUBLIC_SERVICE
+        )
+        headers = None
+        return self._send_request(
+            http_methods.GET, path=path, config=config, model=QueryAvailablePublicServicesResponse
+        )
+
+    def update_snic(self, request, config=None):
+        """
+        update_snic
+
+        :param request: Request entity containing all parameters
+        :type request: SnicClientRequest
+        :param config: Optional request configuration override
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+
+        :return: API response
+        :rtype: baiducloud_python_sdk_core.bce_response.BceResponse
+
+        :raises BceClientError: Client error (network failure, invalid parameters, etc.)
+        :raises BceServerError: Server error (4xx/5xx HTTP status codes)
+        """
+        path = utils.append_uri(SnicClient.VERSION_V1, SnicClient.CONSTANT_ENDPOINT, request.endpoint_id)
+        headers = None
+        params = {}
+        if request.client_token is not None:
+            params['clientToken'] = request.client_token
+        merged_config = self._create_request_with_host(request, config)
+        return self._send_request(
+            http_methods.PUT, path=path, body=request.to_json_string(), params=params, config=merged_config
+        )
+
+    def update_snic_esg(self, request, config=None):
+        """
+        update_snic_esg
+
+        :param request: Request entity containing all parameters
+        :type request: SnicClientRequest
+        :param config: Optional request configuration override
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+
+        :return: API response
+        :rtype: baiducloud_python_sdk_core.bce_response.BceResponse
+
+        :raises BceClientError: Client error (network failure, invalid parameters, etc.)
+        :raises BceServerError: Server error (4xx/5xx HTTP status codes)
+        """
+        path = utils.append_uri(SnicClient.VERSION_V1, SnicClient.CONSTANT_ENDPOINT, request.endpoint_id)
+        headers = None
+        params = {}
+        params['bindEsg'] = None
+        if request.client_token is not None:
+            params['clientToken'] = request.client_token
+        merged_config = self._create_request_with_host(request, config)
+        return self._send_request(
+            http_methods.PUT, path=path, body=request.to_json_string(), params=params, config=merged_config
+        )
+
+    def update_snic_sg(self, request, config=None):
+        """
+        update_snic_sg
+
+        :param request: Request entity containing all parameters
+        :type request: SnicClientRequest
+        :param config: Optional request configuration override
+        :type config: baiducloud_python_sdk_core.BceClientConfiguration
+
+        :return: API response
+        :rtype: baiducloud_python_sdk_core.bce_response.BceResponse
+
+        :raises BceClientError: Client error (network failure, invalid parameters, etc.)
+        :raises BceServerError: Server error (4xx/5xx HTTP status codes)
+        """
+        path = utils.append_uri(SnicClient.VERSION_V1, SnicClient.CONSTANT_ENDPOINT, request.endpoint_id)
+        headers = None
+        params = {}
+        params['bindSg'] = None
+        if request.client_token is not None:
+            params['clientToken'] = request.client_token
+        merged_config = self._create_request_with_host(request, config)
+        return self._send_request(
+            http_methods.PUT, path=path, body=request.to_json_string(), params=params, config=merged_config
+        )
+
+    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_snic/models/__init__.py

@@ -0,0 +1,19 @@
+"""
+Models for snic SDK.
+"""
+
+from .billing import Billing
+from .create_snic_request import CreateSnicRequest
+from .create_snic_response import CreateSnicResponse
+from .describe_snic_response import DescribeSnicResponse
+from .endpoint import Endpoint
+from .list_snic_response import ListSnicResponse
+from .query_available_public_services_response import QueryAvailablePublicServicesResponse
+from .reservation import Reservation
+from .tag_model import TagModel
+from .update_snic_esg_request import UpdateSnicEsgRequest
+from .update_snic_request import UpdateSnicRequest
+from .update_snic_sg_request import UpdateSnicSgRequest
+from .delete_snic_request import DeleteSnicRequest
+from .list_snic_request import ListSnicRequest
+from .describe_snic_request import DescribeSnicRequest

baiducloud_python_sdk_snic/models/billing.py

@@ -0,0 +1,68 @@
+"""
+Billing information
+"""
+
+from baiducloud_python_sdk_core.abstract_model import AbstractModel
+
+from baiducloud_python_sdk_snic.models.reservation import Reservation
+
+
+class Billing(AbstractModel):
+    """
+    Billing
+    """
+
+    def __init__(self, payment_timing=None, reservation=None):
+        """
+        Initialize Billing instance.
+
+        :param payment_timing: 付款时间，预支付（Prepaid）和后支付（Postpaid），创建订单需要设置，续费订单无需设置
+        :type payment_timing: str (optional)
+
+        :param reservation: reservation attribute
+        :type reservation: Reservation (optional)
+        """
+        super().__init__()
+        self.payment_timing = payment_timing
+        self.reservation = reservation
+
+    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.payment_timing is not None:
+            result['paymentTiming'] = self.payment_timing
+        if self.reservation is not None:
+            result['reservation'] = self.reservation.to_dict()
+        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: Billing
+
+        :raises TypeError: If input is not a dictionary type
+        :raises ValueError: If nested model conversion fails
+        """
+        m = m or dict()
+        if m.get('paymentTiming') is not None:
+            self.payment_timing = m.get('paymentTiming')
+        if m.get('reservation') is not None:
+            self.reservation = Reservation().from_dict(m.get('reservation'))
+        return self

baiducloud_python_sdk_snic/models/create_snic_request.py

@@ -0,0 +1,153 @@
+"""
+Request entity for CreateSnicRequest information.
+"""
+
+from baiducloud_python_sdk_core.abstract_model import AbstractModel
+from baiducloud_python_sdk_snic.models.billing import Billing
+from baiducloud_python_sdk_snic.models.tag_model import TagModel
+
+
+class CreateSnicRequest(AbstractModel):
+    """
+    Request entity for CreateSnicRequest operation.
+
+    This class encapsulates all parameters for the API request.
+    """
+
+    def __init__(
+        self,
+        vpc_id,
+        name,
+        subnet_id,
+        service,
+        bandwidth,
+        billing,
+        client_token=None,
+        description=None,
+        ip_address=None,
+        tags=None,
+        resource_group_id=None,
+    ):
+        """
+        Initialize CreateSnicRequest request entity.
+
+        :param client_token: client_token parameter
+        :type client_token: str (optional)
+
+        :param vpc_id: 所属vpc的id
+        :type vpc_id: str (required)
+
+        :param name: 服务网卡的名称，大小写字母、数字以及-_/.特殊字符、中文，必须以字母开头，长度1-65
+        :type name: str (required)
+
+        :param subnet_id: 所在子网的id
+        :type subnet_id: str (required)
+
+        :param service: 挂载的服务域名
+        :type service: str (required)
+
+        :param description: 服务网卡描述
+        :type description: str (optional)
+
+        :param ip_address: 指定服务网卡ip地址,不传自动分配ip地址
+        :type ip_address: str (optional)
+
+        :param bandwidth: 指定服务网卡带宽
+        :type bandwidth: int (required)
+
+        :param billing: billing parameter
+        :type billing: Billing (required)
+
+        :param tags: 标签
+        :type tags: List[TagModel] (optional)
+
+        :param resource_group_id: 资源组
+        :type resource_group_id: str (optional)
+        """
+        super().__init__()
+        self.client_token = client_token
+        self.vpc_id = vpc_id
+        self.name = name
+        self.subnet_id = subnet_id
+        self.service = service
+        self.description = description
+        self.ip_address = ip_address
+        self.bandwidth = bandwidth
+        self.billing = billing
+        self.tags = tags
+        self.resource_group_id = resource_group_id
+
+    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.vpc_id is not None:
+            result['vpcId'] = self.vpc_id
+        if self.name is not None:
+            result['name'] = self.name
+        if self.subnet_id is not None:
+            result['subnetId'] = self.subnet_id
+        if self.service is not None:
+            result['service'] = self.service
+        if self.description is not None:
+            result['description'] = self.description
+        if self.ip_address is not None:
+            result['ipAddress'] = self.ip_address
+        if self.bandwidth is not None:
+            result['bandwidth'] = self.bandwidth
+        if self.billing is not None:
+            result['billing'] = self.billing.to_dict()
+        if self.tags is not None:
+            result['tags'] = [i.to_dict() for i in self.tags]
+        if self.resource_group_id is not None:
+            result['resourceGroupId'] = self.resource_group_id
+        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: CreateSnicRequest
+
+        :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('clientToken') is not None:
+            self.client_token = m.get('clientToken')
+        if m.get('vpcId') is not None:
+            self.vpc_id = m.get('vpcId')
+        if m.get('name') is not None:
+            self.name = m.get('name')
+        if m.get('subnetId') is not None:
+            self.subnet_id = m.get('subnetId')
+        if m.get('service') is not None:
+            self.service = m.get('service')
+        if m.get('description') is not None:
+            self.description = m.get('description')
+        if m.get('ipAddress') is not None:
+            self.ip_address = m.get('ipAddress')
+        if m.get('bandwidth') is not None:
+            self.bandwidth = m.get('bandwidth')
+        if m.get('billing') is not None:
+            self.billing = Billing().from_dict(m.get('billing'))
+        if m.get('tags') is not None:
+            self.tags = [TagModel().from_dict(i) for i in m.get('tags')]
+        if m.get('resourceGroupId') is not None:
+            self.resource_group_id = m.get('resourceGroupId')
+        return self

baiducloud_python_sdk_snic/models/create_snic_response.py

@@ -0,0 +1,69 @@
+"""
+Request entity for CreateSnicResponse information.
+"""
+
+from baiducloud_python_sdk_core.bce_response import BceResponse
+
+
+class CreateSnicResponse(BceResponse):
+    """
+    CreateSnicResponse
+    """
+
+    def __init__(self, id=None, ip_address=None):
+        """
+        Initialize CreateSnicResponse response.
+
+        :param id: 服务网卡的id
+        :type id: str (optional)
+
+        :param ip_address: ip地址
+        :type ip_address: str (optional)
+        """
+        super().__init__()
+        self.id = id
+        self.ip_address = ip_address
+
+    def to_dict(self):
+        """
+        Convert the response instance to a dictionary representation.
+
+        Includes metadata from the parent BceResponse class.
+        Nested model objects are recursively converted to dictionaries.
+
+        :return: Dictionary representation of the response
+        :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.id is not None:
+            result['id'] = self.id
+        if self.ip_address is not None:
+            result['ipAddress'] = self.ip_address
+        return result
+
+    def from_dict(self, m):
+        """
+        Populate the response instance from a dictionary.
+
+        Nested dictionaries are recursively converted to model objects.
+
+        :param m: Dictionary containing response data
+        :type m: dict
+
+        :return: Self reference for method chaining
+        :rtype: CreateSnicResponse
+
+        :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('id') is not None:
+            self.id = m.get('id')
+        if m.get('ipAddress') is not None:
+            self.ip_address = m.get('ipAddress')
+        return self

baiducloud_python_sdk_snic/models/delete_snic_request.py

@@ -0,0 +1,64 @@
+"""
+Request entity for DeleteSnicRequest information.
+"""
+
+from baiducloud_python_sdk_core.abstract_model import AbstractModel
+
+
+class DeleteSnicRequest(AbstractModel):
+    """
+    Request entity for DeleteSnicRequest operation.
+
+    This class encapsulates all parameters for the API request.
+    """
+
+    def __init__(self, endpoint_id, client_token=None):
+        """
+        Initialize DeleteSnicRequest request entity.
+
+        :param endpoint_id: endpoint_id parameter
+        :type endpoint_id: str (required)
+
+        :param client_token: client_token parameter
+        :type client_token: str (optional)
+        """
+        super().__init__()
+        self.endpoint_id = endpoint_id
+        self.client_token = client_token
+
+    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()
+        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: DeleteSnicRequest
+
+        :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('endpointId') is not None:
+            self.endpoint_id = m.get('endpointId')
+        if m.get('clientToken') is not None:
+            self.client_token = m.get('clientToken')
+        return self