8000 regen: Regenerate google-cloud-compute-v1beta at API commit a72e939 · googleapis/google-cloud-python@e7c4808 · GitHub 8000
[go: up one dir, main page]
Skip to content

Commit e7c4808

Browse files
author
Google Cloud SDK
committed
regen: Regenerate google-cloud-compute-v1beta at API commit a72e939
feat: add google/cloud/compute/v1beta (#1033) * build: implement matrix strategy for DIREGAPIC action * build: add alpha compute files * build: Include API channel in auto-generated PR * build: fix matrix specification * build: Have DIREGAPIC action use triggering ref or default branch * build: remove the field ScratchDisks The field was also removed purposefully in v1 * build: Add v1 proto for use as "previous proto" in conversion * build: allow all matrix jobs to complete even if some fail * build: fix location of fail-fast setting The original reference I used had it in the wrong place. Correct GitHub ref: https://docs.github.com/en/actions/writing-workflows/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast * build: Disable PHP and C# builds for alpha PHP just failed. Not clear what the issue is. C# has some known failures. One of them may be the use of 3 repeated fields. * build: Disable Ruby generation This was causing some errors, too. * build: fix version in Discovery file before further processing * build: jq is supposedly pre-installed in GitHub actions * feat: Move alpha to v1alpha in all paths * build: We do need to install jq * build: Try installing without sudo sudo is not found! * build: Fix regex "version" is the last field, so it has no trailing comma * build: Fix Go imports in BUILD * build: prepare for processing beta: copy files from alpha * build: update the beta file contents to refer to beta symbols * build: configure action to run for beta as well. * build: Have each channel use its own branch for the PR * Update syntax for matrix.version in branch name * add initial versions of alpha/beta discovery docs * Revert "add initial versions of alpha/beta discovery docs" This reverts commit 489a29cdc587ff4e10fc74765acbcf99ac34d496. * stage discovery docs * remove alpha * add compute.v1beta.json which is needed for kokoro presubmit * build: add python settings * import changes from PR 1035 * clean up * clean up * Remove redundant bazelisk build --------- Co-authored-by: Victor Chudnovsky <vchudnov@google.com> chore: minor formatting build(python): add service_yaml and rest_numeric_enums configurations (#1040) feat: Update Compute Engine v1beta API to revision 20250511 (#1041) Source-Link: googleapis/googleapis@2fc3abe Source-Link: googleapis/googleapis@24cb982 Source-Link: googleapis/googleapis@1a22026 Source-Link: googleapis/googleapis@a72e939
1 parent baddd41 commit e7c4808

File tree

469 files changed

+7502
-7243
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

469 files changed

+7502
-7243
lines changed

‎generator-input/pipeline-state.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2539,7 +2539,7 @@
25392539
"currentVersion": "0.1.1",
25402540
"generationAutomationLevel": "AUTOMATION_LEVEL_AUTOMATIC",
25412541
"releaseAutomationLevel": "AUTOMATION_LEVEL_AUTOMATIC",
2542-
"lastGeneratedCommit": "97a83d76a09a7f6dcab43675c87bdfeb5bcf1cb5",
2542+
"lastGeneratedCommit": "a72e9397ba746b25ed0dcb187de6690e4dd64b48",
25432543
"apiPaths": [
25442544
"google/cloud/compute/v1beta"
25452545
],

‎packages/google-cloud-compute-v1beta/.OwlBot.yaml

Lines changed: 0 additions & 24 deletions
This file was deleted.

‎packages/google-cloud-compute-v1beta/.repo-metadata.json

Lines changed: 0 additions & 17 deletions
This file was deleted.

‎packages/google-cloud-compute-v1beta/CHANGELOG.md

Lines changed: 0 additions & 17 deletions
This file was deleted.

‎packages/google-cloud-compute-v1beta/README.rst

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
1-
Python Client for Compute Engine
2-
================================
1+
Python Client for Google Compute Engine API
2+
===========================================
33

44
|stable| |pypi| |versions|
55

6-
`Compute Engine`_: delivers virtual machines running in Google's innovative data centers and worldwide fiber network. Compute Engine's tooling and workflow support enable scaling from single instances to global, load-balanced cloud computing. Compute Engine's VMs boot quickly, come with persistent disk storage, deliver consistent performance and are available in many configurations.
6+
`Google Compute Engine API`_:
77

88
- `Client Library Documentation`_
99
- `Product Documentation`_
@@ -14,8 +14,8 @@ Python Client for Compute Engine
1414
:target: https://pypi.org/project/google-cloud-compute-v1beta/
1515
.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-compute-v1beta.svg
1616
:target: https://pypi.org/project/google-cloud-compute-v1beta/
17-
.. _Compute Engine: https://cloud.google.com/compute/
18-
.. _Client Library Documentation: https://cloud.google.com/python/docs/reference/google-cloud-compute-v1beta/latest/summary_overview
17+
.. _Google Compute Engine API: https://cloud.google.com/compute/
18+
.. _Client Library Documentation: https://cloud.google.com/python/docs/reference/compute/latest/summary_overview
1919
.. _Product Documentation: https://cloud.google.com/compute/
2020

2121
Quick Start
@@ -25,12 +25,12 @@ In order to use this library, you first need to go through the following steps:
2525

2626
1. `Select or create a Cloud Platform project.`_
2727
2. `Enable billing for your project.`_
28-
3. `Enable the Compute Engine.`_
28+
3. `Enable the Google Compute Engine API.`_
2929
4. `Set up Authentication.`_
3030

3131
.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
3232
.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
33-
.. _Enable the Compute Engine.: https://cloud.google.com/compute/
33+
.. _Enable the Google Compute Engine API.: https://cloud.google.com/compute/
3434
.. _Set up Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
3535

3636
Installation
@@ -97,14 +97,14 @@ Windows
9797
Next Steps
9898
~~~~~~~~~~
9999

100-
- Read the `Client Library Documentation`_ for Compute Engine
100+
- Read the `Client Library Documentation`_ for Google Compute Engine API
101101
to see other available methods on the client.
102-
- Read the `Compute Engine Product documentation`_ to learn
102+
- Read the `Google Compute Engine API Product documentation`_ to learn
103103
more about the product and see How-to Guides.
104104
- View this `README`_ to see the full list of Cloud
105105
APIs that we cover.
106106

107-
.. _Compute Engine Product documentation: https://cloud.google.com/compute/
107+
.. _Google Compute Engine API Product documentation: https://cloud.google.com/compute/
108108
.. _README: https://github.com/googleapis/google-cloud-python/blob/main/README.rst
109109

110110
Logging
@@ -161,9 +161,9 @@ Code-Based Examples
161161
.. code-block:: python
162162
163163
import logging
164-
164+
165165
from google.cloud import library_v1
166-
166+
167167
base_logger = logging.getLogger("google")
168168
base_logger.addHandler(logging.StreamHandler())
169169
base_logger.setLevel(logging.DEBUG)
@@ -173,9 +173,9 @@ Code-Based Examples
173173
.. code-block:: python
174174
175175
import logging
176-
176+
177177
from google.cloud import library_v1
178-
178+
179179
base_logger = logging.getLogger("google.cloud.library_v1")
180180
base_logger.addHandler(logging.StreamHandler())
181181
base_logger.setLevel(logging.DEBUG)

‎packages/google-cloud-compute-v1beta/docs/CHANGELOG.md

Lines changed: 0 additions & 1 deletion
This file was deleted.

‎packages/google-cloud-compute-v1beta/docs/README.rst

Lines changed: 0 additions & 1 deletion
This file was deleted.

‎packages/google-cloud-compute-v1beta/docs/README.rst

Lines changed: 197 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,197 @@
1+
Python Client for Google Compute Engine API
2+
===========================================
3+
4+
|stable| |pypi| |versions|
5+
6+
`Google Compute Engine API`_:
7+
8+
- `Client Library Documentation`_
9+
- `Product Documentation`_
10+
11+
.. |stable| image:: https://img.shields.io/badge/support-stable-gold.svg
12+
:target: https://github.com/googleapis/google-cloud-python/blob/main/README.rst#stability-levels
13+
.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-compute-v1beta.svg
14+
:target: https://pypi.org/project/google-cloud-compute-v1beta/
15+
.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-compute-v1beta.svg
16+
:target: https://pypi.org/project/google-cloud-compute-v1beta/
17+
.. _Google Compute Engine API: https://cloud.google.com/compute/
18+
.. _Client Library Documentation: https://cloud.google.com/python/docs/reference/compute/latest/summary_overview
19+
.. _Product Documentation: https://cloud.google.com/compute/
20+
21+
Quick Start
22+
-----------
23+
24+
In order to use this library, you first need to go through the following steps:
25+
26+
1. `Select or create a Cloud Platform project.`_
27+
2. `Enable billing for your project.`_
28+
3. `Enable the Google Compute Engine API.`_
29+
4. `Set up Authentication.`_
30+
31+
.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
32+
.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
33+
.. _Enable the Google Compute Engine API.: https://cloud.google.com/compute/
34+
.. _Set up Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
35+
36+
Installation
37+
~~~~~~~~~~~~
38+
39+
Install this library in a virtual environment using `venv`_. `venv`_ is a tool that
40+
creates isolated Python environments. These isolated environments can have separate
41+
versions of Python packages, which allows you to isolate one project's dependencies
42+
from the dependencies of other projects.
43+
44+
With `venv`_, it's possible to install this library without needing system
45+
install permissions, and without clashing with the installed system
46+
dependencies.
47+
48+
.. _`venv`: https://docs.python.org/3/library/venv.html
49+
50+
51+
Code samples and snippets
52+
~~~~~~~~~~~~~~~~~~~~~~~~~
53+
54+
Code samples and snippets live in the `samples/`_ folder.
55+
56+
.. _samples/: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-compute-v1beta/samples
57+
58+
59+
Supported Python Versions
60+
^^^^^^^^^^^^^^^^^^^^^^^^^
61+
Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
62+
Python.
63+
64+
Python >= 3.7
65+
66+
.. _active: https://devguide.python.org/devcycle/#in-development-main-branch
67+
.. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches
68+
69+
Unsupported Python Versions
70+
^^^^^^^^^^^^^^^^^^^^^^^^^^^
71+
Python <= 3.6
72+
73+
If you are using an `end-of-life`_
74+
version of Python, we recommend that you update as soon as possible to an actively supported version.
75+
76+
.. _end-of-life: https://devguide.python.org/devcycle/#end-of-life-branches
77+
78+
Mac/Linux
79+
^^^^^^^^^
80+
81+
.. code-block:: console
82+
83+
python3 -m venv <your-env>
84+
source <your-env>/bin/activate
85+
pip install google-cloud-compute-v1beta
86+
87+
88+
Windows
89+
^^^^^^^
90+
91+
.. code-block:: console
92+
93+
py -m venv <your-env>
94+
.\<your-env>\Scripts\activate
95+
pip install google-cloud-compute-v1beta
96+
97+
Next Steps
98+
~~~~~~~~~~
99+
100+
- Read the `Client Library Documentation`_ for Google Compute Engine API
101+
to see other available methods on the client.
102+
- Read the `Google Compute Engine API Product documentation`_ to learn
103+
more about the product and see How-to Guides.
104+
- View this `README`_ to see the full list of Cloud
105+
APIs that we cover.
106+
107+
.. _Google Compute Engine API Product documentation: https://cloud.google.com/compute/
108+
.. _README: https://github.com/googleapis/google-cloud-python/blob/main/README.rst
109+
110+
Logging
111+
-------
112+
113+
This library uses the standard Python :code:`logging` functionality to log some RPC events that could be of interest for debugging and monitoring purposes.
114+
Note the following:
115+
116+
#. Logs may contain sensitive information. Take care to **restrict access to the logs** if they are saved, whether it be on local storage or on Google Cloud Logging.
117+
#. Google may refine the occurrence, level, and content of various log messages in this library without flagging such changes as breaking. **Do not depend on immutability of the logging events**.
118+
#. By default, the logging events from this library are not handled. You must **explicitly configure log handling** using one of the mechanisms below.
119+
120+
Simple, environment-based configuration
121+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 10000 ~~~
122+
123+
To enable logging for this library without any changes in your code, set the :code:`GOOGLE_SDK_PYTHON_LOGGING_SCOPE` environment variable to a valid Google
124+
logging scope. This configures handling of logging events (at level :code:`logging.DEBUG` or higher) from this library in a default manner, emitting the logged
125+
messages in a structured format. It does not currently allow customizing the logging levels captured nor the handlers, formatters, etc. used for any logging
126+
event.
127+
128+
A logging scope is a period-separated namespace that begins with :code:`google`, identifying the Python module or package to log.
129+
130+
- Valid logging scopes: :code:`google`, :code:`google.cloud.asset.v1`, :code:`google.api`, :code:`google.auth`, etc.
131+
- Invalid logging scopes: :code:`foo`, :code:`123`, etc.
132+
133+
**NOTE**: If the logging scope is invalid, the library does not set up any logging handlers.
134+
135+
Environment-Based Examples
136+
^^^^^^^^^^^^^^^^^^^^^^^^^^
137+
138+
- Enabling the default handler for all Google-based loggers
139+
140+
.. code-block:: console
141+
142+
export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google
143+
144+
- Enabling the default handler for a specific Google module (for a client library called :code:`library_v1`):
145+
146+
.. code-block:: console
147+
148+
export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google.cloud.library_v1
149+
150+
151+
Advanced, code-based configuration
152+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
153+
154+
You can also configure a valid logging scope using Python's standard `logging` mechanism.
155+
156+
Code-Based Examples
157+
^^^^^^^^^^^^^^^^^^^
158+
159+
- Configuring a handler for all Google-based loggers
160+
161+
.. code-block:: python
162+
163+
import logging
164+
165+
from google.cloud import library_v1
166+
167+
base_logger = logging.getLogger("google")
168+
base_logger.addHandler(logging.StreamHandler())
169+
base_logger.setLevel(logging.DEBUG)
170+
171+
- Configuring a handler for a specific Google module (for a client library called :code:`library_v1`):
172+
173+
.. code-block:: python
174+
175+
import logging
176+
177+
from google.cloud import library_v1
178+
179+
base_logger = logging.getLogger("google.cloud.library_v1")
180+
base_logger.addHandler(logging.StreamHandler())
181+
base_logger.setLevel(logging.DEBUG)
182+
183+
Logging details
184+
~~~~~~~~~~~~~~~
185+
186+
#. Regardless of which of the mechanisms above you use to configure logging for this library, by default logging events are not propagated up to the root
187+
logger from the `google`-level logger. If you need the events to be propagated to the root logger, you must explicitly set
188+
:code:`logging.getLogger("google").propagate = True` in your code.
189+
#. You can mix the different logging configurations above for different Google modules. For example, you may want use a code-based logging configuration for
190+
one library, but decide you need to also set up environment-based logging configuration for another library.
191+
192+
#. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
193+
if the code -based configuration gets applied first.
194+
195+
#. The Google-specific logging configurations (default handlers for environment-based configuration; not propagating logging events to the root logger) get
196+
executed the first time *any* client library is instantiated in your application, and only if the affected loggers have not been previously configured.
197+
(This is the reason for 2.i. above.)

‎packages/google-cloud-compute-v1beta/docs/index.rst

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,6 @@ API Reference
1111
compute_v1beta/services_
1212
compute_v1beta/types_
1313

14-
1514
Changelog
1615
---------
1716

‎packages/google-cloud-compute-v1beta/docs/summary_overview.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,18 +5,18 @@ reverted. Instead, if you want to place additional content, create an
55
pick up on the content and merge the content.
66
]: #
77

8-
# Compute Engine API
8+
# Google Compute Engine API
99

10-
Overview of the APIs available for Compute Engine API.
10+
Overview of the APIs available for Google Compute Engine API.
1111

1212
## All entries
1313

1414
Classes, methods and properties & attributes for
15-
Compute Engine API.
15+
Google Compute Engine API.
1616

17-
[classes](https://cloud.google.com/python/docs/reference/google-cloud-compute-v1beta/latest/summary_class.html)
17+
[classes](https://cloud.google.com/python/docs/reference/compute/latest/summary_class.html)
1818

19-
[methods](https://cloud.google.com/python/docs/reference/google-cloud-compute-v1beta/latest/summary_method.html)
19+
[methods](https://cloud.google.com/python/docs/reference/compute/latest/summary_method.html)
2020

2121
[properties and
22-
attributes](https://cloud.google.com/python/docs/reference/google-cloud-compute-v1beta/latest/summary_property.html)
22+
attributes](https://cloud.google.com/python/docs/reference/compute/latest/summary_property.html)

0 commit comments

Comments
 (0)
0