Add new api for private_nat gateways. Only querying list

Author: shhovhan

doc/source/cli/index.rst

@@ -43,6 +43,7 @@ documentation of these services:
    modelarts
    nat
    obs
+   privatenat
    rds_v3
    sdrs
    smn

doc/source/cli/privatenat.rst

@@ -0,0 +1,19 @@
+Private Network Address Translation (Private NAT)
+=================================================
+
+The Private NAT client is the command-line interface (CLI) for
+the Private NAT API.
+
+For help on a specific `privatenat` command, enter:
+
+.. code-block:: console
+
+   $ openstack privatenat help SUBCOMMAND
+
+.. _private_gateway:
+
+Private NAT Gateway Operations
+------------------------------
+
+.. autoprogram-cliff:: openstack.privatenat.v3
+   :command: privatenat gateway *

doc/source/sdk/proxies/index.rst

@@ -29,6 +29,7 @@ Service Proxies
    MapReduce Service (MRS) <mrs>
    Modelarts Service (ModelArts) <modelarts>
    Network Address Translation (NAT) <nat>
+   Private Network Address Translation (Private NAT) <privatenat>
    Object Block Storage (OBS) <obs>
    Relational Database Service RDS V1 (RDSv1) <rds_v1>
    Relational Database Service RDS V3 (RDS) <rds_v3>

doc/source/sdk/proxies/privatenat.rst

@@ -0,0 +1,19 @@
+Private NAT API
+===============
+
+.. automodule:: otcextensions.sdk.natv3.v3._proxy
+
+The Private NAT high-level interface
+------------------------------------
+
+The private NAT high-level interface is available through the ``natv3``
+member of a :class:`~openstack.connection.Connection` object. The
+``natv3`` member will only be added if the
+``otcextensions.sdk.register_otc_extensions(conn)`` method is called.
+
+Private NAT Gateway Operations
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: otcextensions.sdk.natv3.v3._proxy.Proxy
+  :noindex:
+  :members: private_nat_gateways

doc/source/sdk/resources/index.rst

@@ -30,6 +30,7 @@ Open Telekom Cloud Resources
    MapReduce Service (MRS) <mrs/index>
    ModelArts Service (MA) <modelarts/index>
    Network Address Translation (NAT) <nat/index>
+   Private Network Address Translation (Private NAT) <privatenat/index>
    Object Block Storage (OBS) <obs/index>
    Relational Database Service (RDS) <rds/index>
    Shared File System Turbo (SFS Turbo) <sfsturbo/index>

doc/source/sdk/resources/privatenat/index.rst

@@ -0,0 +1,7 @@
+Private NAT Resources
+=====================
+
+.. toctree::
+   :maxdepth: 1
+
+   v3/private_gateway

doc/source/sdk/resources/privatenat/v3/private_gateway.rst

@@ -0,0 +1,13 @@
+otcextensions.sdk.natv3.v3.gateway
+==================================
+
+.. automodule:: otcextensions.sdk.natv3.v3.gateway
+
+The Private NAT Gateway Class
+-----------------------------
+
+The ``PrivateNatGateway`` class inherits from
+:class:`~openstack.resource.Resource`.
+
+.. autoclass:: otcextensions.sdk.natv3.v3.gateway.PrivateNatGateway
+   :members:

examples/natv3/list_private_gateways.py

@@ -0,0 +1,23 @@
+#!/usr/bin/env python3
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+"""
+List all Private NAT Gateways
+"""
+import openstack
+
+
+openstack.enable_logging(True)
+conn = openstack.connect(cloud='otc')
+
+for gateway in conn.natv3.private_nat_gateways():
+    print(gateway)

otcextensions/osclient/privatenat/__init__.py

@@ -0,0 +1,52 @@
+#   Licensed under the Apache License, Version 2.0 (the "License"); you may
+#   not use this file except in compliance with the License. You may obtain
+#   a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#   Unless required by applicable law or agreed to in writing, software
+#   distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+#   WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+#   License for the specific language governing permissions and limitations
+#   under the License.
+#
+import logging
+
+from osc_lib import utils
+
+from otcextensions import sdk
+from otcextensions.i18n import _
+
+LOG = logging.getLogger(__name__)
+
+DEFAULT_API_VERSION = '3'
+API_VERSION_OPTION = 'os_privatenat_api_version'
+API_NAME = "privatenat"
+API_VERSIONS = {
+    "3": "openstack.connection.Connection"
+}
+
+
+def make_client(instance):
+    """Returns a private NAT proxy"""
+    conn = instance.sdk_connection
+
+    if getattr(conn, 'natv3', None) is None:
+        LOG.debug('OTC extensions are not registered. Do that now')
+        sdk.register_otc_extensions(conn)
+
+    LOG.debug('Private NAT client initialized using OpenStack OTC SDK: %s',
+              conn.natv3)
+    return conn.natv3
+
+
+def build_option_parser(parser):
+    """Hook to add global options"""
+    parser.add_argument(
+        '--os-privatenat-api-version',
+        metavar='<privatenat-api-version>',
+        default=utils.env('OS_PRIVATENAT_API_VERSION'),
+        help=_("Private NAT API version, default=%s "
+               "(Env: OS_PRIVATENAT_API_VERSION)") % DEFAULT_API_VERSION
+    )
+    return parser