google-cloud-ai_platform-v1 1.15.0 → 1.17.0

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 (29) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/ai_platform/v1/model_garden_service/client.rb +137 -0
  3. data/lib/google/cloud/ai_platform/v1/model_garden_service/operations.rb +821 -0
  4. data/lib/google/cloud/ai_platform/v1/model_garden_service/paths.rb +36 -0
  5. data/lib/google/cloud/ai_platform/v1/model_garden_service/rest/client.rb +130 -0
  6. data/lib/google/cloud/ai_platform/v1/model_garden_service/rest/operations.rb +4398 -0
  7. data/lib/google/cloud/ai_platform/v1/model_garden_service/rest/service_stub.rb +62 -0
  8. data/lib/google/cloud/ai_platform/v1/model_garden_service/rest.rb +1 -0
  9. data/lib/google/cloud/ai_platform/v1/model_garden_service.rb +1 -0
  10. data/lib/google/cloud/ai_platform/v1/version.rb +1 -1
  11. data/lib/google/cloud/ai_platform/v1/vertex_rag_data_service/client.rb +198 -0
  12. data/lib/google/cloud/ai_platform/v1/vertex_rag_data_service/paths.rb +17 -0
  13. data/lib/google/cloud/ai_platform/v1/vertex_rag_data_service/rest/client.rb +184 -0
  14. data/lib/google/cloud/ai_platform/v1/vertex_rag_data_service/rest/service_stub.rb +123 -0
  15. data/lib/google/cloud/aiplatform/v1/endpoint_pb.rb +3 -1
  16. data/lib/google/cloud/aiplatform/v1/model_garden_service_pb.rb +14 -1
  17. data/lib/google/cloud/aiplatform/v1/model_garden_service_services_pb.rb +2 -0
  18. data/lib/google/cloud/aiplatform/v1/model_pb.rb +1 -1
  19. data/lib/google/cloud/aiplatform/v1/service_networking_pb.rb +3 -1
  20. data/lib/google/cloud/aiplatform/v1/vertex_rag_data_pb.rb +6 -1
  21. data/lib/google/cloud/aiplatform/v1/vertex_rag_data_service_pb.rb +4 -1
  22. data/lib/google/cloud/aiplatform/v1/vertex_rag_data_service_services_pb.rb +4 -0
  23. data/proto_docs/google/cloud/aiplatform/v1/endpoint.rb +31 -6
  24. data/proto_docs/google/cloud/aiplatform/v1/model.rb +10 -0
  25. data/proto_docs/google/cloud/aiplatform/v1/model_garden_service.rb +153 -0
  26. data/proto_docs/google/cloud/aiplatform/v1/service_networking.rb +61 -5
  27. data/proto_docs/google/cloud/aiplatform/v1/vertex_rag_data.rb +67 -0
  28. data/proto_docs/google/cloud/aiplatform/v1/vertex_rag_data_service.rb +35 -0
  29. metadata +3 -1
@@ -47,6 +47,159 @@ module Google
47
47
  extend ::Google::Protobuf::MessageExts::ClassMethods
48
48
  end
49
49
 
50
+ # Request message for
51
+ # {::Google::Cloud::AIPlatform::V1::ModelGardenService::Client#deploy ModelGardenService.Deploy}.
52
+ # @!attribute [rw] publisher_model_name
53
+ # @return [::String]
54
+ # The Model Garden model to deploy.
55
+ # Format:
56
+ # `publishers/{publisher}/models/{publisher_model}@{version_id}`, or
57
+ # `publishers/hf-{hugging-face-author}/models/{hugging-face-model-name}@001`.
58
+ #
59
+ # Note: The following fields are mutually exclusive: `publisher_model_name`, `hugging_face_model_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
60
+ # @!attribute [rw] hugging_face_model_id
61
+ # @return [::String]
62
+ # The Hugging Face model to deploy.
63
+ # Format: Hugging Face model ID like `google/gemma-2-2b-it`.
64
+ #
65
+ # Note: The following fields are mutually exclusive: `hugging_face_model_id`, `publisher_model_name`. If a field in that set is populated, all other fields in the set will automatically be cleared.
66
+ # @!attribute [rw] destination
67
+ # @return [::String]
68
+ # Required. The resource name of the Location to deploy the model in.
69
+ # Format: `projects/{project}/locations/{location}`
70
+ # @!attribute [rw] model_config
71
+ # @return [::Google::Cloud::AIPlatform::V1::DeployRequest::ModelConfig]
72
+ # Optional. The model config to use for the deployment.
73
+ # If not specified, the default model config will be used.
74
+ # @!attribute [rw] endpoint_config
75
+ # @return [::Google::Cloud::AIPlatform::V1::DeployRequest::EndpointConfig]
76
+ # Optional. The endpoint config to use for the deployment.
77
+ # If not specified, the default endpoint config will be used.
78
+ # @!attribute [rw] deploy_config
79
+ # @return [::Google::Cloud::AIPlatform::V1::DeployRequest::DeployConfig]
80
+ # Optional. The deploy config to use for the deployment.
81
+ # If not specified, the default deploy config will be used.
82
+ class DeployRequest
83
+ include ::Google::Protobuf::MessageExts
84
+ extend ::Google::Protobuf::MessageExts::ClassMethods
85
+
86
+ # The model config to use for the deployment.
87
+ # @!attribute [rw] accept_eula
88
+ # @return [::Boolean]
89
+ # Optional. Whether the user accepts the End User License Agreement (EULA)
90
+ # for the model.
91
+ # @!attribute [rw] hugging_face_access_token
92
+ # @return [::String]
93
+ # Optional. The Hugging Face read access token used to access the model
94
+ # artifacts of gated models.
95
+ # @!attribute [rw] hugging_face_cache_enabled
96
+ # @return [::Boolean]
97
+ # Optional. If true, the model will deploy with a cached version instead of
98
+ # directly downloading the model artifacts from Hugging Face. This is
99
+ # suitable for VPC-SC users with limited internet access.
100
+ # @!attribute [rw] model_display_name
101
+ # @return [::String]
102
+ # Optional. The user-specified display name of the uploaded model. If not
103
+ # set, a default name will be used.
104
+ # @!attribute [rw] container_spec
105
+ # @return [::Google::Cloud::AIPlatform::V1::ModelContainerSpec]
106
+ # Optional. The specification of the container that is to be used when
107
+ # deploying. If not set, the default container spec will be used.
108
+ class ModelConfig
109
+ include ::Google::Protobuf::MessageExts
110
+ extend ::Google::Protobuf::MessageExts::ClassMethods
111
+ end
112
+
113
+ # The endpoint config to use for the deployment.
114
+ # @!attribute [rw] endpoint_display_name
115
+ # @return [::String]
116
+ # Optional. The user-specified display name of the endpoint. If not set, a
117
+ # default name will be used.
118
+ # @!attribute [rw] dedicated_endpoint_enabled
119
+ # @return [::Boolean]
120
+ # Optional. If true, the endpoint will be exposed through a dedicated
121
+ # DNS [Endpoint.dedicated_endpoint_dns]. Your request to the dedicated DNS
122
+ # will be isolated from other users' traffic and will have better
123
+ # performance and reliability. Note: Once you enabled dedicated endpoint,
124
+ # you won't be able to send request to the shared DNS
125
+ # \\{region}-aiplatform.googleapis.com. The limitations will be removed soon.
126
+ class EndpointConfig
127
+ include ::Google::Protobuf::MessageExts
128
+ extend ::Google::Protobuf::MessageExts::ClassMethods
129
+ end
130
+
131
+ # The deploy config to use for the deployment.
132
+ # @!attribute [rw] dedicated_resources
133
+ # @return [::Google::Cloud::AIPlatform::V1::DedicatedResources]
134
+ # Optional. The dedicated resources to use for the endpoint. If not set,
135
+ # the default resources will be used.
136
+ # @!attribute [rw] fast_tryout_enabled
137
+ # @return [::Boolean]
138
+ # Optional. If true, enable the QMT fast tryout feature for this model if
139
+ # possible.
140
+ # @!attribute [rw] system_labels
141
+ # @return [::Google::Protobuf::Map{::String => ::String}]
142
+ # Optional. System labels for Model Garden deployments.
143
+ # These labels are managed by Google and for tracking purposes only.
144
+ class DeployConfig
145
+ include ::Google::Protobuf::MessageExts
146
+ extend ::Google::Protobuf::MessageExts::ClassMethods
147
+
148
+ # @!attribute [rw] key
149
+ # @return [::String]
150
+ # @!attribute [rw] value
151
+ # @return [::String]
152
+ class SystemLabelsEntry
153
+ include ::Google::Protobuf::MessageExts
154
+ extend ::Google::Protobuf::MessageExts::ClassMethods
155
+ end
156
+ end
157
+ end
158
+
159
+ # Response message for
160
+ # {::Google::Cloud::AIPlatform::V1::ModelGardenService::Client#deploy ModelGardenService.Deploy}.
161
+ # @!attribute [r] publisher_model
162
+ # @return [::String]
163
+ # Output only. The name of the PublisherModel resource.
164
+ # Format:
165
+ # `publishers/{publisher}/models/{publisher_model}@{version_id}`, or
166
+ # `publishers/hf-{hugging-face-author}/models/{hugging-face-model-name}@001`
167
+ # @!attribute [r] endpoint
168
+ # @return [::String]
169
+ # Output only. The name of the Endpoint created.
170
+ # Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`
171
+ # @!attribute [r] model
172
+ # @return [::String]
173
+ # Output only. The name of the Model created.
174
+ # Format: `projects/{project}/locations/{location}/models/{model}`
175
+ class DeployResponse
176
+ include ::Google::Protobuf::MessageExts
177
+ extend ::Google::Protobuf::MessageExts::ClassMethods
178
+ end
179
+
180
+ # Runtime operation information for
181
+ # {::Google::Cloud::AIPlatform::V1::ModelGardenService::Client#deploy ModelGardenService.Deploy}.
182
+ # @!attribute [rw] generic_metadata
183
+ # @return [::Google::Cloud::AIPlatform::V1::GenericOperationMetadata]
184
+ # The operation generic information.
185
+ # @!attribute [r] publisher_model
186
+ # @return [::String]
187
+ # Output only. The name of the model resource.
188
+ # @!attribute [r] destination
189
+ # @return [::String]
190
+ # Output only. The resource name of the Location to deploy the model in.
191
+ # Format: `projects/{project}/locations/{location}`
192
+ # @!attribute [r] project_number
193
+ # @return [::Integer]
194
+ # Output only. The project number where the deploy model request is sent.
195
+ # @!attribute [r] model_id
196
+ # @return [::String]
197
+ # Output only. The model id to be used at query time.
198
+ class DeployOperationMetadata
199
+ include ::Google::Protobuf::MessageExts
200
+ extend ::Google::Protobuf::MessageExts::ClassMethods
201
+ end
202
+
50
203
  # View enumeration of PublisherModel.
51
204
  module PublisherModelView
52
205
  # The default / unset value. The API will default to the BASIC view.
@@ -21,8 +21,8 @@ module Google
21
21
  module Cloud
22
22
  module AIPlatform
23
23
  module V1
24
- # PSC config that is used to automatically create forwarding rule via
25
- # ServiceConnectionMap.
24
+ # PSC config that is used to automatically create PSC endpoints in the user
25
+ # projects.
26
26
  # @!attribute [rw] project_id
27
27
  # @return [::String]
28
28
  # Required. Project id used to create forwarding rule.
@@ -30,10 +30,20 @@ module Google
30
30
  # @return [::String]
31
31
  # Required. The full name of the Google Compute Engine
32
32
  # [network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks).
33
- # [Format](https://cloud.google.com/compute/docs/reference/rest/v1/networks/insert):
33
+ # [Format](https://cloud.google.com/compute/docs/reference/rest/v1/networks/get):
34
34
  # `projects/{project}/global/networks/{network}`.
35
- # Where \\{project} is a project number, as in '12345', and \\{network} is
36
- # network name.
35
+ # @!attribute [r] ip_address
36
+ # @return [::String]
37
+ # Output only. IP address rule created by the PSC service automation.
38
+ # @!attribute [r] forwarding_rule
39
+ # @return [::String]
40
+ # Output only. Forwarding rule created by the PSC service automation.
41
+ # @!attribute [r] state
42
+ # @return [::Google::Cloud::AIPlatform::V1::PSCAutomationState]
43
+ # Output only. The state of the PSC service automation.
44
+ # @!attribute [r] error_message
45
+ # @return [::String]
46
+ # Output only. Error message if the PSC service automation failed.
37
47
  class PSCAutomationConfig
38
48
  include ::Google::Protobuf::MessageExts
39
49
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -47,6 +57,10 @@ module Google
47
57
  # @return [::Array<::String>]
48
58
  # A list of Projects from which the forwarding rule will target the service
49
59
  # attachment.
60
+ # @!attribute [rw] psc_automation_configs
61
+ # @return [::Array<::Google::Cloud::AIPlatform::V1::PSCAutomationConfig>]
62
+ # Optional. List of projects and networks where the PSC endpoints will be
63
+ # created. This field is used by Online Inference(Prediction) only.
50
64
  # @!attribute [r] service_attachment
51
65
  # @return [::String]
52
66
  # Output only. The name of the generated service attachment resource.
@@ -83,10 +97,52 @@ module Google
83
97
  # To specify this field, you must have already [created a network attachment]
84
98
  # (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments).
85
99
  # This field is only used for resources using PSC-I.
100
+ # @!attribute [rw] dns_peering_configs
101
+ # @return [::Array<::Google::Cloud::AIPlatform::V1::DnsPeeringConfig>]
102
+ # Optional. DNS peering configurations. When specified, Vertex AI will
103
+ # attempt to configure DNS peering zones in the tenant project VPC
104
+ # to resolve the specified domains using the target network's Cloud DNS.
105
+ # The user must grant the dns.peer role to the Vertex AI Service Agent
106
+ # on the target project.
86
107
  class PscInterfaceConfig
87
108
  include ::Google::Protobuf::MessageExts
88
109
  extend ::Google::Protobuf::MessageExts::ClassMethods
89
110
  end
111
+
112
+ # DNS peering configuration. These configurations are used to create
113
+ # DNS peering zones in the Vertex tenant project VPC, enabling resolution
114
+ # of records within the specified domain hosted in the target network's
115
+ # Cloud DNS.
116
+ # @!attribute [rw] domain
117
+ # @return [::String]
118
+ # Required. The DNS name suffix of the zone being peered to, e.g.,
119
+ # "my-internal-domain.corp.". Must end with a dot.
120
+ # @!attribute [rw] target_project
121
+ # @return [::String]
122
+ # Required. The project ID hosting the Cloud DNS managed zone that
123
+ # contains the 'domain'. The Vertex AI Service Agent requires the
124
+ # dns.peer role on this project.
125
+ # @!attribute [rw] target_network
126
+ # @return [::String]
127
+ # Required. The VPC network name
128
+ # in the target_project where the DNS zone specified by 'domain' is
129
+ # visible.
130
+ class DnsPeeringConfig
131
+ include ::Google::Protobuf::MessageExts
132
+ extend ::Google::Protobuf::MessageExts::ClassMethods
133
+ end
134
+
135
+ # The state of the PSC service automation.
136
+ module PSCAutomationState
137
+ # Should not be used.
138
+ PSC_AUTOMATION_STATE_UNSPECIFIED = 0
139
+
140
+ # The PSC service automation is successful.
141
+ PSC_AUTOMATION_STATE_SUCCESSFUL = 1
142
+
143
+ # The PSC service automation has failed.
144
+ PSC_AUTOMATION_STATE_FAILED = 2
145
+ end
90
146
  end
91
147
  end
92
148
  end
@@ -544,6 +544,73 @@ module Google
544
544
  include ::Google::Protobuf::MessageExts
545
545
  extend ::Google::Protobuf::MessageExts::ClassMethods
546
546
  end
547
+
548
+ # Configuration message for RagManagedDb used by RagEngine.
549
+ # @!attribute [rw] scaled
550
+ # @return [::Google::Cloud::AIPlatform::V1::RagManagedDbConfig::Scaled]
551
+ # Sets the RagManagedDb to the Scaled tier.
552
+ #
553
+ # Note: The following fields are mutually exclusive: `scaled`, `basic`, `unprovisioned`. If a field in that set is populated, all other fields in the set will automatically be cleared.
554
+ # @!attribute [rw] basic
555
+ # @return [::Google::Cloud::AIPlatform::V1::RagManagedDbConfig::Basic]
556
+ # Sets the RagManagedDb to the Basic tier.
557
+ #
558
+ # Note: The following fields are mutually exclusive: `basic`, `scaled`, `unprovisioned`. If a field in that set is populated, all other fields in the set will automatically be cleared.
559
+ # @!attribute [rw] unprovisioned
560
+ # @return [::Google::Cloud::AIPlatform::V1::RagManagedDbConfig::Unprovisioned]
561
+ # Sets the RagManagedDb to the Unprovisioned tier.
562
+ #
563
+ # Note: The following fields are mutually exclusive: `unprovisioned`, `scaled`, `basic`. If a field in that set is populated, all other fields in the set will automatically be cleared.
564
+ class RagManagedDbConfig
565
+ include ::Google::Protobuf::MessageExts
566
+ extend ::Google::Protobuf::MessageExts::ClassMethods
567
+
568
+ # Scaled tier offers production grade performance along with
569
+ # autoscaling functionality. It is suitable for customers with large
570
+ # amounts of data or performance sensitive workloads.
571
+ class Scaled
572
+ include ::Google::Protobuf::MessageExts
573
+ extend ::Google::Protobuf::MessageExts::ClassMethods
574
+ end
575
+
576
+ # Basic tier is a cost-effective and low compute tier suitable for
577
+ # the following cases:
578
+ # * Experimenting with RagManagedDb.
579
+ # * Small data size.
580
+ # * Latency insensitive workload.
581
+ # * Only using RAG Engine with external vector DBs.
582
+ #
583
+ # NOTE: This is the default tier if not explicitly chosen.
584
+ class Basic
585
+ include ::Google::Protobuf::MessageExts
586
+ extend ::Google::Protobuf::MessageExts::ClassMethods
587
+ end
588
+
589
+ # Disables the RAG Engine service and deletes all your data held
590
+ # within this service. This will halt the billing of the service.
591
+ #
592
+ # NOTE: Once deleted the data cannot be recovered. To start using
593
+ # RAG Engine again, you will need to update the tier by calling the
594
+ # UpdateRagEngineConfig API.
595
+ class Unprovisioned
596
+ include ::Google::Protobuf::MessageExts
597
+ extend ::Google::Protobuf::MessageExts::ClassMethods
598
+ end
599
+ end
600
+
601
+ # Config for RagEngine.
602
+ # @!attribute [rw] name
603
+ # @return [::String]
604
+ # Identifier. The name of the RagEngineConfig.
605
+ # Format:
606
+ # `projects/{project}/locations/{location}/ragEngineConfig`
607
+ # @!attribute [rw] rag_managed_db_config
608
+ # @return [::Google::Cloud::AIPlatform::V1::RagManagedDbConfig]
609
+ # The config of the RagManagedDb used by RagEngine.
610
+ class RagEngineConfig
611
+ include ::Google::Protobuf::MessageExts
612
+ extend ::Google::Protobuf::MessageExts::ClassMethods
613
+ end
547
614
  end
548
615
  end
549
616
  end
@@ -255,6 +255,18 @@ module Google
255
255
  extend ::Google::Protobuf::MessageExts::ClassMethods
256
256
  end
257
257
 
258
+ # Request message for
259
+ # {::Google::Cloud::AIPlatform::V1::VertexRagDataService::Client#get_rag_engine_config VertexRagDataService.GetRagEngineConfig}
260
+ # @!attribute [rw] name
261
+ # @return [::String]
262
+ # Required. The name of the RagEngineConfig resource.
263
+ # Format:
264
+ # `projects/{project}/locations/{location}/ragEngineConfig`
265
+ class GetRagEngineConfigRequest
266
+ include ::Google::Protobuf::MessageExts
267
+ extend ::Google::Protobuf::MessageExts::ClassMethods
268
+ end
269
+
258
270
  # Request message for
259
271
  # {::Google::Cloud::AIPlatform::V1::VertexRagDataService::Client#update_rag_corpus VertexRagDataService.UpdateRagCorpus}.
260
272
  # @!attribute [rw] rag_corpus
@@ -295,6 +307,29 @@ module Google
295
307
  include ::Google::Protobuf::MessageExts
296
308
  extend ::Google::Protobuf::MessageExts::ClassMethods
297
309
  end
310
+
311
+ # Request message for
312
+ # {::Google::Cloud::AIPlatform::V1::VertexRagDataService::Client#update_rag_engine_config VertexRagDataService.UpdateRagEngineConfig}.
313
+ # @!attribute [rw] rag_engine_config
314
+ # @return [::Google::Cloud::AIPlatform::V1::RagEngineConfig]
315
+ # Required. The updated RagEngineConfig.
316
+ #
317
+ # NOTE: Downgrading your RagManagedDb's ComputeTier could temporarily
318
+ # increase request latencies until the operation is fully complete.
319
+ class UpdateRagEngineConfigRequest
320
+ include ::Google::Protobuf::MessageExts
321
+ extend ::Google::Protobuf::MessageExts::ClassMethods
322
+ end
323
+
324
+ # Runtime operation information for
325
+ # {::Google::Cloud::AIPlatform::V1::VertexRagDataService::Client#update_rag_engine_config VertexRagDataService.UpdateRagEngineConfig}.
326
+ # @!attribute [rw] generic_metadata
327
+ # @return [::Google::Cloud::AIPlatform::V1::GenericOperationMetadata]
328
+ # The operation generic information.
329
+ class UpdateRagEngineConfigOperationMetadata
330
+ include ::Google::Protobuf::MessageExts
331
+ extend ::Google::Protobuf::MessageExts::ClassMethods
332
+ end
298
333
  end
299
334
  end
300
335
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-ai_platform-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.15.0
4
+ version: 1.17.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
@@ -235,9 +235,11 @@ files:
235
235
  - lib/google/cloud/ai_platform/v1/model_garden_service.rb
236
236
  - lib/google/cloud/ai_platform/v1/model_garden_service/client.rb
237
237
  - lib/google/cloud/ai_platform/v1/model_garden_service/credentials.rb
238
+ - lib/google/cloud/ai_platform/v1/model_garden_service/operations.rb
238
239
  - lib/google/cloud/ai_platform/v1/model_garden_service/paths.rb
239
240
  - lib/google/cloud/ai_platform/v1/model_garden_service/rest.rb
240
241
  - lib/google/cloud/ai_platform/v1/model_garden_service/rest/client.rb
242
+ - lib/google/cloud/ai_platform/v1/model_garden_service/rest/operations.rb
241
243
  - lib/google/cloud/ai_platform/v1/model_garden_service/rest/service_stub.rb
242
244
  - lib/google/cloud/ai_platform/v1/model_service.rb
243
245
  - lib/google/cloud/ai_platform/v1/model_service/client.rb