google-cloud-recommender 2.18.2__tar.gz → 2.19.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. {google_cloud_recommender-2.18.2/google_cloud_recommender.egg-info → google_cloud_recommender-2.19.0}/PKG-INFO +5 -2
  2. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/README.rst +1 -1
  3. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender/gapic_version.py +1 -1
  4. {google_cloud_recommender-2.18.2/google/cloud/recommender_v1beta1 → google_cloud_recommender-2.19.0/google/cloud/recommender_v1}/gapic_version.py +1 -1
  5. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/services/recommender/async_client.py +36 -36
  6. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/services/recommender/client.py +36 -36
  7. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/services/recommender/transports/base.py +3 -2
  8. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/services/recommender/transports/grpc.py +14 -12
  9. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/services/recommender/transports/grpc_asyncio.py +14 -12
  10. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/services/recommender/transports/rest.py +3 -2
  11. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/types/insight_type_config.py +1 -1
  12. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/types/recommendation.py +10 -10
  13. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/types/recommender_config.py +1 -1
  14. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/types/recommender_service.py +36 -36
  15. {google_cloud_recommender-2.18.2/google/cloud/recommender_v1 → google_cloud_recommender-2.19.0/google/cloud/recommender_v1beta1}/gapic_version.py +1 -1
  16. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/services/recommender/async_client.py +31 -31
  17. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/services/recommender/client.py +31 -31
  18. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/services/recommender/transports/base.py +3 -2
  19. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/services/recommender/transports/grpc.py +13 -11
  20. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/services/recommender/transports/grpc_asyncio.py +13 -11
  21. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/services/recommender/transports/rest.py +3 -2
  22. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/types/insight_type_config.py +1 -1
  23. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/types/recommendation.py +10 -10
  24. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/types/recommender_config.py +1 -1
  25. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/types/recommender_service.py +30 -30
  26. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0/google_cloud_recommender.egg-info}/PKG-INFO +5 -2
  27. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google_cloud_recommender.egg-info/requires.txt +4 -0
  28. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/setup.py +3 -0
  29. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/LICENSE +0 -0
  30. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/MANIFEST.in +0 -0
  31. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender/__init__.py +0 -0
  32. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender/py.typed +0 -0
  33. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/__init__.py +0 -0
  34. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/gapic_metadata.json +0 -0
  35. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/py.typed +0 -0
  36. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/services/__init__.py +0 -0
  37. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/services/recommender/__init__.py +0 -0
  38. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/services/recommender/pagers.py +0 -0
  39. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/services/recommender/transports/__init__.py +0 -0
  40. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/services/recommender/transports/rest_base.py +0 -0
  41. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/types/__init__.py +0 -0
  42. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1/types/insight.py +0 -0
  43. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/__init__.py +0 -0
  44. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/gapic_metadata.json +0 -0
  45. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/py.typed +0 -0
  46. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/services/__init__.py +0 -0
  47. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/services/recommender/__init__.py +0 -0
  48. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/services/recommender/pagers.py +0 -0
  49. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/services/recommender/transports/__init__.py +0 -0
  50. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/services/recommender/transports/rest_base.py +0 -0
  51. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/types/__init__.py +0 -0
  52. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google/cloud/recommender_v1beta1/types/insight.py +0 -0
  53. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google_cloud_recommender.egg-info/SOURCES.txt +0 -0
  54. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google_cloud_recommender.egg-info/dependency_links.txt +0 -0
  55. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google_cloud_recommender.egg-info/not-zip-safe +0 -0
  56. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/google_cloud_recommender.egg-info/top_level.txt +0 -0
  57. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/setup.cfg +0 -0
  58. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/tests/__init__.py +0 -0
  59. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/tests/unit/__init__.py +0 -0
  60. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/tests/unit/gapic/__init__.py +0 -0
  61. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/tests/unit/gapic/recommender_v1/__init__.py +0 -0
  62. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/tests/unit/gapic/recommender_v1/test_recommender.py +0 -0
  63. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/tests/unit/gapic/recommender_v1beta1/__init__.py +0 -0
  64. {google_cloud_recommender-2.18.2 → google_cloud_recommender-2.19.0}/tests/unit/gapic/recommender_v1beta1/test_recommender.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: google-cloud-recommender
3
- Version: 2.18.2
3
+ Version: 2.19.0
4
4
  Summary: Google Cloud Recommender API client library
5
5
  Home-page: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-recommender
6
6
  Author: Google LLC
@@ -19,12 +19,15 @@ Classifier: Programming Language :: Python :: 3.10
19
19
  Classifier: Programming Language :: Python :: 3.11
20
20
  Classifier: Programming Language :: Python :: 3.12
21
21
  Classifier: Programming Language :: Python :: 3.13
22
+ Classifier: Programming Language :: Python :: 3.14
22
23
  Classifier: Operating System :: OS Independent
23
24
  Classifier: Topic :: Internet
24
25
  Requires-Python: >=3.7
25
26
  License-File: LICENSE
26
27
  Requires-Dist: google-api-core[grpc]!=2.0.*,!=2.1.*,!=2.10.*,!=2.2.*,!=2.3.*,!=2.4.*,!=2.5.*,!=2.6.*,!=2.7.*,!=2.8.*,!=2.9.*,<3.0.0,>=1.34.1
27
28
  Requires-Dist: google-auth!=2.24.0,!=2.25.0,<3.0.0,>=2.14.1
29
+ Requires-Dist: grpcio<2.0.0,>=1.33.2
30
+ Requires-Dist: grpcio<2.0.0,>=1.75.1; python_version >= "3.14"
28
31
  Requires-Dist: proto-plus<2.0.0,>=1.22.3
29
32
  Requires-Dist: proto-plus<2.0.0,>=1.25.0; python_version >= "3.13"
30
33
  Requires-Dist: protobuf!=4.21.0,!=4.21.1,!=4.21.2,!=4.21.3,!=4.21.4,!=4.21.5,<7.0.0,>=3.20.2
@@ -103,7 +106,7 @@ Supported Python Versions
103
106
  Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
104
107
  Python.
105
108
 
106
- Python >= 3.7
109
+ Python >= 3.7, including 3.14
107
110
 
108
111
  .. _active: https://devguide.python.org/devcycle/#in-development-main-branch
109
112
  .. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches
@@ -61,7 +61,7 @@ Supported Python Versions
61
61
  Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
62
62
  Python.
63
63
 
64
- Python >= 3.7
64
+ Python >= 3.7, including 3.14
65
65
 
66
66
  .. _active: https://devguide.python.org/devcycle/#in-development-main-branch
67
67
  .. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches
@@ -13,4 +13,4 @@
13
13
  # See the License for the specific language governing permissions and
14
14
  # limitations under the License.
15
15
  #
16
- __version__ = "2.18.2" # {x-release-please-version}
16
+ __version__ = "2.19.0" # {x-release-please-version}
@@ -13,4 +13,4 @@
13
13
  # See the License for the specific language governing permissions and
14
14
  # limitations under the License.
15
15
  #
16
- __version__ = "2.18.2" # {x-release-please-version}
16
+ __version__ = "2.19.0" # {x-release-please-version}
@@ -329,7 +329,7 @@ class RecommenderAsyncClient:
329
329
  metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
330
330
  ) -> pagers.ListInsightsAsyncPager:
331
331
  r"""Lists insights for the specified Cloud Resource. Requires the
332
- recommender.*.list IAM permission for the specified insight
332
+ recommender.\*.list IAM permission for the specified insight
333
333
  type.
334
334
 
335
335
  .. code-block:: python
@@ -366,15 +366,15 @@ class RecommenderAsyncClient:
366
366
  Required. The container resource on which to execute the
367
367
  request. Acceptable formats:
368
368
 
369
- - ``projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
369
+ - ``projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
370
370
 
371
- - ``projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
371
+ - ``projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
372
372
 
373
- - ``billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
373
+ - ``billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
374
374
 
375
- - ``folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
375
+ - ``folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
376
376
 
377
- - ``organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
377
+ - ``organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
378
378
 
379
379
  LOCATION here refers to GCP Locations:
380
380
  https://cloud.google.com/about/locations/
@@ -469,7 +469,7 @@ class RecommenderAsyncClient:
469
469
  timeout: Union[float, object] = gapic_v1.method.DEFAULT,
470
470
  metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
471
471
  ) -> insight.Insight:
472
- r"""Gets the requested insight. Requires the recommender.*.get IAM
472
+ r"""Gets the requested insight. Requires the recommender.\*.get IAM
473
473
  permission for the specified insight type.
474
474
 
475
475
  .. code-block:: python
@@ -590,7 +590,7 @@ class RecommenderAsyncClient:
590
590
  being updated.
591
591
 
592
592
  MarkInsightAccepted can be applied to insights in ACTIVE state.
593
- Requires the recommender.*.update IAM permission for the
593
+ Requires the recommender.\*.update IAM permission for the
594
594
  specified insight.
595
595
 
596
596
  .. code-block:: python
@@ -725,7 +725,7 @@ class RecommenderAsyncClient:
725
725
  metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
726
726
  ) -> pagers.ListRecommendationsAsyncPager:
727
727
  r"""Lists recommendations for the specified Cloud Resource. Requires
728
- the recommender.*.list IAM permission for the specified
728
+ the recommender.\*.list IAM permission for the specified
729
729
  recommender.
730
730
 
731
731
  .. code-block:: python
@@ -762,15 +762,15 @@ class RecommenderAsyncClient:
762
762
  Required. The container resource on which to execute the
763
763
  request. Acceptable formats:
764
764
 
765
- - ``projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
765
+ - ``projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
766
766
 
767
- - ``projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
767
+ - ``projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
768
768
 
769
- - ``billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
769
+ - ``billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
770
770
 
771
- - ``folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
771
+ - ``folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
772
772
 
773
- - ``organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
773
+ - ``organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
774
774
 
775
775
  LOCATION here refers to GCP Locations:
776
776
  https://cloud.google.com/about/locations/ RECOMMENDER_ID
@@ -784,25 +784,25 @@ class RecommenderAsyncClient:
784
784
  Filter expression to restrict the recommendations
785
785
  returned. Supported filter fields:
786
786
 
787
- - ``state_info.state``
787
+ - ``state_info.state``
788
788
 
789
- - ``recommenderSubtype``
789
+ - ``recommenderSubtype``
790
790
 
791
- - ``priority``
791
+ - ``priority``
792
792
 
793
- - ``targetResources``
793
+ - ``targetResources``
794
794
 
795
795
  Examples:
796
796
 
797
- - ``stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED``
797
+ - ``stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED``
798
798
 
799
- - ``recommenderSubtype = REMOVE_ROLE OR recommenderSubtype = REPLACE_ROLE``
799
+ - ``recommenderSubtype = REMOVE_ROLE OR recommenderSubtype = REPLACE_ROLE``
800
800
 
801
- - ``priority = P1 OR priority = P2``
801
+ - ``priority = P1 OR priority = P2``
802
802
 
803
- - ``targetResources : //compute.googleapis.com/projects/1234/zones/us-central1-a/instances/instance-1``
803
+ - ``targetResources : //compute.googleapis.com/projects/1234/zones/us-central1-a/instances/instance-1``
804
804
 
805
- - ``stateInfo.state = ACTIVE AND (priority = P1 OR priority = P2)``
805
+ - ``stateInfo.state = ACTIVE AND (priority = P1 OR priority = P2)``
806
806
 
807
807
  The max allowed filter length is 500 characters.
808
808
 
@@ -902,7 +902,7 @@ class RecommenderAsyncClient:
902
902
  metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
903
903
  ) -> recommendation.Recommendation:
904
904
  r"""Gets the requested recommendation. Requires the
905
- recommender.*.get IAM permission for the specified recommender.
905
+ recommender.\*.get IAM permission for the specified recommender.
906
906
 
907
907
  .. code-block:: python
908
908
 
@@ -1020,7 +1020,7 @@ class RecommenderAsyncClient:
1020
1020
  MarkRecommendationDismissed can be applied to recommendations in
1021
1021
  ACTIVE state.
1022
1022
 
1023
- Requires the recommender.*.update IAM permission for the
1023
+ Requires the recommender.\*.update IAM permission for the
1024
1024
  specified recommender.
1025
1025
 
1026
1026
  .. code-block:: python
@@ -1124,7 +1124,7 @@ class RecommenderAsyncClient:
1124
1124
  MarkRecommendationClaimed can be applied to recommendations in
1125
1125
  CLAIMED, SUCCEEDED, FAILED, or ACTIVE state.
1126
1126
 
1127
- Requires the recommender.*.update IAM permission for the
1127
+ Requires the recommender.\*.update IAM permission for the
1128
1128
  specified recommender.
1129
1129
 
1130
1130
  .. code-block:: python
@@ -1273,7 +1273,7 @@ class RecommenderAsyncClient:
1273
1273
  MarkRecommendationSucceeded can be applied to recommendations in
1274
1274
  ACTIVE, CLAIMED, SUCCEEDED, or FAILED state.
1275
1275
 
1276
- Requires the recommender.*.update IAM permission for the
1276
+ Requires the recommender.\*.update IAM permission for the
1277
1277
  specified recommender.
1278
1278
 
1279
1279
  .. code-block:: python
@@ -1422,7 +1422,7 @@ class RecommenderAsyncClient:
1422
1422
  MarkRecommendationFailed can be applied to recommendations in
1423
1423
  ACTIVE, CLAIMED, SUCCEEDED, or FAILED state.
1424
1424
 
1425
- Requires the recommender.*.update IAM permission for the
1425
+ Requires the recommender.\*.update IAM permission for the
1426
1426
  specified recommender.
1427
1427
 
1428
1428
  .. code-block:: python
@@ -1595,13 +1595,13 @@ class RecommenderAsyncClient:
1595
1595
 
1596
1596
  Acceptable formats:
1597
1597
 
1598
- - ``projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config``
1598
+ - ``projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config``
1599
1599
 
1600
- - ``projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config``
1600
+ - ``projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config``
1601
1601
 
1602
- - ``organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config``
1602
+ - ``organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config``
1603
1603
 
1604
- - ``billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config``
1604
+ - ``billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config``
1605
1605
 
1606
1606
  This corresponds to the ``name`` field
1607
1607
  on the ``request`` instance; if ``request`` is provided, this
@@ -1835,13 +1835,13 @@ class RecommenderAsyncClient:
1835
1835
 
1836
1836
  Acceptable formats:
1837
1837
 
1838
- - ``projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config``
1838
+ - ``projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config``
1839
1839
 
1840
- - ``projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config``
1840
+ - ``projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config``
1841
1841
 
1842
- - ``organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config``
1842
+ - ``organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config``
1843
1843
 
1844
- - ``billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config``
1844
+ - ``billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config``
1845
1845
 
1846
1846
  This corresponds to the ``name`` field
1847
1847
  on the ``request`` instance; if ``request`` is provided, this
@@ -851,7 +851,7 @@ class RecommenderClient(metaclass=RecommenderClientMeta):
851
851
  metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
852
852
  ) -> pagers.ListInsightsPager:
853
853
  r"""Lists insights for the specified Cloud Resource. Requires the
854
- recommender.*.list IAM permission for the specified insight
854
+ recommender.\*.list IAM permission for the specified insight
855
855
  type.
856
856
 
857
857
  .. code-block:: python
@@ -888,15 +888,15 @@ class RecommenderClient(metaclass=RecommenderClientMeta):
888
888
  Required. The container resource on which to execute the
889
889
  request. Acceptable formats:
890
890
 
891
- - ``projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
891
+ - ``projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
892
892
 
893
- - ``projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
893
+ - ``projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
894
894
 
895
- - ``billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
895
+ - ``billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
896
896
 
897
- - ``folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
897
+ - ``folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
898
898
 
899
- - ``organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
899
+ - ``organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]``
900
900
 
901
901
  LOCATION here refers to GCP Locations:
902
902
  https://cloud.google.com/about/locations/
@@ -988,7 +988,7 @@ class RecommenderClient(metaclass=RecommenderClientMeta):
988
988
  timeout: Union[float, object] = gapic_v1.method.DEFAULT,
989
989
  metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
990
990
  ) -> insight.Insight:
991
- r"""Gets the requested insight. Requires the recommender.*.get IAM
991
+ r"""Gets the requested insight. Requires the recommender.\*.get IAM
992
992
  permission for the specified insight type.
993
993
 
994
994
  .. code-block:: python
@@ -1106,7 +1106,7 @@ class RecommenderClient(metaclass=RecommenderClientMeta):
1106
1106
  being updated.
1107
1107
 
1108
1108
  MarkInsightAccepted can be applied to insights in ACTIVE state.
1109
- Requires the recommender.*.update IAM permission for the
1109
+ Requires the recommender.\*.update IAM permission for the
1110
1110
  specified insight.
1111
1111
 
1112
1112
  .. code-block:: python
@@ -1237,7 +1237,7 @@ class RecommenderClient(metaclass=RecommenderClientMeta):
1237
1237
  metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
1238
1238
  ) -> pagers.ListRecommendationsPager:
1239
1239
  r"""Lists recommendations for the specified Cloud Resource. Requires
1240
- the recommender.*.list IAM permission for the specified
1240
+ the recommender.\*.list IAM permission for the specified
1241
1241
  recommender.
1242
1242
 
1243
1243
  .. code-block:: python
@@ -1274,15 +1274,15 @@ class RecommenderClient(metaclass=RecommenderClientMeta):
1274
1274
  Required. The container resource on which to execute the
1275
1275
  request. Acceptable formats:
1276
1276
 
1277
- - ``projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
1277
+ - ``projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
1278
1278
 
1279
- - ``projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
1279
+ - ``projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
1280
1280
 
1281
- - ``billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
1281
+ - ``billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
1282
1282
 
1283
- - ``folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
1283
+ - ``folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
1284
1284
 
1285
- - ``organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
1285
+ - ``organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]``
1286
1286
 
1287
1287
  LOCATION here refers to GCP Locations:
1288
1288
  https://cloud.google.com/about/locations/ RECOMMENDER_ID
@@ -1296,25 +1296,25 @@ class RecommenderClient(metaclass=RecommenderClientMeta):
1296
1296
  Filter expression to restrict the recommendations
1297
1297
  returned. Supported filter fields:
1298
1298
 
1299
- - ``state_info.state``
1299
+ - ``state_info.state``
1300
1300
 
1301
- - ``recommenderSubtype``
1301
+ - ``recommenderSubtype``
1302
1302
 
1303
- - ``priority``
1303
+ - ``priority``
1304
1304
 
1305
- - ``targetResources``
1305
+ - ``targetResources``
1306
1306
 
1307
1307
  Examples:
1308
1308
 
1309
- - ``stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED``
1309
+ - ``stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED``
1310
1310
 
1311
- - ``recommenderSubtype = REMOVE_ROLE OR recommenderSubtype = REPLACE_ROLE``
1311
+ - ``recommenderSubtype = REMOVE_ROLE OR recommenderSubtype = REPLACE_ROLE``
1312
1312
 
1313
- - ``priority = P1 OR priority = P2``
1313
+ - ``priority = P1 OR priority = P2``
1314
1314
 
1315
- - ``targetResources : //compute.googleapis.com/projects/1234/zones/us-central1-a/instances/instance-1``
1315
+ - ``targetResources : //compute.googleapis.com/projects/1234/zones/us-central1-a/instances/instance-1``
1316
1316
 
1317
- - ``stateInfo.state = ACTIVE AND (priority = P1 OR priority = P2)``
1317
+ - ``stateInfo.state = ACTIVE AND (priority = P1 OR priority = P2)``
1318
1318
 
1319
1319
  The max allowed filter length is 500 characters.
1320
1320
 
@@ -1411,7 +1411,7 @@ class RecommenderClient(metaclass=RecommenderClientMeta):
1411
1411
  metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
1412
1412
  ) -> recommendation.Recommendation:
1413
1413
  r"""Gets the requested recommendation. Requires the
1414
- recommender.*.get IAM permission for the specified recommender.
1414
+ recommender.\*.get IAM permission for the specified recommender.
1415
1415
 
1416
1416
  .. code-block:: python
1417
1417
 
@@ -1526,7 +1526,7 @@ class RecommenderClient(metaclass=RecommenderClientMeta):
1526
1526
  MarkRecommendationDismissed can be applied to recommendations in
1527
1527
  ACTIVE state.
1528
1528
 
1529
- Requires the recommender.*.update IAM permission for the
1529
+ Requires the recommender.\*.update IAM permission for the
1530
1530
  specified recommender.
1531
1531
 
1532
1532
  .. code-block:: python
@@ -1630,7 +1630,7 @@ class RecommenderClient(metaclass=RecommenderClientMeta):
1630
1630
  MarkRecommendationClaimed can be applied to recommendations in
1631
1631
  CLAIMED, SUCCEEDED, FAILED, or ACTIVE state.
1632
1632
 
1633
- Requires the recommender.*.update IAM permission for the
1633
+ Requires the recommender.\*.update IAM permission for the
1634
1634
  specified recommender.
1635
1635
 
1636
1636
  .. code-block:: python
@@ -1777,7 +1777,7 @@ class RecommenderClient(metaclass=RecommenderClientMeta):
1777
1777
  MarkRecommendationSucceeded can be applied to recommendations in
1778
1778
  ACTIVE, CLAIMED, SUCCEEDED, or FAILED state.
1779
1779
 
1780
- Requires the recommender.*.update IAM permission for the
1780
+ Requires the recommender.\*.update IAM permission for the
1781
1781
  specified recommender.
1782
1782
 
1783
1783
  .. code-block:: python
@@ -1924,7 +1924,7 @@ class RecommenderClient(metaclass=RecommenderClientMeta):
1924
1924
  MarkRecommendationFailed can be applied to recommendations in
1925
1925
  ACTIVE, CLAIMED, SUCCEEDED, or FAILED state.
1926
1926
 
1927
- Requires the recommender.*.update IAM permission for the
1927
+ Requires the recommender.\*.update IAM permission for the
1928
1928
  specified recommender.
1929
1929
 
1930
1930
  .. code-block:: python
@@ -2095,13 +2095,13 @@ class RecommenderClient(metaclass=RecommenderClientMeta):
2095
2095
 
2096
2096
  Acceptable formats:
2097
2097
 
2098
- - ``projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config``
2098
+ - ``projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config``
2099
2099
 
2100
- - ``projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config``
2100
+ - ``projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config``
2101
2101
 
2102
- - ``organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config``
2102
+ - ``organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config``
2103
2103
 
2104
- - ``billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config``
2104
+ - ``billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config``
2105
2105
 
2106
2106
  This corresponds to the ``name`` field
2107
2107
  on the ``request`` instance; if ``request`` is provided, this
@@ -2331,13 +2331,13 @@ class RecommenderClient(metaclass=RecommenderClientMeta):
2331
2331
 
2332
2332
  Acceptable formats:
2333
2333
 
2334
- - ``projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config``
2334
+ - ``projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config``
2335
2335
 
2336
- - ``projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config``
2336
+ - ``projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config``
2337
2337
 
2338
- - ``organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config``
2338
+ - ``organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config``
2339
2339
 
2340
- - ``billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config``
2340
+ - ``billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config``
2341
2341
 
2342
2342
  This corresponds to the ``name`` field
2343
2343
  on the ``request`` instance; if ``request`` is provided, this
@@ -76,9 +76,10 @@ class RecommenderTransport(abc.ABC):
76
76
  credentials identify the application to the service; if none
77
77
  are specified, the client will attempt to ascertain the
78
78
  credentials from the environment.
79
- credentials_file (Optional[str]): A file with credentials that can
79
+ credentials_file (Optional[str]): Deprecated. A file with credentials that can
80
80
  be loaded with :func:`google.auth.load_credentials_from_file`.
81
- This argument is mutually exclusive with credentials.
81
+ This argument is mutually exclusive with credentials. This argument will be
82
+ removed in the next major version of this library.
82
83
  scopes (Optional[Sequence[str]]): A list of scopes.
83
84
  quota_project_id (Optional[str]): An optional project to use for billing
84
85
  and quota.
@@ -164,9 +164,10 @@ class RecommenderGrpcTransport(RecommenderTransport):
164
164
  are specified, the client will attempt to ascertain the
165
165
  credentials from the environment.
166
166
  This argument is ignored if a ``channel`` instance is provided.
167
- credentials_file (Optional[str]): A file with credentials that can
167
+ credentials_file (Optional[str]): Deprecated. A file with credentials that can
168
168
  be loaded with :func:`google.auth.load_credentials_from_file`.
169
169
  This argument is ignored if a ``channel`` instance is provided.
170
+ This argument will be removed in the next major version of this library.
170
171
  scopes (Optional(Sequence[str])): A list of scopes. This argument is
171
172
  ignored if a ``channel`` instance is provided.
172
173
  channel (Optional[Union[grpc.Channel, Callable[..., grpc.Channel]]]):
@@ -299,9 +300,10 @@ class RecommenderGrpcTransport(RecommenderTransport):
299
300
  credentials identify this application to the service. If
300
301
  none are specified, the client will attempt to ascertain
301
302
  the credentials from the environment.
302
- credentials_file (Optional[str]): A file with credentials that can
303
+ credentials_file (Optional[str]): Deprecated. A file with credentials that can
303
304
  be loaded with :func:`google.auth.load_credentials_from_file`.
304
- This argument is mutually exclusive with credentials.
305
+ This argument is mutually exclusive with credentials. This argument will be
306
+ removed in the next major version of this library.
305
307
  scopes (Optional[Sequence[str]]): A optional list of scopes needed for this
306
308
  service. These are only used when credentials are not specified and
307
309
  are passed to :func:`google.auth.default`.
@@ -343,7 +345,7 @@ class RecommenderGrpcTransport(RecommenderTransport):
343
345
  r"""Return a callable for the list insights method over gRPC.
344
346
 
345
347
  Lists insights for the specified Cloud Resource. Requires the
346
- recommender.*.list IAM permission for the specified insight
348
+ recommender.\*.list IAM permission for the specified insight
347
349
  type.
348
350
 
349
351
  Returns:
@@ -370,7 +372,7 @@ class RecommenderGrpcTransport(RecommenderTransport):
370
372
  ) -> Callable[[recommender_service.GetInsightRequest], insight.Insight]:
371
373
  r"""Return a callable for the get insight method over gRPC.
372
374
 
373
- Gets the requested insight. Requires the recommender.*.get IAM
375
+ Gets the requested insight. Requires the recommender.\*.get IAM
374
376
  permission for the specified insight type.
375
377
 
376
378
  Returns:
@@ -403,7 +405,7 @@ class RecommenderGrpcTransport(RecommenderTransport):
403
405
  being updated.
404
406
 
405
407
  MarkInsightAccepted can be applied to insights in ACTIVE state.
406
- Requires the recommender.*.update IAM permission for the
408
+ Requires the recommender.\*.update IAM permission for the
407
409
  specified insight.
408
410
 
409
411
  Returns:
@@ -434,7 +436,7 @@ class RecommenderGrpcTransport(RecommenderTransport):
434
436
  r"""Return a callable for the list recommendations method over gRPC.
435
437
 
436
438
  Lists recommendations for the specified Cloud Resource. Requires
437
- the recommender.*.list IAM permission for the specified
439
+ the recommender.\*.list IAM permission for the specified
438
440
  recommender.
439
441
 
440
442
  Returns:
@@ -464,7 +466,7 @@ class RecommenderGrpcTransport(RecommenderTransport):
464
466
  r"""Return a callable for the get recommendation method over gRPC.
465
467
 
466
468
  Gets the requested recommendation. Requires the
467
- recommender.*.get IAM permission for the specified recommender.
469
+ recommender.\*.get IAM permission for the specified recommender.
468
470
 
469
471
  Returns:
470
472
  Callable[[~.GetRecommendationRequest],
@@ -500,7 +502,7 @@ class RecommenderGrpcTransport(RecommenderTransport):
500
502
  MarkRecommendationDismissed can be applied to recommendations in
501
503
  ACTIVE state.
502
504
 
503
- Requires the recommender.*.update IAM permission for the
505
+ Requires the recommender.\*.update IAM permission for the
504
506
  specified recommender.
505
507
 
506
508
  Returns:
@@ -541,7 +543,7 @@ class RecommenderGrpcTransport(RecommenderTransport):
541
543
  MarkRecommendationClaimed can be applied to recommendations in
542
544
  CLAIMED, SUCCEEDED, FAILED, or ACTIVE state.
543
545
 
544
- Requires the recommender.*.update IAM permission for the
546
+ Requires the recommender.\*.update IAM permission for the
545
547
  specified recommender.
546
548
 
547
549
  Returns:
@@ -582,7 +584,7 @@ class RecommenderGrpcTransport(RecommenderTransport):
582
584
  MarkRecommendationSucceeded can be applied to recommendations in
583
585
  ACTIVE, CLAIMED, SUCCEEDED, or FAILED state.
584
586
 
585
- Requires the recommender.*.update IAM permission for the
587
+ Requires the recommender.\*.update IAM permission for the
586
588
  specified recommender.
587
589
 
588
590
  Returns:
@@ -623,7 +625,7 @@ class RecommenderGrpcTransport(RecommenderTransport):
623
625
  MarkRecommendationFailed can be applied to recommendations in
624
626
  ACTIVE, CLAIMED, SUCCEEDED, or FAILED state.
625
627
 
626
- Requires the recommender.*.update IAM permission for the
628
+ Requires the recommender.\*.update IAM permission for the
627
629
  specified recommender.
628
630
 
629
631
  Returns: