google-cloud-compute-v1 3.0.0

// 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
//
//     https://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.
//
// Code generated by sidekick. DO NOT EDIT.

//! Google Cloud Client Libraries for Rust - Google Compute Engine API
//!
//! This client library was generated from the "20260410" revision of the API.
//!
//! This crate contains traits, types, and functions to interact with Google Compute Engine API
//! Most applications will use the structs defined in the [client] module.
//!
//! The client library types and functions are stable and not expected to change.
//! Please note that Google Cloud services do change from time to time. The client
//! libraries are designed to preserve backwards compatibility when the service
//! changes in compatible ways. For example, adding RPCs, or fields to messages
//! should not introduce breaking changes to the client libraries.
//!
//! # Available Clients
//!
//! * [AcceleratorTypes](client/struct.AcceleratorTypes.html)
//! * [Addresses](client/struct.Addresses.html)
//! * [Advice](client/struct.Advice.html)
//! * [Autoscalers](client/struct.Autoscalers.html)
//! * [BackendBuckets](client/struct.BackendBuckets.html)
//! * [BackendServices](client/struct.BackendServices.html)
//! * [CrossSiteNetworks](client/struct.CrossSiteNetworks.html)
//! * [DiskTypes](client/struct.DiskTypes.html)
//! * [Disks](client/struct.Disks.html)
//! * [ExternalVpnGateways](client/struct.ExternalVpnGateways.html)
//! * [FirewallPolicies](client/struct.FirewallPolicies.html)
//! * [Firewalls](client/struct.Firewalls.html)
//! * [ForwardingRules](client/struct.ForwardingRules.html)
//! * [FutureReservations](client/struct.FutureReservations.html)
//! * [GlobalAddresses](client/struct.GlobalAddresses.html)
//! * [GlobalForwardingRules](client/struct.GlobalForwardingRules.html)
//! * [GlobalNetworkEndpointGroups](client/struct.GlobalNetworkEndpointGroups.html)
//! * [GlobalOperations](client/struct.GlobalOperations.html)
//! * [GlobalOrganizationOperations](client/struct.GlobalOrganizationOperations.html)
//! * [GlobalPublicDelegatedPrefixes](client/struct.GlobalPublicDelegatedPrefixes.html)
//! * [HealthChecks](client/struct.HealthChecks.html)
//! * [HttpHealthChecks](client/struct.HttpHealthChecks.html)
//! * [HttpsHealthChecks](client/struct.HttpsHealthChecks.html)
//! * [ImageFamilyViews](client/struct.ImageFamilyViews.html)
//! * [Images](client/struct.Images.html)
//! * [InstanceGroupManagerResizeRequests](client/struct.InstanceGroupManagerResizeRequests.html)
//! * [InstanceGroupManagers](client/struct.InstanceGroupManagers.html)
//! * [InstanceGroups](client/struct.InstanceGroups.html)
//! * [InstanceSettings](client/struct.InstanceSettings.html)
//! * [InstanceTemplates](client/struct.InstanceTemplates.html)
//! * [Instances](client/struct.Instances.html)
//! * [InstantSnapshotGroups](client/struct.InstantSnapshotGroups.html)
//! * [InstantSnapshots](client/struct.InstantSnapshots.html)
//! * [InterconnectAttachmentGroups](client/struct.InterconnectAttachmentGroups.html)
//! * [InterconnectAttachments](client/struct.InterconnectAttachments.html)
//! * [InterconnectGroups](client/struct.InterconnectGroups.html)
//! * [InterconnectLocations](client/struct.InterconnectLocations.html)
//! * [InterconnectRemoteLocations](client/struct.InterconnectRemoteLocations.html)
//! * [Interconnects](client/struct.Interconnects.html)
//! * [LicenseCodes](client/struct.LicenseCodes.html)
//! * [Licenses](client/struct.Licenses.html)
//! * [MachineImages](client/struct.MachineImages.html)
//! * [MachineTypes](client/struct.MachineTypes.html)
//! * [NetworkAttachments](client/struct.NetworkAttachments.html)
//! * [NetworkEdgeSecurityServices](client/struct.NetworkEdgeSecurityServices.html)
//! * [NetworkEndpointGroups](client/struct.NetworkEndpointGroups.html)
//! * [NetworkFirewallPolicies](client/struct.NetworkFirewallPolicies.html)
//! * [NetworkProfiles](client/struct.NetworkProfiles.html)
//! * [Networks](client/struct.Networks.html)
//! * [NodeGroups](client/struct.NodeGroups.html)
//! * [NodeTemplates](client/struct.NodeTemplates.html)
//! * [NodeTypes](client/struct.NodeTypes.html)
//! * [OrganizationSecurityPolicies](client/struct.OrganizationSecurityPolicies.html)
//! * [PacketMirrorings](client/struct.PacketMirrorings.html)
//! * [PreviewFeatures](client/struct.PreviewFeatures.html)
//! * [Projects](client/struct.Projects.html)
//! * [PublicAdvertisedPrefixes](client/struct.PublicAdvertisedPrefixes.html)
//! * [PublicDelegatedPrefixes](client/struct.PublicDelegatedPrefixes.html)
//! * [RegionAutoscalers](client/struct.RegionAutoscalers.html)
//! * [RegionBackendBuckets](client/struct.RegionBackendBuckets.html)
//! * [RegionBackendServices](client/struct.RegionBackendServices.html)
//! * [RegionCommitments](client/struct.RegionCommitments.html)
//! * [RegionCompositeHealthChecks](client/struct.RegionCompositeHealthChecks.html)
//! * [RegionDiskTypes](client/struct.RegionDiskTypes.html)
//! * [RegionDisks](client/struct.RegionDisks.html)
//! * [RegionHealthAggregationPolicies](client/struct.RegionHealthAggregationPolicies.html)
//! * [RegionHealthCheckServices](client/struct.RegionHealthCheckServices.html)
//! * [RegionHealthChecks](client/struct.RegionHealthChecks.html)
//! * [RegionHealthSources](client/struct.RegionHealthSources.html)
//! * [RegionInstanceGroupManagerResizeRequests](client/struct.RegionInstanceGroupManagerResizeRequests.html)
//! * [RegionInstanceGroupManagers](client/struct.RegionInstanceGroupManagers.html)
//! * [RegionInstanceGroups](client/struct.RegionInstanceGroups.html)
//! * [RegionInstanceTemplates](client/struct.RegionInstanceTemplates.html)
//! * [RegionInstances](client/struct.RegionInstances.html)
//! * [RegionInstantSnapshotGroups](client/struct.RegionInstantSnapshotGroups.html)
//! * [RegionInstantSnapshots](client/struct.RegionInstantSnapshots.html)
//! * [RegionNetworkEndpointGroups](client/struct.RegionNetworkEndpointGroups.html)
//! * [RegionNetworkFirewallPolicies](client/struct.RegionNetworkFirewallPolicies.html)
//! * [RegionNotificationEndpoints](client/struct.RegionNotificationEndpoints.html)
//! * [RegionOperations](client/struct.RegionOperations.html)
//! * [RegionSecurityPolicies](client/struct.RegionSecurityPolicies.html)
//! * [RegionSnapshotSettings](client/struct.RegionSnapshotSettings.html)
//! * [RegionSnapshots](client/struct.RegionSnapshots.html)
//! * [RegionSslCertificates](client/struct.RegionSslCertificates.html)
//! * [RegionSslPolicies](client/struct.RegionSslPolicies.html)
//! * [RegionTargetHttpProxies](client/struct.RegionTargetHttpProxies.html)
//! * [RegionTargetHttpsProxies](client/struct.RegionTargetHttpsProxies.html)
//! * [RegionTargetTcpProxies](client/struct.RegionTargetTcpProxies.html)
//! * [RegionUrlMaps](client/struct.RegionUrlMaps.html)
//! * [RegionZones](client/struct.RegionZones.html)
//! * [Regions](client/struct.Regions.html)
//! * [ReservationBlocks](client/struct.ReservationBlocks.html)
//! * [ReservationSlots](client/struct.ReservationSlots.html)
//! * [ReservationSubBlocks](client/struct.ReservationSubBlocks.html)
//! * [Reservations](client/struct.Reservations.html)
//! * [ResourcePolicies](client/struct.ResourcePolicies.html)
//! * [Routers](client/struct.Routers.html)
//! * [Routes](client/struct.Routes.html)
//! * [SecurityPolicies](client/struct.SecurityPolicies.html)
//! * [ServiceAttachments](client/struct.ServiceAttachments.html)
//! * [SnapshotSettings](client/struct.SnapshotSettings.html)
//! * [Snapshots](client/struct.Snapshots.html)
//! * [SslCertificates](client/struct.SslCertificates.html)
//! * [SslPolicies](client/struct.SslPolicies.html)
//! * [StoragePoolTypes](client/struct.StoragePoolTypes.html)
//! * [StoragePools](client/struct.StoragePools.html)
//! * [Subnetworks](client/struct.Subnetworks.html)
//! * [TargetGrpcProxies](client/struct.TargetGrpcProxies.html)
//! * [TargetHttpProxies](client/struct.TargetHttpProxies.html)
//! * [TargetHttpsProxies](client/struct.TargetHttpsProxies.html)
//! * [TargetInstances](client/struct.TargetInstances.html)
//! * [TargetPools](client/struct.TargetPools.html)
//! * [TargetSslProxies](client/struct.TargetSslProxies.html)
//! * [TargetTcpProxies](client/struct.TargetTcpProxies.html)
//! * [TargetVpnGateways](client/struct.TargetVpnGateways.html)
//! * [UrlMaps](client/struct.UrlMaps.html)
//! * [VpnGateways](client/struct.VpnGateways.html)
//! * [VpnTunnels](client/struct.VpnTunnels.html)
//! * [WireGroups](client/struct.WireGroups.html)
//! * [ZoneOperations](client/struct.ZoneOperations.html)
//! * [ZoneVmExtensionPolicies](client/struct.ZoneVmExtensionPolicies.html)
//! * [Zones](client/struct.Zones.html)
//!
//! # Features
//!
//! - `default-rustls-provider`: enabled by default. Use the default rustls
//!   crypto provider ([aws-lc-rs]) for TLS and authentication. Applications
//!   with specific requirements for cryptography (such as exclusively using the
//!   [ring] crate) should disable this default and call
//!   `rustls::crypto::CryptoProvider::install_default()`.
//! - Each client can be enabled using its own feature. Use the client's name
//!   in `kebab-case` to enable the client.
//!
//! [aws-lc-rs]: https://crates.io/crates/aws-lc-rs
//! [ring]: https://crates.io/crates/ring

#![cfg_attr(docsrs, feature(doc_cfg))]
#![allow(deprecated)]

/// The messages and enums that are part of this client library.
#[allow(clippy::module_inception)]
pub mod model;

pub use google_cloud_gax::Result;
pub use google_cloud_gax::error::Error;

#[allow(rustdoc::invalid_html_tags)]
#[allow(rustdoc::redundant_explicit_links)]
pub mod stub;

///
/// # Example
/// ```
/// # use google_cloud_compute_v1::client::Instances;
/// async fn sample(
/// ) -> anyhow::Result<()> {
///     let client = Instances::builder().build().await?;
///     // use `client` to make requests to the Google Compute Engine API.
///     Ok(())
/// }
/// ```
/// Concrete implementations of this client library traits.
pub mod client;

/// Request builders.
pub mod builder;

#[doc(hidden)]
pub(crate) mod tracing;

#[doc(hidden)]
pub(crate) mod transport;

/// The default host used by the service.
#[cfg(any(
    feature = "accelerator-types",
    feature = "addresses",
    feature = "advice",
    feature = "autoscalers",
    feature = "backend-buckets",
    feature = "backend-services",
    feature = "cross-site-networks",
    feature = "disk-types",
    feature = "disks",
    feature = "external-vpn-gateways",
    feature = "firewall-policies",
    feature = "firewalls",
    feature = "forwarding-rules",
    feature = "future-reservations",
    feature = "global-addresses",
    feature = "global-forwarding-rules",
    feature = "global-network-endpoint-groups",
    feature = "global-operations",
    feature = "global-organization-operations",
    feature = "global-public-delegated-prefixes",
    feature = "health-checks",
    feature = "http-health-checks",
    feature = "https-health-checks",
    feature = "image-family-views",
    feature = "images",
    feature = "instance-group-manager-resize-requests",
    feature = "instance-group-managers",
    feature = "instance-groups",
    feature = "instance-settings",
    feature = "instance-templates",
    feature = "instances",
    feature = "instant-snapshot-groups",
    feature = "instant-snapshots",
    feature = "interconnect-attachment-groups",
    feature = "interconnect-attachments",
    feature = "interconnect-groups",
    feature = "interconnect-locations",
    feature = "interconnect-remote-locations",
    feature = "interconnects",
    feature = "license-codes",
    feature = "licenses",
    feature = "machine-images",
    feature = "machine-types",
    feature = "network-attachments",
    feature = "network-edge-security-services",
    feature = "network-endpoint-groups",
    feature = "network-firewall-policies",
    feature = "network-profiles",
    feature = "networks",
    feature = "node-groups",
    feature = "node-templates",
    feature = "node-types",
    feature = "organization-security-policies",
    feature = "packet-mirrorings",
    feature = "preview-features",
    feature = "projects",
    feature = "public-advertised-prefixes",
    feature = "public-delegated-prefixes",
    feature = "region-autoscalers",
    feature = "region-backend-buckets",
    feature = "region-backend-services",
    feature = "region-commitments",
    feature = "region-composite-health-checks",
    feature = "region-disk-types",
    feature = "region-disks",
    feature = "region-health-aggregation-policies",
    feature = "region-health-check-services",
    feature = "region-health-checks",
    feature = "region-health-sources",
    feature = "region-instance-group-manager-resize-requests",
    feature = "region-instance-group-managers",
    feature = "region-instance-groups",
    feature = "region-instance-templates",
    feature = "region-instances",
    feature = "region-instant-snapshot-groups",
    feature = "region-instant-snapshots",
    feature = "region-network-endpoint-groups",
    feature = "region-network-firewall-policies",
    feature = "region-notification-endpoints",
    feature = "region-operations",
    feature = "region-security-policies",
    feature = "region-snapshot-settings",
    feature = "region-snapshots",
    feature = "region-ssl-certificates",
    feature = "region-ssl-policies",
    feature = "region-target-http-proxies",
    feature = "region-target-https-proxies",
    feature = "region-target-tcp-proxies",
    feature = "region-url-maps",
    feature = "region-zones",
    feature = "regions",
    feature = "reservation-blocks",
    feature = "reservation-slots",
    feature = "reservation-sub-blocks",
    feature = "reservations",
    feature = "resource-policies",
    feature = "routers",
    feature = "routes",
    feature = "security-policies",
    feature = "service-attachments",
    feature = "snapshot-settings",
    feature = "snapshots",
    feature = "ssl-certificates",
    feature = "ssl-policies",
    feature = "storage-pool-types",
    feature = "storage-pools",
    feature = "subnetworks",
    feature = "target-grpc-proxies",
    feature = "target-http-proxies",
    feature = "target-https-proxies",
    feature = "target-instances",
    feature = "target-pools",
    feature = "target-ssl-proxies",
    feature = "target-tcp-proxies",
    feature = "target-vpn-gateways",
    feature = "url-maps",
    feature = "vpn-gateways",
    feature = "vpn-tunnels",
    feature = "wire-groups",
    feature = "zone-operations",
    feature = "zone-vm-extension-policies",
    feature = "zones",
))]
const DEFAULT_HOST: &str = "https://compute.googleapis.com/";

#[cfg(any(
    feature = "accelerator-types",
    feature = "addresses",
    feature = "advice",
    feature = "autoscalers",
    feature = "backend-buckets",
    feature = "backend-services",
    feature = "cross-site-networks",
    feature = "disk-types",
    feature = "disks",
    feature = "external-vpn-gateways",
    feature = "firewall-policies",
    feature = "firewalls",
    feature = "forwarding-rules",
    feature = "future-reservations",
    feature = "global-addresses",
    feature = "global-forwarding-rules",
    feature = "global-network-endpoint-groups",
    feature = "global-operations",
    feature = "global-organization-operations",
    feature = "global-public-delegated-prefixes",
    feature = "health-checks",
    feature = "http-health-checks",
    feature = "https-health-checks",
    feature = "image-family-views",
    feature = "images",
    feature = "instance-group-manager-resize-requests",
    feature = "instance-group-managers",
    feature = "instance-groups",
    feature = "instance-settings",
    feature = "instance-templates",
    feature = "instances",
    feature = "instant-snapshot-groups",
    feature = "instant-snapshots",
    feature = "interconnect-attachment-groups",
    feature = "interconnect-attachments",
    feature = "interconnect-groups",
    feature = "interconnect-locations",
    feature = "interconnect-remote-locations",
    feature = "interconnects",
    feature = "license-codes",
    feature = "licenses",
    feature = "machine-images",
    feature = "machine-types",
    feature = "network-attachments",
    feature = "network-edge-security-services",
    feature = "network-endpoint-groups",
    feature = "network-firewall-policies",
    feature = "network-profiles",
    feature = "networks",
    feature = "node-groups",
    feature = "node-templates",
    feature = "node-types",
    feature = "organization-security-policies",
    feature = "packet-mirrorings",
    feature = "preview-features",
    feature = "projects",
    feature = "public-advertised-prefixes",
    feature = "public-delegated-prefixes",
    feature = "region-autoscalers",
    feature = "region-backend-buckets",
    feature = "region-backend-services",
    feature = "region-commitments",
    feature = "region-composite-health-checks",
    feature = "region-disk-types",
    feature = "region-disks",
    feature = "region-health-aggregation-policies",
    feature = "region-health-check-services",
    feature = "region-health-checks",
    feature = "region-health-sources",
    feature = "region-instance-group-manager-resize-requests",
    feature = "region-instance-group-managers",
    feature = "region-instance-groups",
    feature = "region-instance-templates",
    feature = "region-instances",
    feature = "region-instant-snapshot-groups",
    feature = "region-instant-snapshots",
    feature = "region-network-endpoint-groups",
    feature = "region-network-firewall-policies",
    feature = "region-notification-endpoints",
    feature = "region-operations",
    feature = "region-security-policies",
    feature = "region-snapshot-settings",
    feature = "region-snapshots",
    feature = "region-ssl-certificates",
    feature = "region-ssl-policies",
    feature = "region-target-http-proxies",
    feature = "region-target-https-proxies",
    feature = "region-target-tcp-proxies",
    feature = "region-url-maps",
    feature = "region-zones",
    feature = "regions",
    feature = "reservation-blocks",
    feature = "reservation-slots",
    feature = "reservation-sub-blocks",
    feature = "reservations",
    feature = "resource-policies",
    feature = "routers",
    feature = "routes",
    feature = "security-policies",
    feature = "service-attachments",
    feature = "snapshot-settings",
    feature = "snapshots",
    feature = "ssl-certificates",
    feature = "ssl-policies",
    feature = "storage-pool-types",
    feature = "storage-pools",
    feature = "subnetworks",
    feature = "target-grpc-proxies",
    feature = "target-http-proxies",
    feature = "target-https-proxies",
    feature = "target-instances",
    feature = "target-pools",
    feature = "target-ssl-proxies",
    feature = "target-tcp-proxies",
    feature = "target-vpn-gateways",
    feature = "url-maps",
    feature = "vpn-gateways",
    feature = "vpn-tunnels",
    feature = "wire-groups",
    feature = "zone-operations",
    feature = "zone-vm-extension-policies",
    feature = "zones",
))]
pub(crate) mod info {
    const NAME: &str = env!("CARGO_PKG_NAME");
    const VERSION: &str = env!("CARGO_PKG_VERSION");
    pub(crate) static X_GOOG_API_CLIENT_HEADER: std::sync::LazyLock<String> =
        std::sync::LazyLock::new(|| {
            let ac = gaxi::api_header::XGoogApiClient {
                name: NAME,
                version: VERSION,
                library_type: gaxi::api_header::GAPIC,
            };
            ac.rest_header_value()
        });
}

// Define some shortcuts for imported crates.
pub(crate) use google_cloud_gax::client_builder::ClientBuilder;
pub(crate) use google_cloud_gax::client_builder::Result as ClientBuilderResult;
pub(crate) use google_cloud_gax::client_builder::internal::ClientFactory;
pub(crate) use google_cloud_gax::client_builder::internal::new_builder as new_client_builder;
pub(crate) use google_cloud_gax::options::RequestOptions;
pub(crate) use google_cloud_gax::options::internal::RequestBuilder;
pub(crate) use google_cloud_gax::response::Response;

#[allow(missing_docs)]
pub mod errors;

#[allow(missing_docs)]
pub mod operation;