Merge remote-tracking branch 'migration/main' into python-logging-migration

Author: chalmerlowe

logging/samples/AUTHORING_GUIDE.md

@@ -0,0 +1 @@
+See https://github.com/GoogleCloudPlatform/python-docs-samples/blob/main/AUTHORING_GUIDE.md

logging/samples/CONTRIBUTING.md

@@ -0,0 +1 @@
+See https://github.com/GoogleCloudPlatform/python-docs-samples/blob/main/CONTRIBUTING.md

logging/samples/generated_samples/logging_v2_generated_config_service_v2_copy_log_entries_async.py

@@ -0,0 +1,57 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for CopyLogEntries
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-logging
+
+
+# [START logging_v2_generated_ConfigServiceV2_CopyLogEntries_async]
+# This snippet has been automatically generated and should be regarded as a
+# code template only.
+# It will require modifications to work:
+# - It may require correct/in-range values for request initialization.
+# - It may require specifying regional endpoints when creating the service
+#   client as shown in:
+#   https://googleapis.dev/python/google-api-core/latest/client_options.html
+from google.cloud import logging_v2
+
+
+async def sample_copy_log_entries():
+    # Create a client
+    client = logging_v2.services.config_service_v2.ConfigServiceV2AsyncClient()
+
+    # Initialize request argument(s)
+    request = logging_v2.types.CopyLogEntriesRequest(
+        name="name_value",
+        destination="destination_value",
+    )
+
+    # Make the request
+    operation = client.copy_log_entries(request=request)
+
+    print("Waiting for operation to complete...")
+
+    response = (await operation).result()
+
+    # Handle the response
+    print(response)
+
+# [END logging_v2_generated_ConfigServiceV2_CopyLogEntries_async]

logging/samples/generated_samples/logging_v2_generated_config_service_v2_copy_log_entries_sync.py

@@ -0,0 +1,57 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for CopyLogEntries
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-logging
+
+
+# [START logging_v2_generated_ConfigServiceV2_CopyLogEntries_sync]
+# This snippet has been automatically generated and should be regarded as a
+# code template only.
+# It will require modifications to work:
+# - It may require correct/in-range values for request initialization.
+# - It may require specifying regional endpoints when creating the service
+#   client as shown in:
+#   https://googleapis.dev/python/google-api-core/latest/client_options.html
+from google.cloud import logging_v2
+
+
+def sample_copy_log_entries():
+    # Create a client
+    client = logging_v2.services.config_service_v2.ConfigServiceV2Client()
+
+    # Initialize request argument(s)
+    request = logging_v2.types.CopyLogEntriesRequest(
+        name="name_value",
+        destination="destination_value",
+    )
+
+    # Make the request
+    operation = client.copy_log_entries(request=request)
+
+    print("Waiting for operation to complete...")
+
+    response = operation.result()
+
+    # Handle the response
+    print(response)
+
+# [END logging_v2_generated_ConfigServiceV2_CopyLogEntries_sync]

logging/samples/generated_samples/logging_v2_generated_config_service_v2_create_bucket_async.py

@@ -0,0 +1,53 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for CreateBucket
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-logging
+
+
+# [START logging_v2_generated_ConfigServiceV2_CreateBucket_async]
+# This snippet has been automatically generated and should be regarded as a
+# code template only.
+# It will require modifications to work:
+# - It may require correct/in-range values for request initialization.
+# - It may require specifying regional endpoints when creating the service
+#   client as shown in:
+#   https://googleapis.dev/python/google-api-core/latest/client_options.html
+from google.cloud import logging_v2
+
+
+async def sample_create_bucket():
+    # Create a client
+    client = logging_v2.services.config_service_v2.ConfigServiceV2AsyncClient()
+
+    # Initialize request argument(s)
+    request = logging_v2.types.CreateBucketRequest(
+        parent="parent_value",
+        bucket_id="bucket_id_value",
+    )
+
+    # Make the request
+    response = await client.create_bucket(request=request)
+
+    # Handle the response
+    print(response)
+
+# [END logging_v2_generated_ConfigServiceV2_CreateBucket_async]

logging/samples/generated_samples/logging_v2_generated_config_service_v2_create_bucket_async_async.py

@@ -0,0 +1,57 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for CreateBucketAsync
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-logging
+
+
+# [START logging_v2_generated_ConfigServiceV2_CreateBucketAsync_async]
+# This snippet has been automatically generated and should be regarded as a
+# code template only.
+# It will require modifications to work:
+# - It may require correct/in-range values for request initialization.
+# - It may require specifying regional endpoints when creating the service
+#   client as shown in:
+#   https://googleapis.dev/python/google-api-core/latest/client_options.html
+from google.cloud import logging_v2
+
+
+async def sample_create_bucket_async():
+    # Create a client
+    client = logging_v2.services.config_service_v2.ConfigServiceV2AsyncClient()
+
+    # Initialize request argument(s)
+    request = logging_v2.types.CreateBucketRequest(
+        parent="parent_value",
+        bucket_id="bucket_id_value",
+    )
+
+    # Make the request
+    operation = client.create_bucket_async(request=request)
+
+    print("Waiting for operation to complete...")
+
+    response = (await operation).result()
+
+    # Handle the response
+    print(response)
+
+# [END logging_v2_generated_ConfigServiceV2_CreateBucketAsync_async]

logging/samples/generated_samples/logging_v2_generated_config_service_v2_create_bucket_async_sync.py

@@ -0,0 +1,57 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for CreateBucketAsync
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-logging
+
+
+# [START logging_v2_generated_ConfigServiceV2_CreateBucketAsync_sync]
+# This snippet has been automatically generated and should be regarded as a
+# code template only.
+# It will require modifications to work:
+# - It may require correct/in-range values for request initialization.
+# - It may require specifying regional endpoints when creating the service
+#   client as shown in:
+#   https://googleapis.dev/python/google-api-core/latest/client_options.html
+from google.cloud import logging_v2
+
+
+def sample_create_bucket_async():
+    # Create a client
+    client = logging_v2.services.config_service_v2.ConfigServiceV2Client()
+
+    # Initialize request argument(s)
+    request = logging_v2.types.CreateBucketRequest(
+        parent="parent_value",
+        bucket_id="bucket_id_value",
+    )
+
+    # Make the request
+    operation = client.create_bucket_async(request=request)
+
+    print("Waiting for operation to complete...")
+
+    response = operation.result()
+
+    # Handle the response
+    print(response)
+
+# [END logging_v2_generated_ConfigServiceV2_CreateBucketAsync_sync]

logging/samples/generated_samples/logging_v2_generated_config_service_v2_create_bucket_sync.py

@@ -0,0 +1,53 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for CreateBucket
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-logging
+
+
+# [START logging_v2_generated_ConfigServiceV2_CreateBucket_sync]
+# This snippet has been automatically generated and should be regarded as a
+# code template only.
+# It will require modifications to work:
+# - It may require correct/in-range values for request initialization.
+# - It may require specifying regional endpoints when creating the service
+#   client as shown in:
+#   https://googleapis.dev/python/google-api-core/latest/client_options.html
+from google.cloud import logging_v2
+
+
+def sample_create_bucket():
+    # Create a client
+    client = logging_v2.services.config_service_v2.ConfigServiceV2Client()
+
+    # Initialize request argument(s)
+    request = logging_v2.types.CreateBucketRequest(
+        parent="parent_value",
+        bucket_id="bucket_id_value",
+    )
+
+    # Make the request
+    response = client.create_bucket(request=request)
+
+    # Handle the response
+    print(response)
+
+# [END logging_v2_generated_ConfigServiceV2_CreateBucket_sync]