feat(compute): add missing services instant_snapshots and region_instant_snapshots (googleapis#14647)

Author: scotthart

ci/etc/expected_install_directories

@@ -328,6 +328,10 @@
 ./include/google/cloud/compute/instances/v1
 ./include/google/cloud/compute/instances/v1/internal
 ./include/google/cloud/compute/instances/v1/mocks
+./include/google/cloud/compute/instant_snapshots
+./include/google/cloud/compute/instant_snapshots/v1
+./include/google/cloud/compute/instant_snapshots/v1/internal
+./include/google/cloud/compute/instant_snapshots/v1/mocks
 ./include/google/cloud/compute/interconnect_attachments
 ./include/google/cloud/compute/interconnect_attachments/v1
 ./include/google/cloud/compute/interconnect_attachments/v1/internal
@@ -452,6 +456,10 @@
 ./include/google/cloud/compute/region_instances/v1
 ./include/google/cloud/compute/region_instances/v1/internal
 ./include/google/cloud/compute/region_instances/v1/mocks
+./include/google/cloud/compute/region_instant_snapshots
+./include/google/cloud/compute/region_instant_snapshots/v1
+./include/google/cloud/compute/region_instant_snapshots/v1/internal
+./include/google/cloud/compute/region_instant_snapshots/v1/mocks
 ./include/google/cloud/compute/region_network_endpoint_groups
 ./include/google/cloud/compute/region_network_endpoint_groups/v1
 ./include/google/cloud/compute/region_network_endpoint_groups/v1/internal

generator/generator_config.textproto

@@ -999,6 +999,15 @@ discovery_products {
     generate_grpc_transport: false
   }
 
+  rest_services {
+    service_proto_path: "google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto"
+    product_path: "google/cloud/compute/instant_snapshots/v1"
+    initial_copyright_year: "2024"
+    retryable_status_codes: ["kUnavailable"]
+    generate_rest_transport: true
+    generate_grpc_transport: false
+  }
+
   rest_services {
     service_proto_path: "google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto"
     product_path: "google/cloud/compute/interconnect_attachments/v1"
@@ -1278,6 +1287,15 @@ discovery_products {
     generate_grpc_transport: false
   }
 
+  rest_services {
+    service_proto_path: "google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto"
+    product_path: "google/cloud/compute/region_instant_snapshots/v1"
+    initial_copyright_year: "2024"
+    retryable_status_codes: ["kUnavailable"]
+    generate_rest_transport: true
+    generate_grpc_transport: false
+  }
+
   rest_services {
     service_proto_path: "google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto"
     product_path: "google/cloud/compute/region_network_endpoint_groups/v1"

google/cloud/compute/doc/environment-variables.dox

@@ -126,6 +126,10 @@ environment variables are convenient when troubleshooting problems.
   `EndpointOption` (which defaults to "compute.googleapis.com")
   used by `MakeInstanceTemplatesConnection()`.
 
+- `GOOGLE_CLOUD_CPP_INSTANT_SNAPSHOTS_ENDPOINT=...` overrides the
+  `EndpointOption` (which defaults to "compute.googleapis.com")
+  used by `MakeInstantSnapshotsConnection()`.
+
 - `GOOGLE_CLOUD_CPP_INTERCONNECTS_ENDPOINT=...` overrides the
   `EndpointOption` (which defaults to "compute.googleapis.com")
   used by `MakeInterconnectsConnection()`.
@@ -254,6 +258,10 @@ environment variables are convenient when troubleshooting problems.
   `EndpointOption` (which defaults to "compute.googleapis.com")
   used by `MakeRegionInstanceTemplatesConnection()`.
 
+- `GOOGLE_CLOUD_CPP_REGION_INSTANT_SNAPSHOTS_ENDPOINT=...` overrides the
+  `EndpointOption` (which defaults to "compute.googleapis.com")
+  used by `MakeRegionInstantSnapshotsConnection()`.
+
 - `GOOGLE_CLOUD_CPP_REGION_NETWORK_ENDPOINT_GROUPS_ENDPOINT=...` overrides the
   `EndpointOption` (which defaults to "compute.googleapis.com")
   used by `MakeRegionNetworkEndpointGroupsConnection()`.

google/cloud/compute/doc/main.dox

@@ -60,6 +60,7 @@ application.
 - [\c compute_instance_settings_v1::InstanceSettingsClient](@ref google::cloud::compute_instance_settings_v1::InstanceSettingsClient)
 - [\c compute_instance_templates_v1::InstanceTemplatesClient](@ref google::cloud::compute_instance_templates_v1::InstanceTemplatesClient)
 - [\c compute_instances_v1::InstancesClient](@ref google::cloud::compute_instances_v1::InstancesClient)
+- [\c compute_instant_snapshots_v1::InstantSnapshotsClient](@ref google::cloud::compute_instant_snapshots_v1::InstantSnapshotsClient)
 - [\c compute_interconnect_attachments_v1::InterconnectAttachmentsClient](@ref google::cloud::compute_interconnect_attachments_v1::InterconnectAttachmentsClient)
 - [\c compute_interconnect_locations_v1::InterconnectLocationsClient](@ref google::cloud::compute_interconnect_locations_v1::InterconnectLocationsClient)
 - [\c compute_interconnect_remote_locations_v1::InterconnectRemoteLocationsClient](@ref google::cloud::compute_interconnect_remote_locations_v1::InterconnectRemoteLocationsClient)
@@ -91,6 +92,7 @@ application.
 - [\c compute_region_instance_groups_v1::RegionInstanceGroupsClient](@ref google::cloud::compute_region_instance_groups_v1::RegionInstanceGroupsClient)
 - [\c compute_region_instance_templates_v1::RegionInstanceTemplatesClient](@ref google::cloud::compute_region_instance_templates_v1::RegionInstanceTemplatesClient)
 - [\c compute_region_instances_v1::RegionInstancesClient](@ref google::cloud::compute_region_instances_v1::RegionInstancesClient)
+- [\c compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient](@ref google::cloud::compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient)
 - [\c compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient](@ref google::cloud::compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient)
 - [\c compute_region_network_firewall_policies_v1::RegionNetworkFirewallPoliciesClient](@ref google::cloud::compute_region_network_firewall_policies_v1::RegionNetworkFirewallPoliciesClient)
 - [\c compute_region_notification_endpoints_v1::RegionNotificationEndpointsClient](@ref google::cloud::compute_region_notification_endpoints_v1::RegionNotificationEndpointsClient)

google/cloud/compute/doc/override-authentication.dox

@@ -42,6 +42,7 @@ Follow these links to find examples for other \c *Client classes:
 - [\c compute_instance_settings_v1::InstanceSettingsClient](@ref compute_instance_settings_v1::InstanceSettingsClient-service-account-snippet)
 - [\c compute_instance_templates_v1::InstanceTemplatesClient](@ref compute_instance_templates_v1::InstanceTemplatesClient-service-account-snippet)
 - [\c compute_instances_v1::InstancesClient](@ref compute_instances_v1::InstancesClient-service-account-snippet)
+- [\c compute_instant_snapshots_v1::InstantSnapshotsClient](@ref compute_instant_snapshots_v1::InstantSnapshotsClient-service-account-snippet)
 - [\c compute_interconnect_attachments_v1::InterconnectAttachmentsClient](@ref compute_interconnect_attachments_v1::InterconnectAttachmentsClient-service-account-snippet)
 - [\c compute_interconnect_locations_v1::InterconnectLocationsClient](@ref compute_interconnect_locations_v1::InterconnectLocationsClient-service-account-snippet)
 - [\c compute_interconnect_remote_locations_v1::InterconnectRemoteLocationsClient](@ref compute_interconnect_remote_locations_v1::InterconnectRemoteLocationsClient-service-account-snippet)
@@ -73,6 +74,7 @@ Follow these links to find examples for other \c *Client classes:
 - [\c compute_region_instance_groups_v1::RegionInstanceGroupsClient](@ref compute_region_instance_groups_v1::RegionInstanceGroupsClient-service-account-snippet)
 - [\c compute_region_instance_templates_v1::RegionInstanceTemplatesClient](@ref compute_region_instance_templates_v1::RegionInstanceTemplatesClient-service-account-snippet)
 - [\c compute_region_instances_v1::RegionInstancesClient](@ref compute_region_instances_v1::RegionInstancesClient-service-account-snippet)
+- [\c compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient](@ref compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient-service-account-snippet)
 - [\c compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient](@ref compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient-service-account-snippet)
 - [\c compute_region_network_firewall_policies_v1::RegionNetworkFirewallPoliciesClient](@ref compute_region_network_firewall_policies_v1::RegionNetworkFirewallPoliciesClient-service-account-snippet)
 - [\c compute_region_notification_endpoints_v1::RegionNotificationEndpointsClient](@ref compute_region_notification_endpoints_v1::RegionNotificationEndpointsClient-service-account-snippet)
@@ -303,6 +305,12 @@ guide for more details.
 
 */
 
+/*! @page compute_instant_snapshots_v1::InstantSnapshotsClient-service-account-snippet Override compute_instant_snapshots_v1::InstantSnapshotsClient Authentication Defaults
+
+@snippet google/cloud/compute/instant_snapshots/v1/samples/instant_snapshots_client_samples.cc with-service-account
+
+*/
+
 /*! @page compute_interconnect_attachments_v1::InterconnectAttachmentsClient-service-account-snippet Override compute_interconnect_attachments_v1::InterconnectAttachmentsClient Authentication Defaults
 
 @snippet google/cloud/compute/interconnect_attachments/v1/samples/interconnect_attachments_client_samples.cc with-service-account
@@ -489,6 +497,12 @@ guide for more details.
 
 */
 
+/*! @page compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient-service-account-snippet Override compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient Authentication Defaults
+
+@snippet google/cloud/compute/region_instant_snapshots/v1/samples/region_instant_snapshots_client_samples.cc with-service-account
+
+*/
+
 /*! @page compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient-service-account-snippet Override compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient Authentication Defaults
 
 @snippet google/cloud/compute/region_network_endpoint_groups/v1/samples/region_network_endpoint_groups_client_samples.cc with-service-account

google/cloud/compute/doc/override-endpoint.dox

@@ -42,6 +42,7 @@ Follow these links to find examples for other \c *Client classes:
 - [\c compute_instance_settings_v1::InstanceSettingsClient](@ref compute_instance_settings_v1::InstanceSettingsClient-endpoint-snippet)
 - [\c compute_instance_templates_v1::InstanceTemplatesClient](@ref compute_instance_templates_v1::InstanceTemplatesClient-endpoint-snippet)
 - [\c compute_instances_v1::InstancesClient](@ref compute_instances_v1::InstancesClient-endpoint-snippet)
+- [\c compute_instant_snapshots_v1::InstantSnapshotsClient](@ref compute_instant_snapshots_v1::InstantSnapshotsClient-endpoint-snippet)
 - [\c compute_interconnect_attachments_v1::InterconnectAttachmentsClient](@ref compute_interconnect_attachments_v1::InterconnectAttachmentsClient-endpoint-snippet)
 - [\c compute_interconnect_locations_v1::InterconnectLocationsClient](@ref compute_interconnect_locations_v1::InterconnectLocationsClient-endpoint-snippet)
 - [\c compute_interconnect_remote_locations_v1::InterconnectRemoteLocationsClient](@ref compute_interconnect_remote_locations_v1::InterconnectRemoteLocationsClient-endpoint-snippet)
@@ -73,6 +74,7 @@ Follow these links to find examples for other \c *Client classes:
 - [\c compute_region_instance_groups_v1::RegionInstanceGroupsClient](@ref compute_region_instance_groups_v1::RegionInstanceGroupsClient-endpoint-snippet)
 - [\c compute_region_instance_templates_v1::RegionInstanceTemplatesClient](@ref compute_region_instance_templates_v1::RegionInstanceTemplatesClient-endpoint-snippet)
 - [\c compute_region_instances_v1::RegionInstancesClient](@ref compute_region_instances_v1::RegionInstancesClient-endpoint-snippet)
+- [\c compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient](@ref compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient-endpoint-snippet)
 - [\c compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient](@ref compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient-endpoint-snippet)
 - [\c compute_region_network_firewall_policies_v1::RegionNetworkFirewallPoliciesClient](@ref compute_region_network_firewall_policies_v1::RegionNetworkFirewallPoliciesClient-endpoint-snippet)
 - [\c compute_region_notification_endpoints_v1::RegionNotificationEndpointsClient](@ref compute_region_notification_endpoints_v1::RegionNotificationEndpointsClient-endpoint-snippet)
@@ -293,6 +295,12 @@ Follow these links to find examples for other \c *Client classes:
 
 */
 
+/*! @page compute_instant_snapshots_v1::InstantSnapshotsClient-endpoint-snippet Override compute_instant_snapshots_v1::InstantSnapshotsClient Endpoint Configuration
+
+@snippet google/cloud/compute/instant_snapshots/v1/samples/instant_snapshots_client_samples.cc set-client-endpoint
+
+*/
+
 /*! @page compute_interconnect_attachments_v1::InterconnectAttachmentsClient-endpoint-snippet Override compute_interconnect_attachments_v1::InterconnectAttachmentsClient Endpoint Configuration
 
 @snippet google/cloud/compute/interconnect_attachments/v1/samples/interconnect_attachments_client_samples.cc set-client-endpoint
@@ -479,6 +487,12 @@ Follow these links to find examples for other \c *Client classes:
 
 */
 
+/*! @page compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient-endpoint-snippet Override compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient Endpoint Configuration
+
+@snippet google/cloud/compute/region_instant_snapshots/v1/samples/region_instant_snapshots_client_samples.cc set-client-endpoint
+
+*/
+
 /*! @page compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient-endpoint-snippet Override compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient Endpoint Configuration
 
 @snippet google/cloud/compute/region_network_endpoint_groups/v1/samples/region_network_endpoint_groups_client_samples.cc set-client-endpoint

google/cloud/compute/doc/override-retry-policies.dox

@@ -108,6 +108,7 @@ Follow these links to find examples for other \c *Client classes:
 - [\c compute_instance_settings_v1::InstanceSettingsClient](@ref compute_instance_settings_v1::InstanceSettingsClient-retry-snippet)
 - [\c compute_instance_templates_v1::InstanceTemplatesClient](@ref compute_instance_templates_v1::InstanceTemplatesClient-retry-snippet)
 - [\c compute_instances_v1::InstancesClient](@ref compute_instances_v1::InstancesClient-retry-snippet)
+- [\c compute_instant_snapshots_v1::InstantSnapshotsClient](@ref compute_instant_snapshots_v1::InstantSnapshotsClient-retry-snippet)
 - [\c compute_interconnect_attachments_v1::InterconnectAttachmentsClient](@ref compute_interconnect_attachments_v1::InterconnectAttachmentsClient-retry-snippet)
 - [\c compute_interconnect_locations_v1::InterconnectLocationsClient](@ref compute_interconnect_locations_v1::InterconnectLocationsClient-retry-snippet)
 - [\c compute_interconnect_remote_locations_v1::InterconnectRemoteLocationsClient](@ref compute_interconnect_remote_locations_v1::InterconnectRemoteLocationsClient-retry-snippet)
@@ -139,6 +140,7 @@ Follow these links to find examples for other \c *Client classes:
 - [\c compute_region_instance_groups_v1::RegionInstanceGroupsClient](@ref compute_region_instance_groups_v1::RegionInstanceGroupsClient-retry-snippet)
 - [\c compute_region_instance_templates_v1::RegionInstanceTemplatesClient](@ref compute_region_instance_templates_v1::RegionInstanceTemplatesClient-retry-snippet)
 - [\c compute_region_instances_v1::RegionInstancesClient](@ref compute_region_instances_v1::RegionInstancesClient-retry-snippet)
+- [\c compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient](@ref compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient-retry-snippet)
 - [\c compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient](@ref compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient-retry-snippet)
 - [\c compute_region_network_firewall_policies_v1::RegionNetworkFirewallPoliciesClient](@ref compute_region_network_firewall_policies_v1::RegionNetworkFirewallPoliciesClient-retry-snippet)
 - [\c compute_region_notification_endpoints_v1::RegionNotificationEndpointsClient](@ref compute_region_notification_endpoints_v1::RegionNotificationEndpointsClient-retry-snippet)
@@ -541,6 +543,18 @@ Assuming you have created a custom idempotency policy. Such as:
 
 */
 
+/*! @page compute_instant_snapshots_v1::InstantSnapshotsClient-retry-snippet Override compute_instant_snapshots_v1::InstantSnapshotsClient Retry Policies
+
+This shows how to override the retry policies for compute_instant_snapshots_v1::InstantSnapshotsClient:
+
+@snippet google/cloud/compute/instant_snapshots/v1/samples/instant_snapshots_client_samples.cc set-retry-policy
+
+Assuming you have created a custom idempotency policy. Such as:
+
+@snippet google/cloud/compute/instant_snapshots/v1/samples/instant_snapshots_client_samples.cc custom-idempotency-policy
+
+*/
+
 /*! @page compute_interconnect_attachments_v1::InterconnectAttachmentsClient-retry-snippet Override compute_interconnect_attachments_v1::InterconnectAttachmentsClient Retry Policies
 
 This shows how to override the retry policies for compute_interconnect_attachments_v1::InterconnectAttachmentsClient:
@@ -913,6 +927,18 @@ Assuming you have created a custom idempotency policy. Such as:
 
 */
 
+/*! @page compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient-retry-snippet Override compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient Retry Policies
+
+This shows how to override the retry policies for compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient:
+
+@snippet google/cloud/compute/region_instant_snapshots/v1/samples/region_instant_snapshots_client_samples.cc set-retry-policy
+
+Assuming you have created a custom idempotency policy. Such as:
+
+@snippet google/cloud/compute/region_instant_snapshots/v1/samples/region_instant_snapshots_client_samples.cc custom-idempotency-policy
+
+*/
+
 /*! @page compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient-retry-snippet Override compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient Retry Policies
 
 This shows how to override the retry policies for compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient: